QueryDeviceGroupTagList - IoT Platform - Alibaba Cloud Documentation Center

Mengambil tag dari suatu grup.

Batasan

Setiap Akun Alibaba Cloud dapat menjalankan maksimal 500 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 kenyamanan 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	QueryDeviceGroupTagList	Operasi yang ingin Anda lakukan. Tetapkan nilai ke QueryDeviceGroupTagList.
GroupId	String	Ya	W16X8Tvdosec****	ID kelompok. ID tersebut merupakan globally unique identifier (GUID) untuk kelompok tersebut.
IotInstanceId	String	Tidak	iot_instc_pu***_c-v64********	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.
GroupType	String	Tidak	LINK_PLATFORM_DYNAMIC	Jenis kelompok. Jika Anda mengatur nilainya ke LINK_PLATFORM_DYNAMIC, kelompok dinamis akan diambil. Jika Anda tidak menentukan parameter ini, kelompok statis akan diambil secara default.

Selain parameter permintaan khusus 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.
Data	Array of GroupTagInfo		Informasi tag yang dikembalikan jika panggilan berhasil. Untuk informasi selengkapnya, lihat parameter GroupTagInfo berikut.
GroupTagInfo
TagKey	String	room1	Kunci dari tag tersebut.
TagValue	String	bulb	Nilai dari tag tersebut.
ErrorMessage	String	Terjadi kesalahan sistem.	Pesan error yang dikembalikan jika panggilan gagal.
RequestId	String	214154FF-9D47-4E3F-AAAD-F4CE67F41060	ID dari permintaan tersebut.
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=QueryDeviceGroupTagList
&GroupId=W16X8Tvdosec****
&<Common request parameters>

Contoh respons sukses

XML format

<QueryDeviceGroupTagListResponse>
      <Data>
            <GroupTagInfo>
                  <TagValue>bulb</TagValue>
                  <TagKey>room1</TagKey>
            </GroupTagInfo>
      </Data>
      <RequestId>214154FF-9D47-4E3F-AAAD-F4CE67F41060</RequestId>
      <Success>true</Success>
</QueryDeviceGroupTagListResponse>

JSON format

{
    "Data":{
        "GroupTagInfo":[
            {
                "TagValue":"bulb",
                "TagKey":"room1"
            }
        ]
    },
    "RequestId":"214154FF-9D47-4E3F-AAAD-F4CE67F41060",
    "Success":true
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.