本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 管理 AWS IoT SiteWise Edge 目的地
<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": []
  }'
  ```

**注意**  
目的地陣列可以是空的 (`[]`)，但目的地物件本身必須包含在功能組態中。

------

## 下載目的地中的所有路徑篩選條件 （主控台）
<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"
                          ]
                      }
                  }
              ]
          }
      ]
  }
  ```

**注意**  
篩選條件陣列可以是空的 (`[]`)，但篩選條件物件本身必須包含在功能組態中。

------