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

# 將路徑篩選條件新增至 AWS IoT SiteWise Edge 目的地
<a name="destinations-add-path-filters"></a>

將路徑篩選條件新增至目的地。路徑篩選條件使用 MQTT 主題語法，其中 `#` 是符合任意數量關卡的萬用字元，而 `+`是符合單一關卡的萬用字元。您可以將多個目的地新增至閘道，每個目的地都有自己的一組路徑篩選條件訂閱您的設備遙測。

Siemens Industrial Edge 閘道使用字首來實現相容性。如需詳細資訊，請參閱[路徑篩選條件的字首](sitewise-edge-on-siemens.md#siemens-path-filters)。

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

**新增路徑篩選條件**

1. 開啟 [AWS IoT SiteWise 主控台](https://console.aws.amazon.com/iotsitewise/)。

1. 在導覽窗格中，選擇 **Edge 閘道**。

1. 選取您要新增路徑篩選條件的閘道。

1. 在**新增目的地**下的**路徑篩選條件**區段中，選擇**新增路徑篩選條件**。

1. 輸入您希望此目的地訂閱的路徑篩選條件。您可以使用萬用字元 (`#` 和 `+`) 來訂閱多個路徑。

1. 選擇**新增路徑篩選條件**，將路徑篩選條件新增至清單。

1. 視需要重複步驟來新增其他路徑篩選條件。

1. 新增所有必要的路徑篩選條件後，請選擇**建立**。

------
#### [ AWS CLI for self-hosted gateways ]

**Example ：路徑篩選條件組態**  

```
{
  "destinations": [
    {
      ...
    }
  ],
  "filters": [
    {
      "type": "PATH",
      "config": {
        "paths": [
          "home/+/sensor1/temperature",
          "home/livingroom/sensor1/temperature",
          "home/livingroom/sensor1/temperature",
          "building/#"
        ]
      }
    }
  ]
}
```

------
#### [ AWS CLI for 西門子 IEgateways ]

**Example ：路徑篩選條件的字首組態**  
使用每個路徑篩選條件的資料 (`ie/d`) 和中繼資料 (`ie/m`) 字首來擷取所有資料。  

```
{
  "destinations": [
    {
      ...
    }
  ],
  "filters": [
    {
      "type": "PATH",
      "config": {
        "paths": [
          "ie/d/home/+/sensor12/temperature",
          "ie/m/home/livingroom/sensor12/temperature",
          "ie/d/home/livingroom/sensor13/temperature2",
          "ie/m/home/livingroom/sensor13/temperature2",
          "ie/d/building/#",
          "ie/m/building/#"
        ]
      }
    }
  ]
}
```

------

**注意**  
透過下載路徑篩選條件清單，在目的地之間複製路徑篩選條件。如需詳細資訊，請參閱[下載目的地中的所有路徑篩選條件 （主控台）](destinations-manage.md#destinations-download-list)。

## 大量上傳路徑篩選條件
<a name="destinations-path-filters-upload-file"></a>

若要大量上傳路徑篩選條件，請使用 CSV 或文字檔案。當您上傳檔案時， AWS IoT SiteWise 會自動移除確切的重複項目。例如， `windfarm/site1/`和 `windfarm/site1/`是完全重複的 AWS IoT SiteWise ，因為字串完全相同。不會移除部分重複項目，並產生額外費用。例如， `windfarm/#`和 `windfarm/site1` 是重疊的主題，因為 `windfarm/site1` 已包含 `windfarm/#`。

**注意**  
避免重複，以避免產生額外費用。上傳的檔案必須是 .csv 或 .txt 格式。它不能包含任何標頭，且應該由單一資料欄組成。在 欄中，列出您的路徑篩選條件，每個篩選條件位於單獨的一行。檔案中不應包含任何其他資訊。

**檔案上傳需求**

這些是額外的路徑篩選條件需求。
+ 您可以上傳一個 .csv 或 .txt 檔案。不支援其他檔案格式。
+ CSV (.csv) 檔案不能有標頭，並且應該只包含一個資料欄。
+ 您可以在每行上有一個路徑篩選條件。
+ 上傳的檔案不能為空白。
+ 使用 `#` 做為萬用字元時，必須是主題篩選條件中的最後一個字元。例如 `topic/#`，或做為特殊定主題層級的獨立字元。但請注意，`#` 也可做為主題層級名稱內的一般字元，例如 `factory/machine#1/topic`。如需詳細資訊，請參閱 [路徑篩選條件名稱中的特殊字元](gw-destinations.md#path-filters-special-characters)
  + 您也可以使用 `+` 字元。例如，使用 `factory/+/temp`取得工廠的所有溫度，而非`factory/machine3/temp`個別的 `factory/machine2/temp`和 。