Topik Konfigurasi Jarak Jauh dan format data Alink | IoT Platform - IoT Platform

Menjelaskan topik dan format data Alink untuk permintaan konfigurasi yang diinisiasi oleh perangkat serta dorongan konfigurasi dari IoT Platform.

Petunjuk penggunaan langkah demi langkah tersedia dalam panduan pengguna Remote Configuration.

Permintaan konfigurasi perangkat

Uplink

Request topic: /sys/${productKey}/${deviceName}/thing/config/get
Response topic: /sys/${productKey}/${deviceName}/thing/config/get_reply

Alink request data format

{
  "id": 123,
  "version": "1.0",
  "sys":{
      "ack":0
  },
  "params": {
    "configScope": "product",
    "getType": "file"
  },
  "method": "thing.config.get"
}

Alink response data format

{
  "id": "123",
  "version": "1.0",
  "code": 200,
  "data": {
    "configId": "123dagdah",
    "configSize": 1234565,
    "sign": "123214adfadgadg",
    "signMethod": "Sha256",
    "url": "https://iotx-config.oss-cn-shanghai.aliyuncs.com/nopoll_0.4.4.tar.gz?Expires=1502955804&OSSAccessKeyId=XXXXXXXXXXXXXXXXXXXX&Signature=XfgJu7P6DWWejstKJgXJEH0qAKU%3D&security-token=CAISuQJ1q6Ft5B2yfSjIpK6MGsyN1Jx5jo6mVnfBglIPTvlvt5D50Tz2IHtIf3NpAusdsv03nWxT7v4flqFyTINVAEvYZJOPKGrGR0DzDbDasumZsJbo4f%2FMQBqEaXPS2MvVfJ%2BzLrf0ceusbFbpjzJ6xaCAGxypQ12iN%2B%2Fr6%2F5gdc9FcQSkL0B8ZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO1wEP4K%2BkkMqH8Uic3h%2Boy%2BgJt8H2PpHhd9NhXuV2WMzn2%2FdtJOiTknxR7ARasaBqhelc4zqA%2FPPlWgAKvkXba7aIoo01fV4jN5JXQfAU8KLO8tRjofHWmojNzBJAAPpYSSy3Rvr7m5efQrrybY1lLO6iZy%2BVio2VSZDxshI5Z3McKARWct06MWV9ABA2TTXXOi40BOxuq%2B3JGoABXC54TOlo7%2F1wTLTsCUqzzeIiXVOK8CfNOkfTucMGHkeYeCdFkm%2FkADhXAnrnGf5a4FbmKMQph2cKsr8y8UfWLC6IzvJsClXTnbJBMeuWIqo5zIynS1pm7gf%2F9N3hVc6%2BEeIk0xfl2tycsUpbL2FoaGk6BAF8hWSWYUXsv59d5Uk%3D",
    "getType": "file"
  }
}

Parameter

Parameter	Type	Description
id	String	ID pesan. String numerik unik per perangkat dalam rentang `0` hingga `4294967295`.
version	String	Versi protokol. Tetapkan ke `1.0`.
sys	Object	Parameter fitur tambahan. Catatan Jika Anda menggunakan SDK sisi perangkat dan tidak mengatur fitur tambahan, parameter ini dihilangkan dan berlaku konfigurasi default.
ack	Integer	Menentukan apakah cloud mengembalikan respons. Merupakan bidang di bawah sys. 1: Cloud mengembalikan respons. 0: Cloud tidak mengembalikan respons. Penting Detail konfigurasi: Contoh penggunaan model Thing Specification Language. Jika tidak dikonfigurasi, parameter ini dihilangkan dan cloud secara default mengembalikan respons.
configScope	String	Cakupan konfigurasi. Hanya tingkat produk yang didukung. Tetapkan ke `product`.
getType	String	Jenis konfigurasi. Hanya file yang didukung. Tetapkan ke `file`.
method	String	Metode permintaan. Tetapkan ke `thing.config.get`.
configId	String	ID file konfigurasi.
configSize	Long	Ukuran file konfigurasi, dalam byte.
sign	String	Tanda tangan.
signMethod	String	Metode penandatanganan. Hanya Sha256 yang didukung.
url	String	URL OSS dari file konfigurasi.
code	Integer	Kode hasil. Nilai 200 menunjukkan keberhasilan. Kode lainnya tercantum dalam Kode umum sisi perangkat.

Kode error

Error code	Message	Description
6713	thing config function is not available	Konfigurasi Jarak Jauh belum diaktifkan untuk produk tersebut. Di IoT Platform consoleMonitoring > Remote Configuration dan aktifkan fitur tersebut.
6710	no data	Tidak ada data konfigurasi.

Dorongan konfigurasi

Downlink

Request topic: /sys/${productKey}/${deviceName}/thing/config/push
Response topic: /sys/${productKey}/${deviceName}/thing/config/push_reply

Setelah perangkat berlangganan topik ini, IoT Platform secara asinkron mendorong informasi konfigurasi saat Anda melakukan dorongan batch di konsol.

Alink request data format

{
  "id": "123",
  "version": "1.0",
  "params": {
    "configId": "123dagdah",
    "configSize": 1234565,
    "sign": "123214adfadgadg",
    "signMethod": "Sha256",
    "url": "https://iotx-config.oss-cn-shanghai.aliyuncs.com/nopoll_0.4.4.tar.gz?Expires=1502955804&OSSAccessKeyId=XXXXXXXXXXXXXXXXXXXX&Signature=XfgJu7P6DWWejstKJgXJEH0qAKU%3D&security-token=CAISuQJ1q6Ft5B2yfSjIpK6MGsyN1Jx5jo6mVnfBglIPTvlvt5D50Tz2IHtIf3NpAusdsv03nWxT7v4flqFyTINVAEvYZJOPKGrGR0DzDbDasumZsJbo4f%2FMQBqEaXPS2MvVfJ%2BzLrf0ceusbFbpjzJ6xaCAGxypQ12iN%2B%2Fr6%2F5gdc9FcQSkL0B8ZrFsKxBltdUROFbIKP%2BpKWSKuGfLC1dysQcO1wEP4K%2BkkMqH8Uic3h%2Boy%2BgJt8H2PpHhd9NhXuV2WMzn2%2FdtJOiTknxR7ARasaBqhelc4zqA%2FPPlWgAKvkXba7aIoo01fV4jN5JXQfAU8KLO8tRjofHWmojNzBJAAPpYSSy3Rvr7m5efQrrybY1lLO6iZy%2BVio2VSZDxshI5Z3McKARWct06MWV9ABA2TTXXOi40BOxuq%2B3JGoABXC54TOlo7%2F1wTLTsCUqzzeIiXVOK8CfNOkfTucMGHkeYeCdFkm%2FkADhXAnrnGf5a4FbmKMQph2cKsr8y8UfWLC6IzvJsClXTnbJBMeuWIqo5zIynS1pm7gf%2F9N3hVc6%2BEeIk0xfl2tycsUpbL2FoaGk6BAF8hWSWYUXsv59d5Uk%3D",
    "getType": "file"
  },
  "method": "thing.config.push"
}

Alink response data format

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

Parameter

Parameter	Type	Description
id	String	ID pesan. String numerik unik per perangkat dalam rentang `0` hingga `4294967295`.
version	String	Versi protokol. Tetapkan ke `1.0`.
configScope	String	Cakupan konfigurasi. Hanya tingkat produk yang didukung. Tetapkan ke `product`.
getType	String	Jenis konfigurasi. Hanya file yang didukung. Tetapkan ke `file`.
configId	String	ID konfigurasi.
configSize	Long	Ukuran konfigurasi, dalam byte.
sign	String	Signature.
signMethod	String	Metode penandatanganan. Hanya sha256 yang didukung.
url	String	URL OSS dari file konfigurasi.
metode	String	Metode permintaan. Tetapkan ke `thing.config.push`.
code	Integer	Kode hasil. Nilai yang mungkin tercantum dalam Kode umum sisi perangkat.

Gunakan fitur penerusan data dari mesin aturan untuk meneruskan respons perangkat ke topik lain dan layanan Alibaba Cloud. Topik respons dan formatnya dijelaskan dalam Penerusan data untuk respons perangkat terhadap instruksi downlink.