자산 모델 및 구성 요소 모델 업데이트 - AWS IoT SiteWise

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

자산 모델 및 구성 요소 모델 업데이트

AWS IoT SiteWise 콘솔을 사용하거나 자산 모델 또는 API 구성 요소 모델을 업데이트하십시오.

기존 속성의 유형이나 데이터 유형 또는 기존 지표의 창은 변경할 수 없습니다. 또한 모델 유형을 자산 모델에서 구성 요소 모델로 또는 그 반대로 변경할 수 없습니다.

중요
  • 자산 모델이나 구성 요소 모델에서 속성을 제거하면 해당 속성에 대한 이전 데이터가 모두 AWS IoT SiteWise 삭제됩니다. 구성 요소 모델의 경우 이는 해당 구성 요소 모델을 사용하는 모든 자산 모델에 영향을 미치므로 변경 사항이 얼마나 광범위하게 적용될 수 있는지 이해하는 데 특히 주의해야 합니다.

  • 자산 모델에서 계층 정의를 제거하면 해당 계층 구조의 모든 AWS IoT SiteWise 자산이 분리됩니다.

자산 모델을 업데이트하면 해당 모델을 기반으로 하는 모든 자산에 기본 모델의 변경 사항이 반영됩니다. 변경 사항이 전파될 때까지 각 자산에는 UPDATING 상태가 있습니다. 이러한 자산과 상호 작용하기 전에 자산의 상태가 ACTIVE 상태로 돌아올 때까지 기다려야 합니다. 이 기간 동안 업데이트된 자산 모델의 상태는 PROPAGATING가 됩니다.

구성 요소 모델을 업데이트하면 해당 구성 요소 모델을 통합하는 모든 자산 모델에 변경 내용이 반영됩니다. 구성 요소 모델 변경 내용이 적용되기 전까지는 이전 단락에 설명된 대로 영향을 받는 각 자산 모델의 UPDATING 상태가 유지되고 관련 자산이 업데이트되는 시기가 뒤따릅니다. PROPAGATING 해당 자산 모델과 상호 작용하려면 해당 자산 모델이 ACTIVE 상태로 돌아올 때까지 기다려야 합니다. 이 기간 동안 업데이트된 구성 요소 모델의 상태는 다음과 같습니다PROPAGATING.

자세한 내용은 자산 및 모델 상태 단원을 참조하십시오.

자산 또는 구성 요소 모델 업데이트 (콘솔)

AWS IoT SiteWise 콘솔을 사용하여 자산 모델 또는 구성 요소 모델을 업데이트할 수 있습니다.

에셋 모델 또는 구성 요소 모델을 업데이트하려면 (콘솔)
  1. AWS IoT SiteWise 콘솔로 이동합니다.

  2. 탐색 창에서 모델을 선택합니다.

  3. 업데이트할 자산 모델 또는 구성 요소 모델을 선택합니다.

  4. 편집을 선택합니다.

  5. 모델 편집 페이지에서 다음 중 하나를 수행합니다.

  6. 저장(Save)을 선택합니다.

참고

모델 편집 페이지를 마지막으로 연 이후 다른 사용자가 에셋 모델을 성공적으로 업데이트한 경우 콘솔에서 이루어진 업데이트 요청은 거부됩니다. 콘솔은 업데이트된 모델을 가져오기 위해 모델 편집 페이지를 새로 고치라는 메시지를 표시합니다. 다시 업데이트한 다음 저장을 다시 시도해야 합니다. 자세한 내용은 자산 모델 쓰기에 대한 낙관적 잠금 섹션을 참조하세요.

에셋 또는 컴포넌트 모델 업데이트 ()AWS CLI

AWS Command Line Interface (AWS CLI) 를 사용하여 자산 모델 또는 구성 요소 모델을 업데이트하십시오.

UpdateAssetModelAPI를 사용하여 자산 모델 또는 구성 요소 모델의 이름, 설명 및 속성을 업데이트할 수 있습니다. 자산 모델의 경우에만 계층 구조를 업데이트할 수 있습니다. 다음 파라미터를 지정합니다.

  • assetModelId – 자산의 ID입니다. UUID형식상의 실제 ID 또는 ID가 있는 externalId:myExternalId 경우 ID입니다. 자세한 내용은AWS IoT SiteWise 사용 설명서외부 객체를 포함하는 참조 객체 IDs를 참조하십시오.

페이로드에 업데이트된 모델을 지정합니다. 자산 모델 또는 구성 요소 모델의 예상 형식에 대해 알아보려면 을 참조하십시오자산 모델 생성.

주의

는 기존 모델을 페이로드에 제공한 모델로 UpdateAssetModelAPI덮어씁니다. 모델의 속성이나 계층이 삭제되지 않도록 하려면 업데이트된 모델 페이로드에 해당 IDs 속성과 정의를 포함해야 합니다. 모델의 기존 구조를 쿼리하는 방법을 알아보려면 작업을 참조하십시오. DescribeAssetModel

참고

다음 프로시저는 유형의 복합 모델만 업데이트할 수 AWS/ALARM 있습니다. CUSTOM복합 모델을 업데이트하려면 UpdateAssetModelCompositeModel대신 사용하십시오. 자세한 내용은 사용자 지정 복합 모델 (구성 요소) 업데이트 단원을 참조하십시오.

자산 모델 또는 구성 요소 모델을 업데이트하려면 (AWS CLI)
  1. 다음 명령을 실행하여 기존 모델 정의를 검색합니다. Replace asset-model-id 업데이트할 자산 모델 또는 구성 요소 모델의 ID 또는 외부 ID를 사용합니다.

    aws iotsitewise describe-asset-model --asset-model-id asset-model-id

    위 명령은 모델의 최신 버전에 해당하는 모델 정의를 반환합니다.

    자산 모델이 FAILED 상태에 있는 사용 사례의 경우 활성 버전에 해당하는 유효한 모델 정의를 검색하여 업데이트 요청을 작성하십시오. 세부 정보는 에셋 모델 버전를 참조하세요. 다음 명령을 실행하여 활성 모델 정의를 검색하십시오.

    aws iotsitewise describe-asset-model --asset-model-id asset-model-id --asset-model-version ACTIVE

    이 작업은 모델의 세부 정보가 포함된 응답을 반환합니다. 응답의 구조는 다음과 같습니다.

    { "assetModelId": "String", "assetModelArn": "String", "assetModelName": "String", "assetModelDescription": "String", "assetModelProperties": Array of AssetModelProperty, "assetModelHierarchies": Array of AssetModelHierarchyDefinition, "assetModelCompositeModels": Array of AssetModelCompositeModel, "assetModelCompositeModelSummaries": Array of AssetModelCompositeModelSummary, "assetModelCreationDate": "String", "assetModelLastUpdateDate": "String", "assetModelStatus": { "state": "String", "error": { "code": "String", "message": "String" }, "assetModelType": "String" }, "assetModelVersion": "String", "eTag": "String" }

    자세한 내용은 DescribeAssetModel작업을 참조하십시오.

  2. update-asset-model.json이라는 파일을 만들고 이전 명령의 응답을 파일에 복사합니다.

  3. 의 JSON 객체에서 다음 키-값 쌍을 제거합니다. update-asset-model.json

    • assetModelId

    • assetModelArn

    • assetModelCompositeModelSummaries

    • assetModelCreationDate

    • assetModelLastUpdateDate

    • assetModelStatus

    • assetModelType

    • assetModelVersion

    • eTag

    UpdateAssetModel작업에는 다음과 같은 구조의 페이로드가 필요합니다.

    { "assetModelName": "String", "assetModelDescription": "String", "assetModelProperties": Array of AssetModelProperty, "assetModelHierarchies": Array of AssetModelHierarchyDefinition, "assetModelCompositeModels": Array of AssetModelCompositeModel }
  4. update-asset-model.json에서 다음을 수행합니다.

    • 자산 모델의 이름(assetModelName)을 변경합니다.

    • 자산 모델의 설명(assetModelDescription)을 변경, 추가 또는 제거합니다.

    • 자산 모델의 속성(assetModelProperties)을 변경, 추가 또는 제거합니다. 기본 속성의 dataType 또는 기존 지표의 window는 변경할 수 없습니다. 자세한 내용은 데이터 속성을 정의합니다. 단원을 참조하십시오.

    • 자산 모델의 계층 구조(assetModelHierarchies)를 변경, 추가 또는 제거합니다. 기존 계층 구조의 childAssetModelId는 변경할 수 없습니다. 자세한 내용은 자산 모델 계층 구조를 정의합니다. 단원을 참조하십시오.

    • 자산 모델의 복합 모델 유형 AWS/ALARM (assetModelCompositeModels) 을 변경, 추가 또는 제거합니다. 경보는 다른 속성을 모니터링하므로 장비나 프로세스에 주의가 필요한 시점을 식별할 수 있습니다. 각 경보 정의는 경보가 사용하는 속성 집합을 표준화하는 복합 모델입니다. 자세한 내용은 알람으로 데이터를 모니터링합니다.자산 모델에 경보를 정의합니다. 단원을 참조하세요.

  5. 다음 명령을 실행하여 update-asset-model.json에 저장된 정의로 자산 모델을 업데이트합니다. Replace asset-model-id 에셋 모델의 ID 사용:

    aws iotsitewise update-asset-model \ --asset-model-id asset-model-id \ --cli-input-json file://model-payload.json
중요

여러 사용자가 동시에 자산 모델을 업데이트하면 다른 사용자가 실수로 사용자의 변경 내용을 덮어쓸 수 있습니다. 이를 방지하려면 조건부 업데이트 요청을 정의해야 합니다. 자산 모델 쓰기에 대한 낙관적 잠금을 참조하세요.