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

# 사용자 지정 복합 모델 업데이트(구성 요소)
<a name="update-custom-composite-models"></a>

 AWS IoT SiteWise API를 사용하여 사용자 지정 복합 모델을 업데이트하거나 AWS IoT SiteWise 콘솔을 사용하여 구성 요소를 업데이트할 수 있습니다.

**Topics**
+ [구성 요소 업데이트(콘솔)](#update-custom-composite-model-console)
+ [사용자 지정 복합 모델 업데이트(AWS CLI)](#update-custom-composite-model-cli)

## 구성 요소 업데이트(콘솔)
<a name="update-custom-composite-model-console"></a>

 AWS IoT SiteWise 콘솔을 사용하여 구성 요소를 업데이트할 수 있습니다.

**구성 요소를 업데이트하려면(콘솔)**

1. <a name="sitewise-open-console"></a>[AWS IoT SiteWise 콘솔](https://console.aws.amazon.com/iotsitewise/)로 이동합니다.

1. <a name="sitewise-choose-models"></a>탐색 창에서 **모델**을 선택합니다.

1. 구성 요소가 있는 자산 모델을 선택합니다.

1. **속성** 탭에서 **구성 요소**를 선택합니다.

1. 업데이트할 구성 요소를 선택합니다.

1. **편집**을 선택합니다.

1. **구성 요소 편집** 페이지에서 다음 중 하나를 수행합니다.
   + **모델 세부 정보**에서 모델의 **이름을** 변경합니다.
   + **속성 정의**를 변경합니다. 기존 속성의 **데이터 형식**은 변경할 수 없습니다. 자세한 내용은 [정적 데이터(속성) 정의](attributes.md) 단원을 참조하십시오.
   + **측정 정의**를 변경합니다. 기존 측정의 **데이터 형식**은 변경할 수 없습니다. 자세한 내용은 [장비의 데이터 스트림 정의(측정값)](measurements.md) 단원을 참조하십시오.
   + **변환 정의**를 변경합니다. 자세한 내용은 [데이터 변환(변환)](transforms.md) 단원을 참조하십시오.
   + **지표 정의**를 변경합니다. 기존 지표의 **시간 간격**은 변경할 수 없습니다. 자세한 내용은 [속성과 기타 자산에서 데이터 집계(지표)](metrics.md) 단원을 참조하십시오.

1. **저장**을 선택합니다.

## 사용자 지정 복합 모델 업데이트(AWS CLI)
<a name="update-custom-composite-model-cli"></a>

 AWS Command Line Interface (AWS CLI)를 사용하여 사용자 지정 복합 모델을 업데이트합니다.

이름 또는 설명을 업데이트하려면 [UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html) 작업을 사용합니다. 인라인 사용자 지정 복합 모델의 경우에만 속성도 업데이트할 수 있습니다. 참조된 구성 요소 모델은 관련 속성을 제공하므로 구성 요소 모델 기반 사용자 지정 복합 모델의 속성을 업데이트할 수 없습니다.

**중요**  
사용자 지정 복합 모델에서 속성을 제거하면가 해당 속성에 대한 모든 이전 데이터를 AWS IoT SiteWise 삭제합니다. 기존 속성의 유형 또는 데이터 유형은 변경할 수 없습니다.  
기존 복합 모델 속성을 동일한 `name`의 새 속성으로 바꾸려면 다음을 수행합니다.  
기존 속성 전체가 제거된 상태로 `UpdateAssetModelCompositeModel` 요청을 제출합니다.
새 속성이 포함된 두 번째 `UpdateAssetModelCompositeModel` 요청을 제출합니다. 새 자산 속성은 이전 자산 속성과 `name` 동일하며 고유한 새를 AWS IoT SiteWise 생성합니다`id`.

**사용자 지정 복합 모델을 업데이트하려면(AWS CLI) 다음을 수행하세요.**

1. 다음 명령을 실행하여 기존 복합 모델 정의를 검색합니다. *composite-model-id*를 업데이트할 사용자 지정 복합 모델의 ID 또는 외부 ID로 바꾸고 *asset-model-id*를 사용자 지정 복합 모델과 연결된 자산 모델로 바꿉니다. 자세한 내용은 *AWS IoT SiteWise 사용 설명서*를 참조하십시오.

   1. 아래 명령을 실행합니다.

      ```
      aws iotsitewise describe-asset-model-composite-model \
      --asset-model-composite-model-id composite-model-id \
      --asset-model-id asset-model-id
      ```

   1.  위 명령은 연결된 모델의 최신 버전에 해당하는 복합 모델 정의를 반환합니다. 자산 모델이 `FAILED` 상태에 있는 사용 사례의 경우 활성 버전에 해당하는 유효한 모델 정의를 검색하여 업데이트 요청을 빌드합니다. 세부 정보는 [자산 모델 버전](model-active-version.md) 섹션을 참조하세요.

   1. 다음 명령을 실행하여 활성 모델 정의를 검색합니다.

      ```
      aws iotsitewise describe-asset-model-composite-model \
      --asset-model-composite-model-id composite-model-id \
      --asset-model-id asset-model-id \
      --asset-model-version ACTIVE
      ```

   1. 자세한 내용은 [DescribeAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModelCompositeModel.html) 작업을 참조하세요.

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

1. 다음 필드를 제외하고 `update-custom-composite-model.json`의 JSON 객체에서 다음 키-값 페어를 제거합니다.
   + `assetModelCompositeModelName`
   + `assetModelCompositeModelDescription`(있는 경우)
   + `assetModelCompositeModelProperties`(있는 경우)

1. `update-custom-composite-model.json`에서 다음을 수행합니다.
   + `assetModelCompositeModelName`의 값을 변경합니다.
   + `assetModelCompositeModelDescription`을 추가 또는 제거하거나 값을 변경합니다.
   + 인라인 사용자 지정 복합 모델만 해당: `assetModelCompositeModelProperties`에서 자산 모델의 속성을 변경, 추가 또는 제거합니다.

   이 파일의 필수 형식에 대한 자세한 내용은 [UpdateAssetModelCompositeModel](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetModelCompositeModel.html)에 대한 요청 구문을 참조하세요.

1. 다음 명령을 실행하여 `update-custom-composite-model.json`에 저장된 정의로 사용자 지정 복합 모델을 업데이트합니다. *composite-model-id*를 복합 모델의 ID로 바꾸고 *asset-model-id*를 해당 자산 모델의 ID로 바꿉니다.

   ```
   aws iotsitewise update-asset-model-composite-model \
   --asset-model-composite-model-id composite-model-id \
   --asset-model-id asset-model-id \
   --cli-input-json file://update-custom-composite-model.json
   ```

**중요**  
 여러 사용자가 자산 모델을 동시에 업데이트하면 한 사용자가 다른 사용자의 변경 사항을 실수로 덮어쓸 수 있습니다. 이를 방지하려면 조건부 업데이트 요청을 정의해야 합니다. [자산 모델 쓰기를 위한 낙관적 잠금](opt-locking-for-model.md)을(를) 참조하세요.