本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 管理 AWS IoT SiteWise 边缘目的地
<a name="destinations-manage"></a>

添加目的地后，您可以执行各种操作来管理它们，例如编辑目标配置、删除目标和管理路径过滤器。

## 编辑目的地
<a name="destinations-edit"></a>

选择表格中目的地旁边的单选按钮，然后选择 “**编辑**” 按钮来编辑目的地。

------
#### [ Console ]

**使用 AWS IoT SiteWise 控制台编辑目的地**

1. 打开 [AWS IoT SiteWise 控制台](https://console.aws.amazon.com/iotsitewise/)。

1. 在左侧导航栏中，选择 **Edge 部分的 **Edge** 网关**。

1. 选择相应的网关。

1. 在 “**目的地**” 部分，选择要编辑的目的地，然后选择 “**编辑”**。

1. 修改目的地，然后选择 “**保存**”。

------
#### [ AWS CLI ]

**要编辑目的地，请使用以下方法 AWS CLI**
+ 您可以通过修改 JSON 功能配置信息来编辑目标。

  ```
  aws iotsitewise update-gateway-capability-configuration \
  --gateway-id {{your-gateway-id}} \
  --capability-namespace "iotsitewise:publisher:3" \
  --capability-configuration '{
      "sources": [
          {
              "type": "MQTT"
          }
      ],
      "destinations": [
          {
              "id": "your-existing-destination-id",
              "type": "SITEWISE_REALTIME",
              "name": "{{your-updated-destination-name}}",
              "config": {
                  "publishingOrder": "{{TIME_ORDER}}",
                  "enableCompression": {{true}},
                  "dropPolicy": {
                      "cutoffAge": "{{10d}}",
                      "exportPolicy": {
                          "retentionPeriod": "{{10d}}",
                          "rotationPeriod": "{{6h}}",
                          "exportSizeLimitGB": {{10}}
                      }
                  },
                  "maxBatchWaitTime": "{{15s}}"
              },
              "filters": [
                  {
                    ...
                  }
              ]
          }
      ]
  }'
  ```

**注意**  
您无法更新目的地，`type`或者`capability-namespace`. 例如，您无法从某一类型切换`SITEWISE_REALTIME`到`SITEWISE_BUFFERED`。您可以为每个启用 MQTT 的网关设置一个实时目的地。

------

## 删除目的地
<a name="destinations-delete"></a>

如果您不再需要目的地，可以将其从 SiteWise Edge 网关中删除。

------
#### [ Console ]

**使用 AWS IoT SiteWise 控制台删除目的地**

1. 打开 [AWS IoT SiteWise 控制台](https://console.aws.amazon.com/iotsitewise/)。

1. 在左侧导航栏中，选择 **Edge 部分的 **Edge** 网关**。

1. 选择相应的网关。

1. 在 “**目的地**” 部分，选择要删除的目的地，然后选择 “**删除**”。出现确认屏幕。

1. 要确认您选择删除目的地，请在确认框中键入 “删除”。

------
#### [ AWS CLI ]

**要删除目的地，请使用 AWS CLI**
+ 通过指定网关 ID 并修改功能配置来删除要删除的目的地，删除网关功能配置。

  ```
  aws iotsitewise update-gateway-capability-configuration \
    --gateway-id {{your-gateway-id}} \
    --capability-namespace "iotsitewise:publisher:3" \
    --capability-configuration '{
      "sources": [
          {
              "type": "MQTT"
          }
      ],
      "destinations": []
  }'
  ```

**注意**  
destinations 数组可以为空 (`[]`)，但目标对象本身必须包含在功能配置中。

------

## 下载目标中的所有路径过滤器（控制台）
<a name="destinations-download-list"></a>

在 AWS IoT SiteWise 控制台中下载包含所有路径过滤器的 CSV 文件。您可以使用下载的路径过滤器列表在网关目标之间轻松共享路径过滤器列表。

**使用 AWS IoT SiteWise 控制台下载包含所有路径过滤器的 CSV 文件**

1. 打开 [AWS IoT SiteWise 控制台](https://console.aws.amazon.com/iotsitewise/)。

1. 在左侧导航栏中，选择 **Edge 部分的 **Edge** 网关**。

1. 选择包含您的路径过滤器的网关。

1. 选择 “**添加目的地****” 或 “编辑目的地”**。

1. 导航到**路径过滤器**部分，然后选择**下载 CSV**。

**注意**  
无论您从路径筛选器列表中选择了哪个路径筛选器，CSV 文件都包含特定目标中的所有路径筛选器。

## 编辑路径过滤器
<a name="destinations-edit-path-filter"></a>

您可以编辑单个路径过滤器，以细化目标接收的数据。

------
#### [ Console ]

使用 AWS IoT SiteWise 控制台，可以在每个相应的文本框中编辑每个单独的路径过滤器。

**使用 AWS IoT SiteWise 控制台编辑路径过滤器**

1. 打开 [AWS IoT SiteWise 控制台](https://console.aws.amazon.com/iotsitewise/)。

1. 在左侧导航栏中，选择 **Edge 部分的 **Edge** 网关**。

1. 选择包含您的路径过滤器的网关。

1. 选择相应的目的地。

1. 选择**编辑**。

1. 为包含要编辑的路径过滤器的行选择文本框。

1. 更新路径过滤器的文本，确保已编辑路径过滤器的复选框处于选中状态。

1. 选择**保存**。

------
#### [ AWS CLI ]

要使用编辑目标的路径过滤器 AWS CLI，请先检索当前配置，对其进行修改，然后使用`update-gateway-capability-configuration`命令对其进行更新。

**要编辑路径过滤器，请使用 AWS CLI**

1. 检索当前的功能配置：

   ```
   aws iotsitewise describe-gateway-capability-configuration \
     --gateway-id {{your-gateway-id}} \
     --capability-namespace "iotsitewise:publisher:3" \
     --query "capabilityConfiguration"
   ```

1. 根据需要编辑 JSON 以修改路径过滤器。

1. 使用修改后的路径过滤器更新功能配置：

   ```
   aws iotsitewise update-gateway-capability-configuration \
     --gateway-id {{your-gateway-id}} \
     --capability-namespace "iotsitewise:publisher:3" \
     --capability-configuration {{json-containing-your-updated-path-filters}}
   ```

------

## 删除路径过滤器
<a name="destinations-delete-path-filter"></a>

您可以删除目标的路径筛选器，以控制其从 MQTT 源和数据处理管道接收的数据。

------
#### [ Console ]

**使用 AWS IoT SiteWise 控制台删除路径筛选器**

1. 打开 [AWS IoT SiteWise 控制台](https://console.aws.amazon.com/iotsitewise/)。

1. 在左侧导航栏中，选择 **Edge 部分的 **Edge** 网关**。

1. 选择包含您的路径过滤器的网关。

1. 选择相应的目的地。

1. 选择**编辑**。

1. 在 **“编辑目标”** 屏幕的 “**路径过滤器**” 部分，选择一个或多个要删除的路径过滤器。

1. 选择**删除**。将显示一条删除确认消息。如果要继续删除路径过滤器，请在确认屏幕上选择 “**删除**”。

------
#### [ AWS CLI ]

**要删除目的地，请使用 AWS CLI**
+ 通过从功能配置中移除路径筛选器来删除路径过滤器。

  ```
  aws iotsitewise update-gateway-capability-configuration \
    --gateway-id {{your-gateway-id}} \
    --capability-namespace "iotsitewise:publisher:3" \
    --capability-configuration '{
      "sources": [
          {
              "type": "MQTT"
          }
      ],
      "destinations": [
          {
              "id": "your-destination-id",
              "type": "SITEWISE_REALTIME",
              "name": "your-destination-name",
              "config": {
                  ...
              },
              "filters": [
                  {
                      "type": "PATH",
                      "config": {
                          "paths": [
                              "/path1",
                              "/path2",
                              "/{{delete-a-path-to-remove-it}}"
                          ]
                      }
                  }
              ]
          }
      ]
  }
  ```

**注意**  
过滤器数组可以为空 (`[]`)，但过滤器对象本身必须包含在功能配置中。

------