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

オフボードマネージド統合ハブ

Hub SDK オフボードプロセスの概要

ハブオフボーディングプロセスは、 AWS クラウド 管理システムからハブを削除します。クラウドが DeleteManagedThing リクエストを送信すると、プロセスは 2 つの主要な目的を達成します。

デバイス側のアクション：

クラウド側のアクション：

お客様は通常、次の場合にハブオフボーディングを開始します。

このプロセスにより、ハブ設定間のクリーンで安全な移行が保証され、シームレスなデバイス管理とアカウントの柔軟性が可能になります。

前提条件

Hub SDK オフボードプロセス

ハブをオフボードするには、次の手順に従います。

hub_managed_thing ID を取得する

iotmi_config.json ファイルは、マネージド統合ハブのマネージドモノ ID を保存するために使用されます。この識別子は、ハブが AWS IoT Managed Integrations サービスと通信できるようにする重要な情報です。マネージド型モノ 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とオプションでメタデータのみが含まれていることを確認します。メタデータがないことは許容されます。 は NOT_PROVISIONED iot_provisioning_stateである必要があります。

{
      "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 をオフボーディングした後