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

コマンドリソースを非推奨にする

コマンドを非推奨にして、古いため使用しないでください。たとえば、同じ ID でペイロードが異なる新しいコマンドを作成するときに、コマンドがアクティブに維持されなくなった場合や、非推奨になります。

主な考慮事項

コマンドを廃止する際の重要な考慮事項:

コマンドリソースを非推奨にする (コンソール)

コンソールからコマンドを非推奨にするには、 AWS IoT コンソールの コマンドハブに移動し、次の手順を実行します。

コマンドリソースを非推奨にする(CLI)

update-command CLI を使用して、コマンドを非推奨としてマークします。削除する前にコマンドを非推奨にする必要があります。廃止されたコマンドを使用するには、まず復元します。

aws iot update-command \ 
    --command-id <command-id> \ 
    --deprecated

たとえば、上記の例で更新した ACSwitch コマンドを非推奨にした場合、次のコードはこのコマンドを実行した際のサンプル出力を示しています。

{
    "commandId": "turnOffAc",
    "deprecated": true,
    "lastUpdatedAt": "2024-05-09T23:16:51.370000-07:00"
}

非推奨の時間とステータスを確認する

GetCommand API を使用して、コマンドが廃止されたかどうか、および最後に廃止されたのはいつかを判断します。

aws iot get-command --command-id <turnOffAC>

このコマンドは、最後に更新されたフィールドの作成と非推奨のタイムスタンプなど、コマンド情報を含むレスポンスを生成します。これにより、コマンドの有効期間と、それを削除するか再利用するかが決まります。コマンドのレスポンスの例を次に示しますturnOffAc。

{
    "commandId": "turnOffAC",
    "commandArn": "arn:aws:iot:us-east-1:123456789012:command/turnOffAC",
    "namespace": "AWS-IoT",
    "payload": {
        "content": "testPayload.json",
        "contentType": "application/json"
    },
    "createdAt": "2024-03-23T00:50:10.095000-07:00",
    "lastUpdatedAt": "2024-05-09T23:16:51.370000-07:00",
    "deprecated": false
}

コマンドリソースを復元する

ACSwitch コマンドを使用またはデバイスに送信するには、まず復元します。

コンソールからコマンドを復元するには、 AWS IoT コンソールの コマンドハブに移動し、復元するコマンドを選択し、アクションで復元を選択します。

AWS IoT Core API または を使用してコマンドを復元するには AWS CLI、 UpdateCommand API オペレーションまたは CLI update-command を使用します。以下の例は、リクエストとレスポンスの例を示しています。

aws iot update-command \ 
    --command-id <command-id> 
    --no-deprecated

次の例は、出力の例を示しています。

{
    "commandId": "ACSwitch",
    "deprecated": false,
    "lastUpdatedAt": "2024-05-09T23:17:21.954000-07:00"
}