

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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 Siemens 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 形式である必要があります。ヘッダーを含めることはできません。1 つの列で構成する必要があります。列で、パスフィルターをリストし、各フィルターを別々の行に表示します。ファイルには他の情報を含めないでください。

**ファイルのアップロード要件**

これらは追加のパスフィルター要件です。
+ 1 つの .csv ファイルまたは .txt ファイルをアップロードできます。その他のフェイル形式はサポートされていません。
+ CSV (.csv) ファイルにはヘッダーを含めることはできません。また、1 つの列のみを含める必要があります。
+ 各行に 1 つのパスフィルターを設定できます。
+ アップロードしたファイルは空にできません。
+ `#` をワイルドカードとして使用する場合、トピックフィルターの最後の文字にする必要があります。例えば、`topic/#` または特定のトピックレベルの独立した文字として使用します。ただし、`#` は `factory/machine#1/topic` などのトピックレベル名の通常の文字としても使用できます。詳細については「[パスフィルター名の特殊文字](gw-destinations.md#path-filters-special-characters)」を参照してください。
  + `+` 文字を使用することもできます。たとえば、 `factory/+/temp`を使用して、 `factory/machine2/temp` および を`factory/machine3/temp`個別に取得するのではなく、工場のすべての温度を取得します。