UpdateDeviceGroup - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Sınırlamalar

Her Alibaba Cloud hesabı bu işlemi saniyede en fazla 50 kez (QPS) çağırabilir.

Not

RAM kullanıcıları, Alibaba Cloud hesabının kotasını paylaşır.

Hata Ayıklama

Alibaba Cloud, API kullanımını basitleştirmek için OpenAPI Explorer sağlar. Bu işlemi OpenAPI Explorer içinde çağırarak imza değerini otomatik olarak hesaplayabilirsiniz. OpenAPI Explorer, farklı SDK'lar için örnek kodları dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	UpdateDeviceGroup	Gerçekleştirmek istediğiniz işlem. Değeri UpdateDeviceGroup olarak ayarlayın.
GroupId	String	Evet	W16X8Tvdosec****	Grubun genel benzersiz tanımlayıcısı (GUID) olan grup kimliği.
IotInstanceId	String	Hayır	iot_instc_pu***_c-v64********	Örnek kimliği. IoT Platform konsolundaki Overview sayfasında örnek ID değerini görüntüleyebilirsiniz. Önemli Örneğinizin bir kimliği varsa bu parametreyi belirtmeniz gerekir. Aksi takdirde çağrı başarısız olur. Örneğinizin bir Overview sayfası veya kimliği yoksa bu parametreyi ayarlamanız gerekmez. Daha fazla bilgi için bkz. Overview.
GroupDesc	String	Hayır	test2	Grubun açıklaması. Açıklama 1 ila 100 karakter uzunluğunda olabilir.
GroupType	String	Hayır	LINK_PLATFORM_DYNAMIC	Grubun türü. Değer LINK_PLATFORM_DYNAMIC olarak ayarlanırsa dinamik bir grup sorgulanır. Bu parametre belirtilmezse varsayılan olarak statik bir grup sorgulanır.

Yukarıdaki işleme özel istek parametrelerine ek olarak, bu işlemi çağırırken ortak istek parametrelerini de belirtmeniz gerekir. Daha fazla bilgi için bkz.Ortak istek parametreleri.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
Code	String	iot.system.SystemException	Çağrı başarısız olursa döndürülen hata kodu. Daha fazla bilgi için bkz.Hata kodları.
ErrorMessage	String	A system exception occurred.	Çağrı başarısız olursa döndürülen hata mesajı.
RequestId	String	B78B4FD1-AE89-417B-AD55-367EBB0C6759	İstek kimliği.
Success	Boolean	true	Çağrının başarılı olup olmadığını gösterir. true: Çağrı başarılı oldu. false: Çağrı başarısız oldu.

Örnekler

Örnek istekler

https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateDeviceGroup
&GroupId=W16X8Tvdosec****
&GroupDesc=test2
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

<UpdateDeviceGroupResponse>
      <RequestId>B78B4FD1-AE89-417B-AD55-367EBB0C6759</RequestId>
      <Success>true</Success>
</UpdateDeviceGroupResponse>

JSON biçimi

{
    "RequestId":"B78B4FD1-AE89-417B-AD55-367EBB0C6759",
    "Success":true
}

Hata kodları

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.