CreateDeviceGroup - IoT Platform - Alibaba Cloud Documentation Center

Membuat grup perangkat.

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	Type	Required	Example	Description
Action	String	Yes	CreateDeviceGroup	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke CreateDeviceGroup.
GroupName	String	Yes	grouptest	Nama group. Alias harus terdiri dari 4 hingga 30 karakter, dan dapat berisi huruf, angka, serta garis bawah (_).
IotInstanceId	String	No	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.
SuperGroupId	String	No	SuperGroupId1	ID group induk. Jika Anda perlu membuat group tingkat pertama, jangan tentukan parameter ini.
GroupDesc	String	No	Group test	Deskripsi group. Deskripsi harus terdiri dari 1 hingga 100 karakter.

Selain parameter permintaan khusus operasi di atas, Anda harus menentukan parameter permintaan umum saat memanggil operasi ini. Untuk informasi selengkapnya, lihat Common request parameters.

Parameter respons

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Kode kesalahan yang dikembalikan jika pemanggilan gagal. Untuk informasi selengkapnya, lihat Error codes.
Data	Struct		Informasi group yang dikembalikan jika pemanggilan berhasil.
GroupDesc	String	Group test	Deskripsi setiap group.
GroupId	String	HtMLECKbdJQL****	ID group. ID ini merupakan ID Unik Global (GUID) yang dihasilkan sistem untuk group tersebut.
GroupName	String	grouptest	Nama group.
UtcCreate	String	2018-10-17T11:19:31.000Z	Waktu pembuatan group.
ErrorMessage	String	A system exception occurred.	Pesan kesalahan yang dikembalikan jika pemanggilan gagal.
RequestId	String	4D6D7F71-1C94-4160-8511-EFF4B8F0634D	ID permintaan.
Success	Boolean	true	Menunjukkan apakah pemanggilan berhasil. true: Pemanggilan berhasil. false: Pemanggilan gagal.

Contoh

Contoh permintaan

https://iot.cn-shanghai.aliyuncs.com/?Action=CreateDeviceGroup
&GroupDesc=Group test
&GroupName=grouptest
&<Common request parameters>

Contoh respons sukses

XML format

<CreateDeviceGroupResponse>
      <Data>
            <GroupDesc>Group test</GroupDesc>
            <GroupName>grouptest</GroupName>
            <UtcCreate>2018-10-17T11:19:31.000Z</UtcCreate>
            <GroupId>HtMLECKbdJQL****</GroupId>
      </Data>
      <RequestId>4D6D7F71-1C94-4160-8511-EFF4B8F0634D</RequestId>
      <Success>true</Success>
</CreateDeviceGroupResponse>

JSON format

{
    "Data":{
        "GroupDesc":"Group test",
        "GroupName":"grouptest",
        "UtcCreate":"2018-10-17T11:19:31.000Z",
        "GroupId":"HtMLECKbdJQL****"
    },
    "RequestId":"4D6D7F71-1C94-4160-8511-EFF4B8F0634D",
    "Success":true
}

Kode kesalahan

Untuk daftar kode kesalahan, kunjungi API Error Center.