기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AWS IoT SiteWise 엣지 대상 관리
대상을 추가한 후 대상 구성 편집, 대상 삭제, 경로 필터 관리 등 다양한 작업을 수행하여 대상을 관리할 수 있습니다.
## 대상 편집
테이블의 대상 옆에 있는 라디오 버튼을 선택하고 **편집** 버튼을 선택하여 대상을 편집합니다.
------
#### [ Console ]
**AWS IoT SiteWise 콘솔을 사용하여 대상을 편집하려면**
1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)을 엽니다.
1. 왼쪽 탐색의 엣지 **섹션에서 엣지 게이트웨이**를 선택합니다. ****
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 지원 게이트웨이에 대해 하나의 실시간 대상을 가질 수 있습니다.
------
## 대상 삭제
대상이 더 이상 필요하지 않은 경우 SiteWise Edge 게이트웨이에서 삭제할 수 있습니다.
------
#### [ Console ]
**AWS IoT SiteWise 콘솔을 사용하여 대상을 삭제하려면**
1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)을 엽니다.
1. 왼쪽 탐색의 엣지 **섹션에서 엣지 게이트웨이**를 선택합니다. ****
1. 적절한 게이트웨이를 선택합니다.
1. **대상** 섹션에서 삭제할 대상을 선택한 다음 **삭제**를 선택합니다. 확인 화면이 나타납니다.
1. 대상 삭제 선택을 확인하려면 확인 상자에 "delete"을 입력합니다.
------
#### [ 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": []
}'
```
**참고**
대상 배열은 비어 있을 수 있지만(`[]`) 대상 객체 자체가 기능 구성에 포함되어야 합니다.
------
## 대상의 모든 경로 필터 다운로드(콘솔)
AWS IoT SiteWise 콘솔에서 모든 경로 필터가 포함된 CSV 파일을 다운로드합니다. 다운로드한 경로 필터 목록을 사용하여 게이트웨이 대상 간에 경로 필터 목록을 쉽게 공유할 수 있습니다.
**AWS IoT SiteWise 콘솔을 사용하여 모든 경로 필터의 CSV 파일을 다운로드하려면**
1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)을 엽니다.
1. 왼쪽 탐색의 엣지 **섹션에서 엣지 게이트웨이**를 선택합니다. ****
1. 경로 필터가 포함된 게이트웨이를 선택합니다.
1. **대상 추가** 또는 **대상 편집**을 선택합니다.
1. **경로 필터** 섹션으로 이동하여 **CSV 다운로드**를 선택합니다.
**참고**
CSV 파일에는 경로 필터 목록에서 선택한 경로 필터와 관계없이 특정 대상의 모든 경로 필터가 포함됩니다.
## 경로 필터 편집
개별 경로 필터를 편집하여 대상이 수신하는 데이터를 세분화할 수 있습니다.
------
#### [ Console ]
AWS IoT SiteWise 콘솔을 사용하여 각 텍스트 상자 내에서 각 개별 경로 필터를 편집할 수 있습니다.
**AWS IoT SiteWise 콘솔을 사용하여 경로 필터를 편집하려면**
1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)을 엽니다.
1. 왼쪽 탐색의 엣지 **섹션에서 엣지 게이트웨이**를 선택합니다. ****
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}}
```
------
## 경로 필터 삭제
대상의 경로 필터를 삭제하여 MQTT 소스 및 데이터 처리 파이프라인에서 수신하는 데이터를 제어할 수 있습니다.
------
#### [ Console ]
**AWS IoT SiteWise 콘솔을 사용하여 경로 필터를 삭제하려면**
1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)을 엽니다.
1. 왼쪽 탐색의 엣지 **섹션에서 엣지 게이트웨이**를 선택합니다. ****
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}}"
]
}
}
]
}
]
}
```
**참고**
필터 배열은 비어 있을 수 있지만(`[]`) 필터 객체 자체가 기능 구성에 포함되어야 합니다.
------