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

场外托管集成中心

Hub SDK 板外流程概述

集线器离线过程会将集线器从 AWS Cloud 管理系统中移除。当云端发送DeleteManagedThing请求时，该过程可以实现两个主要目标：

设备端操作：

云端操作：

客户通常在以下情况下启动集线器下线：

该过程可确保在集线器配置之间实现干净、安全的过渡，从而实现无缝的设备管理和帐户灵活性。

先决条件

Hub SDK 场外流程

请按照以下步骤退出集线器：

检索 hub_managed_thing ID

该iotmi_config.json文件用于存储托管集成中心的托管事物 ID。此标识符是允许集线器与 AWS IoT 托管集成服务通信的关键信息。托管事物 ID 存储在 JSON 文件的 rw（读写）部分的字段下managed_thing_id。在以下示例配置中可以看到这一点：

{
      "ro": {
          "iot_provisioning_method": "FLEET_PROVISIONING",
          "iot_claim_cert_path": "PATH",
          "iot_claim_pk_path": "PATH",
          "UPC": "UPC",
          "sh_endpoint_url": "ENDPOINT_URL",
          "SN": "SN",
          "fp_template_name": "TEMPLATENAME"
      },
      "rw": {
          "iot_provisioning_state": "PROVISIONED",
          "client_id": "ID",
          "managed_thing_id": "ID",
          "iot_permanent_cert_path": "CERT_PATH",
          "iot_permanent_pk_path": "KEY",
          "metadata": {
              "last_updated_epoch_time": 1747766125
          }
      }
}

向机外集线器发送命令

使用您的账户凭证，并使用上一节中managed_thing_id检索到的凭据运行命令：

aws iot-managed-integrations delete-managed-thing \
    --identifier HUB_MANAGED_THING_ID

验证集线器已下线

使用您的账户凭证，并使用上一节中managed_thing_id检索到的凭据运行命令：

aws iot-managed-integrations get-managed-thing \
    --identifier HUB_MANAGED_THING_ID

成功和失败场景

成功场景

如果成功执行了移出集线器的命令，则预计会出现以下示例响应：

{
      "Message" : "Managed Thing resource not found."   
}

此外，如果集线器离线命令成功，则iotmi_config.json会观察到以下示例。验证 rw 部分是否仅包含可选iot_provisioning_state的元数据。缺少元数据是可以接受的。 iot_provisioning_state必须是 NOT_ PROVISIONED。

{
      "ro": {
          "iot_provisioning_method": "FLEET_PROVISIONING",
          "iot_claim_cert_path": "PATH",
          "iot_claim_pk_path": "PATH",
          "UPC": "1234567890101",
          "sh_endpoint_url": "ENDPOINT_URL",
          "SN": "1234567890101",
          "fp_template_name": "test-template"
      },
      "rw": {
          "iot_provisioning_state": "NOT_PROVISIONED",
          "metadata": {
              "last_updated_epoch_time": 1747766125
          }
      }
}

失败场景

如果下线集线器的命令失败，则预计会出现以下示例响应：

{
      "Arn" : "ARN",
      "CreatedAt" : 1.748968266655E9,
      "Id" : "ID",
      "ProvisioningStatus" : "DELETE_IN_PROGRESS",
      "Role" : "CONTROLLER",
      "SerialNumber" : "SERIAL_NO",
      "Tags" : { },
      "UniversalProductCode" : "UPC",
      "UpdatedAt" : 1.748968272107E9
}

{
      "ro": {
          "iot_provisioning_method": "FLEET_PROVISIONING",
          "iot_claim_cert_path": "PATH",
          "iot_claim_pk_path": "PATH",
          "UPC": "123456789101",
          "sh_endpoint_url": "ENDPOINT_URL",
          "SN": "123456789101",
          "fp_template_name": "test-template"
      },
      "rw": {
          "iot_provisioning_state": "PROVISIONED",
          "client_id": "ID",
          "managed_thing_id": "ID",
          "iot_permanent_cert_path": "PATH",
          "iot_permanent_pk_path": "PATH",
          "metadata": {
              "last_updated_epoch_time": 1747766125
          }
      }
}

（可选）下线后 Hub SDK