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

# 向 Amazon IoT SiteWise Edge 目标添加路径过滤器
<a name="destinations-add-path-filters"></a>

向目标添加路径过滤器。路径过滤器使用 MQTT 主题语法，其中`#`是匹配任意数量级别的通配符，`+`是匹配单个级别的通配符。您可以向网关添加多个目的地，每个目的地都有自己的一组路径过滤器，这些过滤器已订阅到您的设备遥测中。

Siemens Industrial Edge网关使用前缀来实现兼容性。有关更多信息，请参阅 [路径过滤器的前缀](sitewise-edge-on-siemens.md#siemens-path-filters)。

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

**添加路径过滤器**

1. 打开 [Amazon IoT SiteWise 控制台](https://console.amazonaws.cn/iotsitewise/)。

1. 在导航窗格中，选择 **Edge 网关**。

1. 选择要向其添加路径过滤器的网关。

1. 在 “**添加目标**” 下的 “**路径过滤器**” 部分中，选择 “**添加路径过滤器**”。

1. 输入您希望此目的地订阅的路径过滤器。您可以使用通配符（`#`和`+`）来订阅多个路径。

1. 选择 “**添加路径过滤器**”，将路径过滤器添加到列表中。

1. 如果需要，重复步骤以添加其他路径过滤器。

1. 添加完所有必需的路径过滤器后，选择 “**创建**”。

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

**Example : 路径过滤器配置**  

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

------
#### [ Amazon CLI for 西门子 IEgateways ]

**Example : 路径过滤器的前缀配置**  
使用每个路径筛选器的 data (`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 或文本文件。 Amazon IoT SiteWise 上传文件时会自动删除完全重复的内容。例如，`windfarm/site1/`和`windfarm/site1/`是精确的重复项 Amazon 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`