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 [DeleteManagedThing](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_DeleteManagedThing.html)permintaan, proses menyelesaikan dua tujuan utama:
**Device-side tindakan**:
+ Setel ulang status internal hub
+ Hapus semua data yang disimpan secara lokal
+ Siapkan perangkat untuk orientasi ulang masa depan yang potensial
**Cloud-side tindakan**:
+ 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.
## Prasyarat
+ Anda harus memiliki hub yang terpasang. Untuk petunjuk, lihat [Pengaturan orientasi Hub](managedintegrations-sdk-v2-cookbook-hubsetup.md).
+ Dalam `iotmi_config.json` file yang terletak di**//data/aws/iotmi/config/**, verifikasi yang `iot_provisioning_state` menunjukkan`PROVISIONED`.
+ 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 [ DeleteManagedThing](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_DeleteManagedThing.html)API 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.json`File 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 benda terkelola disimpan di 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 Kegagalan
#### Skenario sukses
Jika perintah untuk offboard 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_state`harus **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 **ProvisioningStatus**ya`DELETE_IN_PROGRESS`, ikuti petunjuk dalam [pemulihan Hub](#hub-recovery).
+ Jika **ProvisioningStatus**tidak`DELETE_IN_PROGRESS`, perintah untuk melepaskan hub gagal di cloud Integrasi Terkelola, atau tidak diterima oleh cloud Integrasi Terkelola. Ikuti petunjuk dalam [pemulihan Hub](#hub-recovery).
+ 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.
**Re-onboard**
Jika offboarding berhasil, ikuti Hub SDK Anda dengan mengikuti [Langkah 3: Buat hal yang dikelola (penyediaan armada)](managedintegrations-sdk-v2-cookbook-hubsetup.md#managedintegrations-sdk-v2-cookbook-managedthing), dan proses onboard lainnya.
**Pemulihan hub**
**Keberhasilan offboarding hub perangkat dan offboarding Cloud gagal**
Jika panggilan [ GetManagedThing](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_GetManagedThing)API tidak mengembalikan `Managed Thing resource not found` pesan, tetapi file tersebut `iotmi_config.json` di-offboard. Lihat [skenario Sukses](#hub-offboarding-success-scenarios) untuk contoh file json.
Untuk memulihkan dari skenario ini, lihat [Penghapusan paksa](#forced-deletion).
**Offboarding hub perangkat gagal**
Skenario ini adalah ketika file `iotmi_config.json` tidak di-offboard dengan benar. Lihat [Skenario kegagalan](#hub-offboarding-failure-scenarios) untuk contoh file json.
Untuk memulihkan dari skenario ini, lihat [Penghapusan paksa](#forced-deletion). Jika `iotmi_config.json` masih belum di-offboard, hub harus disetel ulang pabrik.
**Offboarding hub perangkat dan offboarding Cloud gagal**
Dalam skenario ini, `iotmi_config.json` masih belum di-offboard, dan status hub adalah`ACTIVATED`, atau. `DISCOVERED`
Untuk memulihkan dari skenario ini, lihat [Penghapusan paksa](#forced-deletion). 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](#forced-deletion).
**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 ](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_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 ](https://docs.aws.amazon.com/iot-mi/latest/APIReference/API_GetManagedThing)API dan verifikasi bahwa itu kembali`Managed Thing resource not found`. Ini menegaskan bahwa sumber daya cloud dihapus.
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.