

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

# 자산 모델에 인터페이스 적용
<a name="interfaces-link-asset-model"></a>

자산 모델에 인터페이스를 적용할 때 자산 모델 속성 및 계층 구조를 해당 인터페이스에 매핑합니다. 매핑되지 않은 인터페이스 속성의 경우 해당 속성이 자산 모델에 자동으로 생성됩니다. 연결 후 서비스는 인터페이스 표준을 위반하는 자산 모델의 변경을 방지합니다.

한 번에 하나의 자산 모델을 인터페이스에 추가할 수 있습니다. 그러나 여러 자산 모델을 단일 인터페이스에 연결할 수 있습니다.

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

1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동하여 탐색 창에서 **모델을** 선택합니다.

1. 인터페이스를 적용할 자산 모델을 선택합니다.

1. **자산 모델 연결** 섹션에서 **자산 모델 연결을** 선택합니다. 그러면 **인터페이스 연결** 페이지가 나타납니다.

1. **자산 모델 및 인터페이스** 섹션의 **링크할 모델 선택 드롭다운 메뉴에서 자산 모델을** 선택합니다.

1. **속성 매핑** 섹션에서 각 인터페이스 속성을 기존 자산 모델 속성에 매핑하거나 새 속성을 생성합니다. AWS IoT SiteWise 는 속성을 자산 모델 및 인터페이스의 일치하는 이름과 자동으로 연결합니다.

1. 속성 매핑을 검토하고 **인터페이스 연결을** 선택합니다.

------
#### [ AWS CLI ]

자산 모델에 인터페이스를 적용하려면 `PutAssetModelInterfaceRelationship` 작업을 사용합니다.

```
aws iotsitewise put-asset-model-interface-relationship \
  --asset-model-id "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \ 
  --interface-asset-model-id "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" \
  --property-mapping-configuration '{
    "createMissingProperty": true,
    "matchByPropertyName": true,   
    "overrides": [
      {
        "assetModelPropertyId": "a1b2c3d4-5678-90ab-cdef-44444EXAMPLE",
        "interfaceAssetModelPropertyId": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE"      
      }
    ]
  }'
```

인터페이스 관계에 대한 정보를 검색하려면 `DescribeAssetModelInterfaceRelationship` 작업을 사용합니다.

```
aws iotsitewise describe-asset-model-interface-relationship \
  --asset-model-id "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
  --interface-asset-model-id "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
```

특정 인터페이스가 적용된 모든 자산 모델을 나열하려면 `ListInterfaceRelationships` 작업을 사용합니다.

```
aws iotsitewise list-interface-relationships \
  --interface-asset-model-id "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE" \
  --max-results 10
```

인터페이스 관계를 삭제하려면 `DeleteAssetModelInterfaceRelationship` 작업을 사용합니다.

```
aws iotsitewise delete-asset-model-interface-relationship \
  --asset-model-id "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE" \
  --interface-asset-model-id "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE"
```

------