CreateTopicRouteTable - IoT Platform - Alibaba Cloud Documentation Center

Membuat hubungan perutean pesan antar topik.

Batasan

Anda dapat menentukan hingga 100 topik tujuan untuk satu topik sumber.
Perangkat tempat topik sumber berada harus diaktifkan.
Topik sumber dan tujuan hanya mendukung topik kustom.
Setiap Akun Alibaba Cloud dapat menjalankan maksimal 50 permintaan per detik (QPS).
Catatan Pengguna RAM dari suatu Akun Alibaba Cloud berbagi kuota akun tersebut.

Debugging

Alibaba Cloud menyediakan OpenAPI Explorer untuk menyederhanakan penggunaan API. OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi ini untuk berbagai SDK.

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	CreateTopicRouteTable	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateTopicRouteTable.
DstTopic.N	RepeatList	Ya	/x7aWKW9****/deviceNameTest1/user/add	Daftar topik tujuan. Topik tujuan tersebut berlangganan ke topik sumber yang ditentukan oleh parameter SrcTopic. Gunakan tipe data array meskipun Anda hanya menentukan satu topik tujuan. Contoh: `DstTopic.1=/x7aWKW9**/deviceNameTest1/user/add` dan `DstTopic.2=/x7aWKW9**/deviceNameTest2/user/delete`.
SrcTopic	String	Ya	/x7aWKW9****/testDataToDataHub/user/update	Topik sumber. Contoh: `SrcTopic=/x7aWKW9 ****** /testDataToDataHub/user/update`.
IotInstanceId	String	Tidak	iot-cn-0pp1n8t****	ID instans. Anda dapat melihat ID instans pada halaman Overview di konsol IoT Platform. Penting Jika instans Anda memiliki ID, Anda harus mengonfigurasi parameter ini. Jika Anda tidak menyetel parameter ini, pemanggilan akan gagal. Jika instans Anda tidak memiliki halaman Overview atau ID, Anda tidak perlu menyetel parameter ini. Untuk informasi selengkapnya, lihat Overview.

Selain parameter permintaan spesifik operasi di atas, Anda harus menentukan parameter permintaan umum saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Parameter permintaan umum.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika panggilan gagal. Untuk informasi selengkapnya, lihat Error codes.
ErrorMessage	String	iot.system.SystemException	Pesan error yang dikembalikan jika panggilan gagal.
FailureTopics	List	["/2Fx7aWKW9****/FdeviceNameTest2/user/delete"]	Daftar topik yang dikembalikan jika panggilan gagal.
IsAllSucceed	Boolean	true	Menunjukkan apakah semua hubungan routing pesan antar topik telah dibuat. true: Semua hubungan routing pesan antar topik telah dibuat. false: Tidak semua hubungan routing pesan antar topik telah dibuat.
RequestId	String	FCC27691-9151-4B93-9622-9C90F30542EC	ID permintaan.
Success	Boolean	true	Menunjukkan apakah panggilan berhasil atau tidak. true: Panggilan berhasil. false: Panggilan gagal.

Contoh

Contoh permintaan

https://iot.cn-shanghai.aliyuncs.com/?Action=CreateTopicRouteTable
&SrcTopic=%2Fx7aWKW9****%2FtestDataToDataHub%2Fuser%2Fupdate
&DstTopic.1=%2Fx7aWKW9****%2FdeviceNameTest1%2Fuser%2Fadd
&DstTopic.2=%2Fx7aWKW9****%2FdeviceNameTest2%2Fuser%2Fdelete
&<Common request parameters>

Contoh respons sukses

XML format

<CreateTopicRouteTableResponse>
  <RequestId>32B9828A-25DD-48E2-8E26-D1664B341940</RequestId>
  <FailureTopics></FailureTopics>
  <Success>true</Success>
</CreateTopicRouteTableResponse>

JSON format

{
    "RequestId": "32B9828A-25DD-48E2-8E26-D1664B341940",
    "FailureTopics": {
        "Topic": []
    },
    "Success": true
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.