기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # 자산 모델 인터페이스 AWS IoT SiteWise 인터페이스는 다양한 자산 모델에서 표준을 설정합니다. 이들은 구현의 변형을 허용하면서 일관성을 보장하는 공통 구조를 정의합니다. 인터페이스는 자산 모델(속성, 복합 모델 및 계층 구조)과 동일한 구조를 공유하지만 직접 자산을 생성할 수는 없습니다. 대신 인터페이스가 기존 자산 모델에 적용되어 표준화를 보장합니다. 인터페이스에는 구성 요소 모델이 지원되지 않습니다. 인터페이스를 사용하면 다음과 같은 몇 가지 이점이 있습니다. + 다양한 자산 모델 변형에 대한 표준화된 속성 및 지표 + 인터페이스 수준에서 간소화된 지표 정의 + 복잡한 자산 계층 구조의 보다 효율적인 관리 + 각 자산 모델 변형에 대한 독립적인 속성 수명 주기 관리 + 운영 팀이 물리적 자산 표현에 초점을 맞추고 데이터 팀이 장비 전반에 표준을 설정하는 팀 간 협업 개선 실제 산업 장비를 모델링하려면 먼저 자산 모델을 생성하는 것이 좋습니다. 자체 속성 집합이 있는 모든 장비 유형은 자체 자산 모델로 표현할 수 있습니다. ## 자산 모델 표준화 사용 사례 인터페이스는 고유한 특성을 유지하면서 다양한 자산 모델의 속성을 표준화하는 데 도움이 됩니다. 예를 들어 파워트레인 숍에는 엔진, 트랜스미션, 차등, 어셈블리 등 네 개의 스테이션이 있습니다. 각 스테이션에는 다양한 장비 유형이 포함되어 있습니다. 예를 들어 엔진 스테이션에는 CNC 기계가 포함되지만 사양이 다릅니다. 일부는 3축이고 다른 하나는 5축입니다. ![\[자산 모델 및 자산만 사용하는 파워트레인 숍 장비의 계층 구조를 보여주는 다이어그램입니다. 파워트레인 숍은 맨 위에 있으며, 두 번째 수준에서 엔진, 전송, 차등 및 어셈블 스테이션의 각 자산 모델이 맨 위에 있습니다. 세 번째 레벨에는 엔진 스테이션 자산 모델에서 가져온 축으로 구분된 개별 CNC 기계가 있습니다. 반대로 어셈블 스테이션 모델에서 비롯된 자산 모델도 있습니다. 네 번째 수준에서는 각각 개별 CNC 기계 또는 로봇 팔을 이름으로 나타내는 자산입니다.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/models-interface-hierarchy.png) 그러나 인터페이스를 사용하면 CNC 기계에서 볼 수 있는 공통성에 대한 표준을 생성할 수 있습니다. 각 속성에 대한 자산 모델을 생성하는 대신 인터페이스에서 반복 가능한 속성을 사용할 수 있습니다. 예를 들어, 다음을 수행할 수 있습니다. 1. 시스템 유형의 각 범주에 대해 별도의 자산 모델을 생성합니다. 이 예제에서는 "CNC 3축 머신"과 "CNC 5축 머신"입니다. 1. 공통 속성 및 지표를 사용하여 표준 인터페이스를 정의합니다. 이 예제에서 , `Down-time`및 `Temperature-in-C``Running-time`는 모두 두 CNC 기계에 모두 적용되는 공통 속성입니다. 1. 이 인터페이스를 모든 CNC 기계 자산 모델에 적용하면 개별 자산 모델에서 디바이스별 속성을 계속 사용할 수 있습니다. ![\[인터페이스가 이전 다이어그램의 자산 모델 구성을 간소화하는 방법을 보여주는 다이어그램입니다. 엔진 스테이션 CNC 기계에 대한 몇 가지 반복 가능한 파라미터를 이제 3축 및 5축 CNC 기계 자산 모델에 대한 다양한 속성으로 전달되는 인터페이스에 의해 관리되는 동시에 각각에 대한 디바이스별 속성도 허용합니다.\]](http://docs.aws.amazon.com/ko_kr/iot-sitewise/latest/userguide/images/models-interface-to-asset-models.png) 인터페이스 수준에서 가용성 지표를 정의할 수도 있습니다. 예를 들어는 가동 중지 시간과 실행 시간 값을 기준으로 가용성을 `Avail = avg(Down-time, Running-time)` 계산합니다. 인터페이스를 사용하면 각 시스템 유형의 고유한 특성을 유지하면서 해당 장비 전반에서 일관된 속성 정의 및 지표를 보장하여 자산 모델 관리를 간소화할 수 있습니다. ## 구조 및 구성 요소 인터페이스에는 속성, 측정, 변환 및 지표와 같은 자산 모델과 동일한 속성 유형이 포함됩니다. 자산 모델에 오버레이되면 기존 속성을 해당 인터페이스에 매핑합니다. 매핑되지 않은 인터페이스 속성은 자산 모델에서 자동으로 생성됩니다. 인터페이스 계층 구조는 롤업 지표를 정의하는 반면, 자산 모델 계층 구조는 자산 연결을 활성화합니다. 인터페이스를 사용하면 서비스가 롤업 지표를 계산할 때 자산 모델 계층 구조를 인터페이스 계층 구조에 자동으로 매핑합니다. 인터페이스를 적용한 후 롤업 지표는 자산 모델의 자체 계층 구조가 아닌 인터페이스 계층 구조를 통해 정의됩니다. ## 고려 사항 인터페이스로 작업할 때는 다음 사항을 고려해야 합니다. + 자산 모델 및 인터페이스 속성은 이름으로 자동 매핑하거나 수동으로 매핑할 수 있습니다. 계층 구조는 롤업 지표를 계산할 때 서비스에 의해 자동으로 매핑됩니다. + 연결된 자산 모델에서 인터페이스 지표를 입력으로 사용하는 추가 지표를 정의할 수 없습니다. + 자산 모델은 하나의 인터페이스에만 연결할 수 있습니다. 그러나 동일한 인터페이스에 여러 자산 모델을 적용할 수 있습니다. + 경보는 인터페이스에서 지원되지 않습니다. + 인터페이스에는 구성 요소 모델이 지원되지 않습니다. **Topics** + [자산 모델 표준화 사용 사례](#interface-powertrain-shop-example) + [구조 및 구성 요소](#interface-structure) + [고려 사항](#interface-considerations) + [인터페이스 자산 모델 관계 이해](interface-asset-model-relationship.md) + [인터페이스 생성](interface-create.md) + [자산 모델에 인터페이스 적용](interfaces-link-asset-model.md) + [인터페이스, 연결된 자산 모델 및 속성 관리](interfaces-manage.md) + [추가 인터페이스 예제](interface-additional-examples.md) # 인터페이스 자산 모델 관계 이해 인터페이스와 자산 모델은 상호 보완적인 관계로 함께 작동합니다. **인터페이스와 자산 모델 비교** | 속성 | 인터페이스 | 자산 모델 | | --- | --- | --- | | 용도 | 표준 정의 및 일관성 적용 | 물리적 또는 논리적 자산 표현 | | 자산 생성 | 자산을 직접 생성할 수 없음 | 자산을 생성하는 데 사용됩니다. | | 속성 | 모델에서 구현해야 하는 표준 속성 정의 | 인터페이스가 적용되고 고유한 속성을 가질 수 있습니다. | | Metrics | 표준 계산 정의 | 인터페이스 지표를 구현하고 추가 지표를 가질 수 있음 | | 계층 구조 | 롤업 지표에 대한 데이터 계산 계층적 관계 정의 | 자산 연결을 위한 물리적 계층적 관계 정의 | 자산 모델에 인터페이스를 적용하는 경우: + 자산 모델은 인터페이스에 정의된 모든 속성을 매핑해야 합니다. + 속성 매핑은 인터페이스 속성이 자산 모델 속성에 대응하는 방식을 정의합니다. + 매핑된 자산 모델 속성은 해당 인터페이스 속성과 동기화된 상태로 유지되어야 하며 둘 간에 불일치를 일으키는 방식으로 수정할 수 없습니다. + 매핑되지 않은 인터페이스 속성은 자산 모델에서 자동으로 생성됩니다. + 자산 모델은 인터페이스에 정의된 속성 이외의 추가 속성을 가질 수 있습니다. + 자산 모델은 인터페이스 지표를 구현합니다. 인터페이스 지표에 대한 변경 사항은 인터페이스를 사용하여 모든 자산 모델로 전파됩니다. + 인터페이스 계층 구조는 롤업 지표를 계산하는 데 사용됩니다. 자산 모델 계층 구조는 독립적으로 정의할 수 있으며 서비스는 롤업 지표를 계산할 때 자동으로 매핑합니다. 이 관계는 표준화를 보장하는 동시에 다양한 장비 유형을 나타내는 데 필요한 유연성을 제공합니다. ## 기존 자산 모델 표준화 인터페이스는 새로운 자산 모델을 처음부터 설계할 때 유용하지만 시간이 지남에 따라 독립적으로 발전했을 수 있는 기존 자산 모델을 표준화하는 데도 마찬가지로 강력합니다. 기존 자산 모델로 작업할 때 인터페이스를 적용하여 지표와 속성을 표준화할 수 있습니다. 1. 기존 자산 모델에서 공통 지표 및 속성 식별 1. 이러한 표준 속성 및 지표를 정의하는 인터페이스 생성 1. 속성 매핑을 사용하여 기존 자산 모델에 인터페이스 적용 1. 롤업 지표를 사용하여 자산 계층 구조 전반의 데이터 집계 예를 들어 속성 이름은 다르지만 , `temp_celsius`,와 같은 유사한 데이터를 가진 기존 CNC 기계 자산 모델이 있는 경우 다음을 수행할 수 있습니다`temperature_c``machine_temp`. 1. 표준화된 `Temperature-in-C` 속성을 `CNC-INTERFACE` 사용하여 생성 1. 이 인터페이스를 각 CNC 자산 모델에 적용하여 기존 온도 속성을 인터페이스의 `Temperature-in-C` 속성에 매핑합니다. 1. 인터페이스에서 모든 시스템의 통계를 계산하는 롤업 지표 정의(예: 평균 온도) 이 접근 방식을 사용하면 기존 자산 모델을 유지하면서 표준화 및 간소화된 지표 계산의 이점을 얻을 수 있습니다. ## 계층 관계 인터페이스 계층 구조 다양한 인터페이스에서 데이터를 계산하고 집계하기 위한 관계를 정의합니다. 예를 들어, 초기 설정에서 인터페이스 계층 구조는 다양한 수준의 온도 모니터링 인터페이스를 연결하여 평균 온도를 계산할 수 있습니다. 예: 기계, 생산 라인 및 시설. 와 같은 롤업 지표를 정의하면 인터페이스 계층 `AverageTemperature`구조에 따라 해당 지표가 하위 수준에서 상위 수준으로 데이터를 집계하는 방법이 결정됩니다. 자산 모델 계층 구조 자산의 실제 물리적 또는 논리적 구조를 나타냅니다. 예를 들어 CNC 기계 자산 모델은 생산 라인 자산 모델의 일부일 수 있으며, 이는 다시 공장 자산 모델에 속합니다. 이 계층 구조는 실제 관계를 반영하며 물리적 배열 또는 비즈니스 구조와 일치하는 방식으로 자산을 구성하는 데 도움이 됩니다. 인터페이스 계층 구조와 결합하면 자산 모델 계층 구조는 시스템이 롤업 계산에 포함되어야 하는 자산을 이해하는 데 도움이 됩니다. 이러한 두 계층 구조 유형이 함께 작동합니다. 인터페이스 계층 구조는 집계된 지표를 계산하는 방법을 정의하는 반면, 자산 모델 계층 구조는 이러한 계산에 포함되어야 하는 특정 자산을 정의합니다. ## 인터페이스 지표 및 롤업 계산 인터페이스는 다양한 자산 모델에 적용할 수 있는 표준화된 지표를 정의하는 데 뛰어납니다. 이는 여러 자산의 데이터를 집계하는 롤업 지표에 특히 유용합니다. 인터페이스에서 지표를 정의하면 인터페이스를 구현하는 모든 자산 모델에 지표가 자동으로 적용됩니다. 지표는 인터페이스에 정의된 속성을 참조하고, 집계 함수를 사용하여 자산 전반의 통계를 계산하고, 모든 구현 자산 모델에서 일관된 계산을 보장할 수 있습니다. 예를 들어, 실행 시간과 총 시간의 비율을 계산하는 인터페이스에서 가용성 지표를 정의할 수 있습니다. ``` { "name": "Availability", "dataType": "DOUBLE", "type": { "metric": { "expression": "Running-time / (Running-time + Down-time) * 100", "variables": [ { "name": "Running-time", "value": { "propertyId": "${Running-time}" } }, { "name": "Down-time", "value": { "propertyId": "${Down-time}" } } ], "window": { "tumbling": { "interval": "1h" } } } }, "unit": "Percent" } ``` 이 인터페이스를 여러 자산 모델에 적용하면 기본 속성 이름이 다르더라도(속성 매핑 덕분에) 모든 자산 모델에 대해 가용성 지표가 일관되게 계산됩니다. 지표 정의 및 집계 함수 사용에 대한 자세한 내용은 섹션을 참조하세요[속성과 기타 자산에서 데이터 집계(지표)](metrics.md). ### 인터페이스를 사용한 롤업 지표 인터페이스는 계층 구조의 자산 간에 데이터를 집계하는 롤업 지표를 정의할 수도 있습니다. 인터페이스에서 계층 구조를 정의하고 자산 모델에 적용할 때 하위 자산의 데이터를 집계하는 지표를 생성할 수 있습니다. 예를 들어 공장의 모든 CNC 기계에서 평균 온도를 계산하는 지표를 정의할 수 있습니다. ``` { "name": "AverageTemperature", "dataType": "DOUBLE", "type": { "metric": { "expression": "avg(Temperature-in-C)", "variables": [ { "name": "Temperature-in-C", "value": { "propertyId": "${Temperature-in-C}", "hierarchyId": "${CNC-machines}" } } ], "window": { "tumbling": { "interval": "1h" } } } }, "unit": "Celsius" } ``` 이 지표는 `avg()` 집계 함수를 사용하여 계층 구조의 모든 CNC 기계에서 평균 온도를 계산합니다. `hierarchyId` 파라미터는 집계에 사용할 계층을 지정합니다. 이 인터페이스가 자산 모델에 적용되면 롤업 지표는 계층 매핑과 일치하는 모든 하위 자산의 데이터를 자동으로 집계합니다. # 인터페이스 생성 AWS IoT SiteWise 콘솔 또는를 사용하여 인터페이스를 생성할 수 있습니다 AWS CLI. ------ #### [ Console ] 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동하여 탐색 창에서 **모델을** 선택합니다. 1. **인터페이스 생성을** 선택합니다. 1. 인터페이스의 고유한 **이름과** 선택적 **설명을** 입력합니다. 선택한 **외부 ID**를 선택적으로 추가할 수도 있습니다. 1. 인터페이스에 속성을 추가합니다. 자산 모델과 마찬가지로 속성, 측정, 변환 및 지표를 추가할 수 있습니다. 자세한 내용은 [자산 모델 생성(콘솔)](create-asset-models.md#create-asset-model-console) 단원을 참조하십시오. 1. **인터페이스 생성을** 선택하여 인터페이스를 생성합니다. 1. 인터페이스 간에 상위-하위 관계를 정의하는 계층 구조가 있는 경우 **계층 구조 추가**를 선택하고 관련 세부 정보를 입력합니다. ------ #### [ AWS CLI ] 인터페이스를 생성하려면 `assetModelType` 파라미터를 로 설정한 상태에서 `CreateAssetModel` 작업을 사용합니다`INTERFACE`. ``` aws iotsitewise create-asset-model \ --asset-model-name "CNC-INTERFACE" \ --asset-model-description "Standard interface for CNC machines" \ --asset-model-type "INTERFACE" \ --asset-model-properties '[ { "name": "Temperature-in-C", "dataType": "DOUBLE", "type": { "measurement": {} }, "unit": "Celsius" }, { "name": "Down-time", "dataType": "DOUBLE", "type": { "measurement": {} }, "unit": "Minutes" }, { "name": "Running-time", "dataType": "DOUBLE", "type": { "measurement": {} }, "unit": "Minutes" }, { "name": "Availability", "dataType": "DOUBLE", "type": { "metric": { "expression": "Running-time / (Running-time + Down-time) * 100", "variables": [ { "name": "Running-time", "value": { "propertyId": "${Running-time}" } }, { "name": "Down-time", "value": { "propertyId": "${Down-time}" } } ], "window": { "tumbling": { "interval": "1h" } } } }, "unit": "Percent" } ]' ``` ------ # 자산 모델에 인터페이스 적용 자산 모델에 인터페이스를 적용할 때 자산 모델 속성 및 계층 구조를 해당 인터페이스에 매핑합니다. 매핑되지 않은 인터페이스 속성의 경우 해당 속성이 자산 모델에 자동으로 생성됩니다. 연결 후 서비스는 인터페이스 표준을 위반하는 자산 모델의 변경을 방지합니다. 한 번에 하나의 자산 모델을 인터페이스에 추가할 수 있습니다. 그러나 여러 자산 모델을 단일 인터페이스에 연결할 수 있습니다. ------ #### [ 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" ``` ------ # 인터페이스, 연결된 자산 모델 및 속성 관리 인터페이스를 생성하고 자산 모델에 연결한 후 콘솔 또는를 통해 관계를 관리, 편집 및 삭제할 수 있습니다 AWS CLI. ## 인터페이스 및 자산 모델 관계 수정 인터페이스와 자산 모델의 관계를 변경하려면 AWS IoT SiteWise 콘솔에서 또는를 통해 AWS CLI다음을 수행합니다. ------ #### [ Console ] 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동하여 탐색 창에서 **모델을** 선택합니다. 1. 수정할 인터페이스를 선택합니다. 1. 수정할 자산 모델을 선택하고 편집합니다. [자산 모델에 인터페이스 적용](interfaces-link-asset-model.md) 지침에 따라 다른 자산 모델을 연결할 수 있습니다. 1. **인터페이스 적용을** 선택하여 변경 사항을 저장합니다. ------ #### [ AWS CLI ] 인터페이스 및 자산 모델 관계를 편집하려면 `PutAssetModelInterfaceRelationship` 작업을 사용합니다. *your-asset-model-id* 및 *your-interface-asset-model-id*를 자체 값으로 바꿉니다. 자세한 내용은 API 참조의 [PutAssetModelInterfaceRelationship](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetModelInterfaceRelationship.html)을 참조하세요. *AWS IoT SiteWise * ``` aws iotsitewise put-asset-model-interface-relationship \ --asset-model-id your-asset-model-id \ --interface-asset-model-id your-interface-asset-model-id ``` ------ ## 인터페이스 속성 매핑 수정 인터페이스의 속성을 변경하려면 AWS IoT SiteWise 콘솔에서 또는를 통해 AWS CLI다음을 수행합니다. ------ #### [ Console ] 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동하여 탐색 창에서 **모델을** 선택합니다. 1. 속성 매핑을 수정할 인터페이스를 선택합니다. **속성 매핑 편집 페이지가** 나타납니다. 1. **속성 매핑** 섹션에서 목록을 필터링하여 적절한 속성 매핑을 찾습니다. 1. **모델 속성 열을 사용하여 속성을** 변경합니다. ------ #### [ AWS CLI ] 인터페이스 및 자산 모델 관계를 편집하려면 `PutAssetModelInterfaceRelationship` 작업을 사용합니다. *your-asset-model-id* 및 *your-interface-asset-model-id*를 자체 값으로 바꿉니다. 자세한 내용은 API 참조의 [PutAssetModelInterfaceRelationship](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_PutAssetModelInterfaceRelationship.html)을 참조하세요. *AWS IoT SiteWise * ``` aws iotsitewise put-asset-model-interface-relationship \ --asset-model-id your-asset-model-id \ --interface-asset-model-id your-interface-asset-model-id \ ``` ------ ## 자산 모델에 연결된 인터페이스 나열 자산 모델에 적용된 인터페이스 목록을 가져오려면 AWS IoT SiteWise 콘솔에서 또는를 통해 AWS CLI다음을 수행합니다. ------ #### [ Console ] 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동하여 탐색 창에서 **모델을** 선택합니다. 1. **모델** 섹션에서 적절한 자산 모델 또는 인터페이스를 선택합니다. 모델의 해당 세부 정보 페이지에서 적용된 인터페이스 또는 연결된 자산 모델의 목록을 볼 수 있습니다. + 특정 인터페이스를 볼 때는 **연결된 자산 모델** 섹션을 참조하세요. + 특정 자산 모델을 볼 때는 **적용된 인터페이스** 섹션을 참조하세요. ------ #### [ AWS CLI ] 인터페이스를 나열하려면 `ListInterfaceRelationships` 작업을 사용할 수 있습니다. *your-interface-asset-model-id*를 자체 값으로 바꿉니다. 자세한 내용은 API 참조의 [ListInterfaceRelationships](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_ListInterfaceRelationships.html)를 참조하세요. *AWS IoT SiteWise * ``` aws iotsitewise list-interface-relationships \ --interface-asset-model-id your-interface-asset-model-id \ [--next-token your-next-token] \ [--max-results 20] ``` ------ ## 인터페이스 및 자산 모델 관계의 세부 정보 보기 자산 모델에 적용된 인터페이스의 세부 정보를 보려면 AWS IoT SiteWise 콘솔에서 또는를 통해 AWS CLI다음을 수행합니다. ------ #### [ Console ] 적용된 인터페이스 및 연결된 자산 모델의 세부 정보를 봅니다. 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동하여 탐색 창에서 **모델을** 선택합니다. 1. **모델** 섹션에서 적절한 자산 모델 또는 인터페이스를 검색합니다. 모델 또는 인터페이스의 **이름을** 선택하여 자세한 정보가 포함된 페이지를 엽니다. ------ #### [ AWS CLI ] 인터페이스 및 자산 모델 관계에 대한 인터페이스 세부 정보를 보려면 `DescribeAssetModelInterfaceRelationship` 작업을 사용합니다. *your-asset-model-id* 및 *your-interface-asset-model-id*를 자체 값으로 바꿉니다. 자세한 내용은 API 참조의 [DescribeAssetModelInterfaceRelationship](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModelInterfaceRelationship.html)을 참조하세요. *AWS IoT SiteWise * ``` aws iotsitewise describe-asset-model-interface-relationship \ --asset-model-id your-asset-model-id \ --interface-asset-model-id your-interface-asset-model-id ``` ------ ## 자산 모델에 적용된 인터페이스 제거 자산 모델에 적용된 인터페이스를 제거하려면 AWS IoT SiteWise 콘솔에서 또는를 통해 AWS CLI다음을 수행합니다. ------ #### [ Console ] 자산 모델을 통해 인터페이스를 제거하는 것이 좋습니다. 인터페이스를 삭제하거나 특정 인터페이스의 페이지를 통해 인터페이스의 연결을 해제할 수도 있습니다. 1. [AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동하여 탐색 창에서 **모델을** 선택합니다. 1. 인터페이스 관계를 제거할 적절한 자산 모델을 선택합니다. 1. **자산 모델 연결 해제**를 선택합니다. ------ #### [ AWS CLI ] 자산 모델에서 인터페이스 관계를 제거하려면 `DeleteAssetModelInterfaceRelationship` 작업을 사용할 수 있습니다. *your-interface-asset-model-id*를 자체 값으로 바꿉니다. 자세한 내용은 API 참조의 [DeleteAssetModelInterfaceRelationship](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteAssetModelInterfaceRelationship.html)을 참조하세요. *AWS IoT SiteWise * ``` aws iotsitewise delete-asset-model-interface-relationship \ --asset-model-id your-asset-model-id \ --interface-asset-model-id your-interface-asset-model-id ``` ------ # 추가 인터페이스 예제 다음은 다양한 산업 시나리오에서 인터페이스를 사용하는 방법에 대한 추가 예제입니다. ## 에너지 생성 장비 발전 회사는 인터페이스를 사용하여 다양한 유형의 발전 장비에서 지표를 표준화할 수 있습니다. ``` { "assetModelName": "GENERATOR-INTERFACE", "assetModelDescription": "Standard interface for power generators", "assetModelType": "INTERFACE", "assetModelProperties": [ { "name": "ActivePower", "dataType": "DOUBLE", "type": { "measurement": {} }, "unit": "MW" }, { "name": "ReactivePower", "dataType": "DOUBLE", "type": { "measurement": {} }, "unit": "MVAR" }, { "name": "Frequency", "dataType": "DOUBLE", "type": { "measurement": {} }, "unit": "Hz" }, { "name": "PowerFactor", "dataType": "DOUBLE", "type": { "metric": { "expression": "cos(atan(ReactivePower / ActivePower))", "variables": [ { "name": "ActivePower", "value": { "propertyId": "${ActivePower}" } }, { "name": "ReactivePower", "value": { "propertyId": "${ReactivePower}" } } ], "window": { "tumbling": { "interval": "5m" } } } }, "unit": "None" } ] } ``` 이 인터페이스를 다양한 생성기 자산 모델(가스 터빈, 증기 터빈, 풍력 터빈)에 적용하여 플릿 전체에서 일관된 전력 지표를 보장할 수 있습니다. ## 수처리 시설 물 유틸리티는 인터페이스를 사용하여 처리 공장 전반의 모니터링을 표준화할 수 있습니다. ``` { "assetModelName": "WATER-QUALITY-INTERFACE", "assetModelDescription": "Standard interface for water quality monitoring", "assetModelType": "INTERFACE", "assetModelProperties": [ { "name": "pH", "dataType": "DOUBLE", "type": { "measurement": {} }, "unit": "pH" }, { "name": "Turbidity", "dataType": "DOUBLE", "type": { "measurement": {} }, "unit": "NTU" }, { "name": "DissolvedOxygen", "dataType": "DOUBLE", "type": { "measurement": {} }, "unit": "mg/L" }, { "name": "QualityIndex", "dataType": "DOUBLE", "type": { "metric": { "expression": "(pH >= 6.5 && pH <= 8.5 ? 100 : 50) * (Turbidity < 1 ? 1 : 0.8) * (DissolvedOxygen > 5 ? 1 : 0.7)", "variables": [ { "name": "pH", "value": { "propertyId": "${pH}" } }, { "name": "Turbidity", "value": { "propertyId": "${Turbidity}" } }, { "name": "DissolvedOxygen", "value": { "propertyId": "${DissolvedOxygen}" } } ], "window": { "tumbling": { "interval": "1h" } } } }, "unit": "Score" } ] } ``` 이 인터페이스를 사용하면 특정 장비 구성에 관계없이 모든 처리 시설에서 수질을 일관되게 측정할 수 있습니다. ## 계층적 인터페이스 작업의 다양한 수준에서 집계 지표를 지원하도록 인터페이스를 계층적으로 구성할 수 있습니다. 1. **장비 수준 인터페이스**(예: `PUMP-INTERFACE`) + 속성: 흐름 속도, 압력, 전력 소비, 진동 + 지표: 효율성, 상태 점수 1. **프로세스 수준 인터페이스**(예: `PUMPING-STATION-INTERFACE`) + 속성: 총 흐름, 평균 압력, 총 출력 + 지표: 스테이션 효율성, 볼륨당 운영 비용 + 계층 구조: `PUMP-INTERFACE` 장비 포함 1. **시설 수준 인터페이스**(예: `WATER-FACILITY-INTERFACE`) + 속성: 시설 처리량, 에너지 사용량, 화학 물질 사용량 + 지표: 시설 효율성, 단위 볼륨당 비용, 탄소 발자국 + 계층 구조: `PUMPING-STATION-INTERFACE` 프로세스 포함 이 계층적 접근 방식을 사용하면 전체 작업에서 일관성을 유지하면서 각 수준에서 지표를 계산할 수 있습니다.