全部产品
Search
文档中心

IoT Platform:Aktifkan, nonaktifkan, atau hapus perangkat sub

更新时间:Jul 02, 2025

Perangkat gateway dapat mengaktifkan, menonaktifkan, atau menghapus perangkat sub.

Menonaktifkan perangkat sub

Topik-topik berikut digunakan ketika IoT Platform mengirimkan permintaan ke perangkat dan perangkat mengirimkan respons ke IoT Platform:

  • Topik permintaan: /sys/${productKey}/${deviceName}/thing/disable.
  • Topik respons: /sys/${productKey}/${deviceName}/thing/disable_reply.

Perangkat gateway dapat menonaktifkan perangkat sub menggunakan topik-topik di atas. IoT Platform mengirimkan pesan ke topik permintaan secara asinkron untuk menginstruksikan perangkat gateway menonaktifkan perangkat sub. Perangkat sub berlangganan topik permintaan melalui perangkat gateway, kemudian memperoleh pesan dari topik tersebut.

Contoh permintaan dalam format JSON Alink:

{
  "id": "123",
  "version": "1.0",
  "params": {},
  "method": "thing.disable"
}

Contoh respons dalam format JSON Alink:

{
  "id": "123",
  "code": 200,
  "data": {}
}

Tabel berikut menjelaskan parameter-parameter tersebut.

ParameterTipeDeskripsi
idString

ID pesan. Nilai valid: 0 hingga 4294967295. Setiap ID pesan harus unik untuk perangkat.

versionStringVersi protokol. Nilai valid: 1.0.
paramsObjectParameter permintaan. Anda dapat membiarkan parameter params kosong.
methodStringMetode permintaan. Nilai valid: thing.disable.
codeIntegerKode status dalam respons. Untuk informasi lebih lanjut, lihat Kode umum pada perangkat.

Mengaktifkan kembali perangkat sub yang dinonaktifkan

Topik-topik berikut digunakan ketika IoT Platform mengirimkan permintaan ke perangkat dan perangkat mengirimkan respons ke IoT Platform:

Penting
  • Setelah perangkat sub gateway terhubung ke IoT Platform melalui MQTT, perangkat sub harus berlangganan topik-topik menggunakan perangkat gateway. Kemudian, perangkat sub dapat memperoleh pesan dari topik-topik tersebut. Jika perangkat sub dinonaktifkan, perangkat sub akan berada dalam keadaan offline dan tidak dapat memperoleh pesan dari topik yang disubskripsinya. Perangkat sub gateway yang dinonaktifkan tidak dapat diaktifkan kembali menggunakan topik-topik berikut. Untuk mengaktifkan kembali perangkat sub, Anda harus memodifikasi hubungan topologi. Untuk informasi lebih lanjut tentang topik, lihat Memberitahu Gateway tentang Perubahan Hubungan Topologi.
  • Setelah perangkat terhubung ke IoT Platform menggunakan IoT as Bridge SDK, perangkat dapat menerima pesan downstream tanpa perlu berlangganan topik. Jika perangkat sub dinonaktifkan, topik-topik berikut dapat digunakan untuk mengaktifkan kembali perangkat sub:
  • Topik permintaan: /sys/${productKey}/${deviceName}/thing/enable.
  • Topik respons: /sys/${productKey}/${deviceName}/thing/enable_reply.

Perangkat gateway dapat mengaktifkan kembali perangkat sub yang dinonaktifkan menggunakan topik-topik di atas. IoT Platform mengirimkan pesan ke topik permintaan secara asinkron untuk menginstruksikan perangkat gateway mengaktifkan perangkat sub. Perangkat sub berlangganan topik permintaan dan memperoleh pesan dari topik tersebut.

Contoh permintaan dalam format JSON Alink:

{
  "id": "123",
  "version": "1.0",
  "params": {},
  "method": "thing.enable"
}

Contoh respons dalam format JSON Alink:

{
  "id": "123",
  "code": 200,
  "data": {}
}

Deskripsi Parameter

ParameterTipeDeskripsi
idString

ID pesan. Nilai valid: 0 hingga 4294967295. Setiap ID pesan harus unik untuk perangkat.

versionStringVersi protokol. Nilai valid: 1.0.
paramsObjectParameter permintaan. Anda dapat membiarkan parameter params kosong.
methodStringMetode permintaan. Nilai valid: thing.enable.
codeIntegerKode status dalam respons. Untuk informasi lebih lanjut, lihat Kode umum yang dikembalikan oleh perangkat.

Menghapus perangkat sub

Penting Perangkat gateway dapat menghapus perangkat sub yang terhubung ke IoT Platform. Untuk informasi lebih lanjut tentang dampak yang terjadi setelah perangkat sub dihapus, lihat Menghapus Perangkat.

Topik-topik berikut digunakan ketika IoT Platform mengirimkan permintaan ke perangkat dan perangkat mengirimkan respons ke IoT Platform:

  • Topik permintaan: /sys/${productKey}/${deviceName}/thing/delete.
  • Topik respons: /sys/${productKey}/${deviceName}/thing/delete_reply.

Perangkat gateway dapat menghapus perangkat sub menggunakan topik-topik di atas. IoT Platform mengirimkan pesan ke topik permintaan secara asinkron untuk menginstruksikan perangkat gateway menghapus perangkat sub. Perangkat sub berlangganan topik permintaan melalui perangkat gateway, kemudian memperoleh pesan dari topik tersebut.

Contoh permintaan dalam format JSON Alink:

{
  "id": "123",
  "version": "1.0",
  "params": {},
  "method": "thing.delete"
}

Contoh respons dalam format JSON Alink:

{
  "id": "123",
  "code": 200,
  "data": {}
}

Tabel berikut menjelaskan parameter-parameter tersebut.

ParameterTipeDeskripsi
idString

ID pesan. Nilai valid: 0 hingga 4294967295. Setiap ID pesan harus unik untuk perangkat.

versionStringVersi protokol. Nilai valid: 1.0.
paramsObjectParameter permintaan. Anda dapat membiarkan parameter params kosong.
methodStringMetode permintaan. Nilai valid: thing.delete.
codeStringKode status dalam respons. Untuk informasi lebih lanjut, lihat Kode umum yang dikembalikan oleh perangkat.