

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 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"
            ]
        }
    ]
}
```

------