자산 또는 구성 요소 모델 업데이트 (AWS CLI) - AWS IoT SiteWise

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

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

AWS Command Line Interface (AWS CLI) 를 사용하여 자산 모델 또는 구성 요소 모델을 업데이트할 수 있습니다.

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

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

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

주의

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

참고

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

자산 모델 또는 구성 요소 모델을 업데이트하려면 (AWS CLI)

  1. 다음 명령을 실행하여 기존 모델 정의를 검색합니다. 업데이트할 자산 모델 또는 구성 요소 모델의 ID 또는 외부 asset-model-idID로 바꾸십시오.

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

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

    {
  "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"
  }
}

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

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

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

    • assetModelId

    • assetModelArn

    • assetModelCompositeModelSummaries

    • assetModelCreationDate

    • assetModelLastUpdateDate

    • assetModelStatus

    • assetModelType

    이 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에 저장된 정의로 자산 모델을 업데이트합니다. 에셋 모델의 asset-model-idID로 바꾸기:

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