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

# コマンドリソースを非推奨にする
<a name="iot-remote-command-deprecate"></a>

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

## 主な考慮事項
<a name="iot-remote-command-deprecate-considerations"></a>

コマンドを廃止する際の重要な考慮事項:
+ コマンドを非推奨にしても削除されません。コマンドは、その ID を使用して取得し、再利用のために復元できます。
+ 廃止されたコマンドで新しい実行を開始しようとすると、エラーが生成され、古いコマンドが使用できなくなります。
+ 廃止されたコマンドを実行するには、まず復元します。復元後、コマンドはターゲットデバイスで定期的に使用および実行できるようになります。
+ 実行中にコマンドを非推奨にすると、完了するまで実行が継続されます。実行ステータスは引き続き取得できます。

## コマンドリソースを非推奨にする (コンソール)
<a name="iot-remote-command-deprecate-console"></a>

コンソールからコマンドを非推奨にするには、 AWS IoT コンソールの [コマンドハブ](https://console.aws.amazon.com/iot/home#/commandHub)に移動し、次の手順を実行します。

1. 非推奨にするコマンドを選択し、**アクション**で**非推奨**を選択します。

1. コマンドを非推奨にすることを確認し、**[非推奨]** を選択します。

## コマンドリソースを非推奨にする(CLI)
<a name="iot-remote-command-deprecate-cli"></a>

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

## 非推奨の時間とステータスを確認する
<a name="iot-remote-command-deprecate-check"></a>

`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
}
```

## コマンドリソースを復元する
<a name="iot-remote-command-undeprecate"></a>

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

コンソールからコマンドを復元するには、 AWS IoT コンソールの [コマンドハブ](https://console.aws.amazon.com/iot/home#/commandHub)に移動し、復元するコマンドを選択し、**アクション**で**復元**を選択します。

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