QueryDeviceGroupList - IoT Platform - Alibaba Cloud Documentation Center

Menampilkan daftar kelompok secara terpaginasi.

Batasan

Setiap Akun Alibaba Cloud dapat menjalankan maksimal 100 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	Type	Wajib	Contoh	Deskripsi
Action	String	Ya	QueryDeviceGroupList	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke QueryDeviceGroupList.
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 menetapkan parameter ini, pemanggilan akan gagal. Jika instans Anda tidak memiliki halaman Overview atau ID, Anda tidak perlu menetapkan parameter ini. Untuk informasi selengkapnya, lihat Overview.
PageSize	Integer	Tidak	10	Jumlah entri yang ditampilkan per halaman. Nilai maksimum: 200. Nilai default: 10.
SuperGroupId	String	Tidak	8vDubXr4nUvZkNgk9mle010200	ID kelompok induk. Jika Anda ingin menampilkan subkelompok dari suatu kelompok induk, tentukan parameter ini.
GroupName	String	Tidak	GroupName1	Nama kelompok. Jika Anda menentukan parameter ini, sistem akan menampilkan kelompok berdasarkan nama kelompok. Anda dapat melakukan pencarian fuzzy berdasarkan nama kelompok. Jika Anda tidak menentukan parameter ini, sistem akan menampilkan semua kelompok.
CurrentPage	Integer	Tidak	1	Nomor halaman yang ditampilkan. Nilai default: 1.
GroupTypes.N	RepeatList	Tidak	LINK_PLATFORM_DYNAMIC	Jenis kelompok yang akan di-query. Tetapkan nilainya ke LINK_PLATFORM_DYNAMIC. Nilai ini menunjukkan kelompok dinamis. Jika Anda tidak menentukan parameter ini, kelompok statis akan ditampilkan secara default.

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	Type	Contoh	Deskripsi
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika pemanggilan gagal. Untuk informasi selengkapnya, lihat Kode kesalahan.
CurrentPage	Integer	1	Nomor halaman yang dikembalikan.
Data	Array of GroupInfo		Informasi kelompok yang dikembalikan jika pemanggilan berhasil. Untuk informasi selengkapnya, lihat parameter GroupInfo. Catatan Informasi kelompok yang dikembalikan diurutkan secara menurun berdasarkan waktu pembuatan kelompok.
GroupInfo
GroupDesc	String	usefulGroup	Deskripsi kelompok.
GroupId	String	Kzt9FD8wje8o****	ID kelompok.
GroupName	String	test1	Nama kelompok.
GroupType	String	LINK_PLATFORM_DYNAMIC	Jenis kelompok.
UtcCreate	String	2018-10-09T02:58:34.000Z	Waktu pembuatan kelompok.
ErrorMessage	String	A system exception occurred.	Pesan kesalahan yang dikembalikan jika pemanggilan gagal.
PageCount	Integer	3	Jumlah total halaman.
PageSize	Integer	10	Jumlah entri yang dikembalikan per halaman.
RequestId	String	BEFCA316-D6C7-470C-81ED-1FF4FFD4AA0D	ID permintaan.
Success	Boolean	true	Menunjukkan apakah pemanggilan berhasil. true: Pemanggilan berhasil. false: Pemanggilan gagal.
Total	Integer	24	Jumlah total catatan yang dikembalikan.

Contoh

Contoh permintaan

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceGroupList
&PageSize=10
&CurrentPage=1
&GroupTypes.1=LINK_PLATFORM_DYNAMIC
&<Common request parameters>

Contoh respons sukses

XML format

<QueryDeviceGroupListResponse>
  <PageCount>3</PageCount>
  <Data>
        <GroupInfo>
              <GroupName>test1</GroupName>
              <UtcCreate>2021-10-01T02:58:34.000Z</UtcCreate>
              <GroupId>Kzt9FD8wje8o***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>test2</GroupName>
              <UtcCreate>2021-10-01T02:56:40.000Z</UtcCreate>
              <GroupId>0ayrSQ3DSd7***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupDesc>Test</GroupDesc>
              <GroupName>test3</GroupName>
              <UtcCreate>2021-10-01T05:38:27.000Z</UtcCreate>
              <GroupId>oWXlIQeFZtzC***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>ylv0915</GroupName>
              <UtcCreate>2021-10-01T04:51:56.000Z</UtcCreate>
              <GroupId>SfEiVapLPUjB***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>ydlv</GroupName>
              <UtcCreate>2021-10-01T14:35:51.000Z</UtcCreate>
              <GroupId>z2S2h9NsDTZm***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>ldh_group_3</GroupName>
              <UtcCreate>2021-10-01T12:26:20.000Z</UtcCreate>
              <GroupId>chn5fkjin***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupDesc>ddd</GroupDesc>
              <GroupName>ylvgisbim</GroupName>
              <UtcCreate>2021-10-01T11:41:20.000Z</UtcCreate>
              <GroupId>ncUZ8DjWYaB9***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>abc</GroupName>
              <UtcCreate>2021-10-01T09:14:30.000Z</UtcCreate>
              <GroupId>zpdvwxzBdt4F***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>test11</GroupName>
              <UtcCreate>2021-10-01T07:22:39.000Z</UtcCreate>
              <GroupId>BTaudF16X2xK***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>testy</GroupName>
              <UtcCreate>2021-10-01T01:58:06.000Z</UtcCreate>
              <GroupId>PrTm3VOeggPw***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
  </Data>
  <PageSize>10</PageSize>
  <RequestId>BEFCA316-D6C7-470C-81ED-1FF4FFD4AA0D</RequestId>
  <CurrentPage>1</CurrentPage>
  <Success>true</Success>
  <Total>24</Total>
</QueryDeviceGroupListResponse>

JSON format

{
    "PageCount":3,
    "Data":{
        "GroupInfo":[
            {
                "GroupName":"test1",
                "UtcCreate":"2021-10-01T02:58:34.000Z",
                "GroupId":"Kzt9FD8wje8o***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"test2",
                "UtcCreate":"2021-10-01T02:56:40.000Z",
                "GroupId":"0ayrSQ3DSd7***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupDesc":"Test",
                "GroupName":"test3",
                "UtcCreate":"2021-10-01T05:38:27.000Z",
                "GroupId":"oWXlIQeFZtzC***",
                "GroupType":"LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"ylv0915",
                "UtcCreate":"2021-10-01T04:51:56.000Z",
                "GroupId":"SfEiVapLPUjB***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"ydlv",
                "UtcCreate":"2021-10-01T14:35:51.000Z",
                "GroupId":"z2S2h9NsDTZm***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"ldh_group_3",
                "UtcCreate":"2021-10-01T12:26:20.000Z",
                "GroupId":"chn5fkjin***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupDesc":"ddd",
                "GroupName":"ylvgisbim",
                "UtcCreate":"2021-10-01T11:41:20.000Z",
                "GroupId":"ncUZ8DjWYaB9***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"abc",
                "UtcCreate":"2021-10-01T09:14:30.000Z",
                "GroupId":"zpdvwxzBdt4F***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"test11",
                "UtcCreate":"2021-10-01T07:22:39.000Z",
                "GroupId":"BTaudF16X2xK***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"testy",
                "UtcCreate":"2021-10-01T01:58:06.000Z",
                "GroupId":"PrTm3VOeggPw***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            }
        ]
    },
    "PageSize":10,
    "RequestId":"BEFCA316-D6C7-470C-81ED-1FF4FFD4AA0D",
    "CurrentPage":1,
    "Success":true,
    "Total":24
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.