

AWS IoT FleetWise は、2026 年 4 月 30 日をもって新規顧客に公開されなくなります。既存の AWS IoT FleetWise のお客様は、このサービスを引き続き使用できます。[の「接続モビリティのガイダンス AWS](https://aws.amazon.com/solutions/guidance/connected-mobility-on-aws/)」では、 AWS IoT FleetWise と同等の機能を実現するために使用できる接続モビリティソリューションのモジュラーサービスを開発およびデプロイする方法に関するガイダンスを提供します。

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

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

------