Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Hub di integrazioni gestite fuori bordo

Panoramica del processo offboard di Hub SDK

Il processo di offboarding dell'hub rimuove un hub dal Cloud AWS sistema di gestione. Quando il cloud invia una DeleteManagedThingrichiesta, il processo raggiunge due obiettivi principali:

Azioni lato dispositivo:

Azioni lato cloud:

I clienti in genere avviano l'offboarding dall'hub quando:

Il processo garantisce una transizione pulita e sicura tra le configurazioni dell'hub, consentendo una gestione senza interruzioni dei dispositivi e la flessibilità dell'account.

Prerequisiti

Processo offboard di Hub SDK

Segui questi passaggi per uscire dall'hub:

Recupera l'ID hub_managed_thing

Il iotmi_config.json file viene utilizzato per memorizzare l'ID dell'oggetto gestito per un hub di integrazioni gestite. Questo identificatore è un'informazione fondamentale che consente all'hub di comunicare con il servizio di integrazioni AWS IoT gestite. L'ID dell'oggetto gestito è memorizzato nella sezione rw (lettura-scrittura) del file JSON, sotto il campo. managed_thing_id Questo è visibile nella seguente configurazione di esempio:

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

Invia il comando all'hub esterno

Usa le credenziali del tuo account ed esegui il comando con quanto managed_thing_id recuperato nella sezione precedente:

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

Verifica che l'hub sia stato disattivato

Usa le credenziali del tuo account ed esegui il comando con i managed_thing_id dati recuperati nella sezione precedente:

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

Scenari di successo e fallimento

Scenario di successo

Se il comando di offboard dell'hub ha avuto esito positivo, è prevista la seguente risposta di esempio:

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

Inoltre, il seguente esempio iotmi_config.json verrebbe osservato se il comando hub offboarding avesse esito positivo. Verificate che la sezione rw contenga solo iot_provisioning_state e facoltativamente metadati. L'assenza di metadati è accettabile. iot_provisioning_statedeve essere 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
          }
      }
}

Scenario di fallimento

Se il comando di offboard dell'hub non ha avuto esito positivo, è prevista la seguente risposta di esempio:

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

(Facoltativo) Dopo l'offboarding di Hub SDK