기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 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. 탐색 창에서 **엣지 게이트웨이**를 선택합니다.

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 형식이어야 합니다. 헤더는 포함할 수 없으며 단일 열로 구성되어야 합니다. 열에 경로 필터를 나열하고 각 필터를 별도의 줄에 표시합니다. 파일에 다른 정보를 포함해서는 안 됩니다.

**파일 업로드 요구 사항**

추가 경로 필터 요구 사항입니다.
+ .csv 또는 .txt 파일 하나를 업로드할 수 있습니다. 다른 파일 형식은 지원되지 않습니다.
+ CSV(.csv) 파일은 헤더를 가질 수 없으며 하나의 열만 포함해야 합니다.
+ 각 줄에 하나의 경로 필터를 사용할 수 있습니다.
+ 업로드된 파일은 비워둘 수 없습니다.
+ 와일드카드로 `#`을 사용하는 경우 이것이 주제 필터의 마지막 문자여야 합니다. 예를 들어 `topic/#` 또는 특정 주제 수준의 독립형 문자로 사용할 수 있습니다. 하지만 `#`은 주제 수준 이름 내에서 일반 문자로도 사용될 수 있다는 점(예: `factory/machine#1/topic`)에 유의하세요. 자세한 내용은 [경로 필터 이름의 특수 문자](gw-destinations.md#path-filters-special-characters) 섹션을 참조하세요.
  + `+` 캐릭터를 사용할 수도 있습니다. 예를 들어 `factory/+/temp`를 사용하여 공장의 모든 온도를 `factory/machine2/temp` 및 `factory/machine3/temp` 개별적으로 가져옵니다.