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

# AWS IoT FleetWise 차량 업데이트
<a name="update-vehicle-cli"></a>

**중요**  
특정 AWS IoT FleetWise 기능에 대한 액세스는 현재 게이트됩니다. 자세한 내용은 [AWS AWS IoT FleetWise의 리전 및 기능 가용성](fleetwise-regions.md) 단원을 참조하십시오.

[UpdateVehicle](https://docs.aws.amazon.com/iot-fleetwise/latest/APIReference/API_UpdateVehicle.html) API 작업을 사용하여 기존 차량을 업데이트할 수 있습니다. 다음 예제에서는 AWS CLI를 사용합니다.

차량을 업데이트하려면 다음 명령을 실행합니다.

*file-name*을 차량 구성이 포함된 .json 파일의 이름으로 바꿉니다.

```
aws iotfleetwise update-vehicle --cli-input-json file://file-name.json
```

**Example - 차량 구성**  
+ *vehicle-name*을 업데이트하려는 차량의 ID로 교체하세요.
+ (선택 사항) *model-manifest-ARN*을 사용 중인 차량 모델을 교체하는 데 사용하는 차량 모델(모델 매니페스트)의 ARN으로 교체합니다.
+ (선택 사항) *decoder-manifest-ARN*을 지정한 새 차량 모델과 연결된 디코더 매니페스트의 ARN으로 교체하세요.
+ (선택 사항) *attribute-update-mode*를 차량 속성으로 교체하세요.
  + `Merge`— 기존 속성을 새 값으로 업데이트하고 새 속성이 없으면 추가하여 새 속성을 기존 속성에 병합합니다.

    예를 들어, 차량에 `{"color": "black", "fuelType": "electric"}`와(과) 같은 속성이 있고 차량을 `{"color": "", "fuelType": "gasoline", "model": "x"}` 속성으로 업데이트하면 업데이트된 차량의 속성은 다음과 같습니다: `{"fuelType": "gasoline", "model": "x"}`.
  + `Overwrite`— 기존 속성을 새 속성으로 대체합니다.

    예를 들어, 차량에 `{"color": "black", "fuelType": "electric"}`와(과) 같은 속성이 있는 경우 차량을 해당 `{"model": "x"}` 속성으로 업데이트하면 업데이트된 차량에도 해당 `{"model": "x"}` 속성이 있습니다.

  입력에 속성이 있는 경우 이는 필수입니다.
+ (선택 사항) 새 속성을 추가하거나 기존 속성을 새 값으로 업데이트하려면 `attributes`를 구성하세요. 예를 들어 전기 자동차를 사용하는 경우 속성에 다음 값을 지정할 수 있습니다: `{"fuelType": "electric"}`.

  속성을 삭제하려면 `attributeUpdateMode`를 `Merge`로 구성하세요.
**중요**  <a name="update-attributes-requirement"></a>
속성을 개별 차량에 추가하려면 먼저 관련 차량 모델에서 속성을 정의해야 합니다.

```
 { 
         "vehicleName": "vehicle-name",
         "modelManifestArn": "model-manifest-arn",
         "decoderManifestArn": "decoder-manifest-arn",
         "attributeUpdateMode": "attribute-update-mode"
         }         
}
```

**Example - 차량과 연결된 상태 템플릿 추가 또는 제거**  
다음 필드를 사용하여 추가 상태 템플릿을 연결하거나 차량에서 기존 연결을 제거할 수 있습니다.  
+ `stateTemplatesToAdd` 
+ `stateTemplatesToRemove` 

```
aws iotfleetwise update-vehicle --cli-input-json file://update-vehicle.json
```
`update-vehicle.json` 파일에 포함된 위치(예:):  

```
{
    "vehicleName": "vehicle-name",
    "modelManifestArn": "model-manifest-arn",
    "decoderManifestArn": "decoder-manifest-arn",
    "attributeUpdateMode": "attribute-update-mode",
    "stateTemplatesToAdd": [ 
        {
            "identifier": "state-template-name",
            "stateTemplateUpdateStrategy": {
                "onChange": {}
            }
        }
    ],
    "stateTemplatesToRemove": ["state-template-name"]            
}
```

고객 관리형 AWS KMS 키를 사용하여 [암호화를 활성화](key-management.md)한 경우 역할이 `UpdateVehicle` API 작업을 호출할 수 있도록 다음 정책 설명을 포함합니다.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kms:GenerateDataKey*",
                "kms:Decrypt"
            ],
            "Resource": [
                "arn:aws:kms:us-east-1:111122223333:key/KMS_KEY_ID"
            ]
        }
    ]
}
```

------