Hub integrasi terkelola offboard - Integrasi terkelola untuk AWS IoT Device Management
Ikhtisar proses offboard Hub SDKPrasyaratProses offboard Hub SDKSetelah offboarding Hub SDK

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Hub integrasi terkelola offboard

Ikhtisar proses offboard Hub SDK

Proses offboarding hub menghapus hub dari sistem AWS Cloud manajemen. Ketika cloud mengirimkan DeleteManagedThingpermintaan, proses menyelesaikan dua tujuan utama:

Tindakan sisi perangkat:

  • Setel ulang status internal hub

  • Hapus semua data yang disimpan secara lokal

  • Siapkan perangkat untuk orientasi ulang future potensial

Tindakan sisi awan:

  • Hapus semua sumber daya cloud yang terkait dengan hub

  • Pemutusan lengkap dari akun sebelumnya

Pelanggan biasanya memulai hub offboarding ketika:

  • Mengubah akun terkait hub

  • Mengganti hub yang ada dengan perangkat baru

Proses ini memastikan transisi yang bersih dan aman antara konfigurasi hub, memungkinkan manajemen perangkat yang mulus dan fleksibilitas akun.

Diagram offboarding hub

Prasyarat

  • Anda harus memiliki hub yang terpasang. Untuk petunjuk, lihat Pengaturan orientasi Hub.

  • Dalam iotmi_config.json file yang terletak di/data/aws/iotmi/config/, verifikasi yang iot_provisioning_state menunjukkanPROVISIONED.

  • Konfirmasikan bahwa sertifikat dan kunci permanen yang direferensikan iotmi_config.json ada di jalur yang ditentukan.

  • Pastikan bahwa HubOnboarding, Agen, Penyedia, dan proxy MQTT dikonfigurasi dan berjalan dengan benar.

  • Verifikasi bahwa hub tidak memiliki perangkat anak. Gunakan DeleteManagedThingAPI untuk menghapus semua perangkat anak sebelum melanjutkan.

Proses offboard Hub SDK

Ikuti langkah-langkah ini untuk melepaskan hub:

Ambil ID hub_managed_thing

iotmi_config.jsonFile ini digunakan untuk menyimpan ID hal terkelola untuk hub integrasi Terkelola. Pengenal ini adalah bagian penting dari informasi yang memungkinkan hub untuk berkomunikasi dengan layanan Integrasi AWS IoT Terkelola. ID hal yang dikelola disimpan dalam bagian rw (baca-tulis) dari file JSON, di bawah bidang. managed_thing_id Ini terlihat pada konfigurasi sampel berikut: 

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

Kirim perintah ke hub offboard

Gunakan kredensi akun Anda dan jalankan perintah dengan yang managed_thing_id diambil di bagian sebelumnya: 

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

Verifikasi hub telah di-offboard

Gunakan kredensi akun Anda dan jalankan perintah dengan yang managed_thing_id diambil di bagian sebelumnya: 

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

Skenario sukses dan gagal

Skenario sukses

Jika perintah untuk melepaskan hub berhasil, respons sampel berikut diharapkan: 

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

Selain itu, sampel berikut iotmi_config.json akan diamati jika perintah hub offboarding berhasil. Verifikasi bahwa bagian rw hanya berisi metadata iot_provisioning_state dan opsional. Tidak adanya metadata dapat diterima. iot_provisioning_stateharus 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
          }
      }
}

Skenario kegagalan

Jika perintah untuk melepaskan hub tidak berhasil, respons sampel berikut diharapkan: 

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

  • Jika ProvisioningStatusyaDELETE_IN_PROGRESS, ikuti petunjuk dalam pemulihan Hub.

  • Jika ProvisioningStatustidakDELETE_IN_PROGRESS, perintah untuk melepaskan hub gagal di cloud Integrasi terkelola, atau tidak diterima oleh cloud integrasi Terkelola. Ikuti petunjuk dalam pemulihan Hub.

  • Jika offboarding tidak berhasil, iotmi_config.json file Anda akan terlihat seperti file contoh di bawah ini. 

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

(Opsional) Setelah offboarding Hub SDK

penting

Skenario berikut mencantumkan tindakan opsional yang harus dilakukan setelah offboarding Hub SDK gagal, atau jika Anda ingin melakukan onboard ulang hub setelah offboarding.

Masuk kembali

Jika offboarding berhasil, ikuti Hub SDK Anda dengan mengikuti Langkah 3: Buat hal yang dikelola (penyediaan armada), dan proses onboard lainnya.

Pemulihan hub
Keberhasilan offboarding hub perangkat dan offboarding Cloud gagal

Jika panggilan GetManagedThingAPI tidak mengembalikan Managed Thing resource not found pesan, tetapi file tersebut iotmi_config.json di-offboard. Lihat skenario Sukses untuk contoh file json.

Untuk memulihkan dari skenario ini, lihat Penghapusan paksa.

Offboarding hub perangkat gagal

Skenario ini adalah ketika file iotmi_config.json tidak di-offboard dengan benar. Lihat Skenario kegagalan untuk contoh file json.

Untuk memulihkan dari skenario ini, lihat Penghapusan paksa. Jika iotmi_config.json masih belum di-offboard, hub harus di-reset pabrik.

Offboarding hub perangkat dan offboarding Cloud gagal

Dalam skenario ini, iotmi_config.json masih belum di-offboard, dan status hub adalahACTIVATED, atau. DISCOVERED

Untuk memulihkan dari skenario ini, lihat Penghapusan paksa. Jika penghapusan paksa gagal, atau iotmi_config.json masih belum di-offboard, hub harus disetel ulang pabrik.

Hub sedang offline dan status hub adalah DELETE_IN_PROGRESS

Dalam skenario ini, hub sedang offline dan cloud menerima perintah offboarding.

Untuk memulihkan dari skenario ini, lihat Penghapusan paksa.

Penghapusan paksa

Untuk menghapus sumber daya cloud tanpa offboarding hub perangkat yang berhasil, ikuti langkah-langkah berikut. Operasi ini dapat mengakibatkan ketidakkonsistenan antara status cloud dan perangkat, yang berpotensi menyebabkan masalah dengan operasi masa depan.

Panggil DeleteManagedThing API dengan hub managed_thing_id dan parameter gaya: 

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

Selanjutnya, panggil GetManagedThing API dan verifikasi bahwa itu kembaliManaged Thing resource not found. Ini menegaskan bahwa sumber daya cloud dihapus.

catatan

Pendekatan ini tidak disarankan, karena dapat menyebabkan inkonsistensi antara cloud dan status perangkat. Umumnya lebih baik untuk memastikan offboarding hub perangkat yang sukses sebelum mencoba menghapus sumber daya cloud.