弃用命令资源 - Amazon IoT Core
重要注意事项弃用命令资源（控制台）弃用命令资源（CLI）检查弃用时间和状态恢复命令资源
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

弃用命令资源

弃用命令以表明它们已过时且不应使用。例如，弃用不再主动维护的命令，或者在创建具有相同 ID 但负载不同的新命令时。

重要注意事项

弃用命令时的重要注意事项：

  • 弃用命令并不能将其删除。您可以使用其 ID 检索命令，然后将其恢复以供重复使用。

  • 尝试对已弃用的命令开始新的执行会生成错误，从而导致无法使用过时的命令。

  • 要执行已弃用的命令，请先将其恢复。恢复后，该命令即可在目标设备上正常使用和执行。

  • 如果您在执行过程中弃用了某个命令，则这些命令会继续运行直到完成。您仍然可以检索执行状态。

弃用命令资源（控制台）

要弃用控制台中的命令，请转到控制台的 Command Hub 并执行以下步骤。Amazon IoT

  1. 选择要弃用的命令，然后在 “操作” 下选择 “弃用”。

  2. 确认您要弃用该命令，然后选择弃用。

弃用命令资源（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命令发送到您的设备，请先将其恢复。

要从控制台恢复命令，请转到控制台的 C ommand Hub，选择要恢复的命令，然后在 “操作” 下选择 “恢复”。Amazon IoT

要使用 Amazon IoT Core API 或，恢复命令Amazon CLI，请使用 UpdateCommand API 操作或 update-command CLI。以下代码显示了使用示例请求和响应。

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

以下代码显示了示例输出。

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