UpdateDeviceGroup - IoT Platform - Centre de documentation Alibaba Cloud

Limites

Chaque compte Alibaba Cloud peut appeler cette opération jusqu'à 50 fois par seconde (QPS).

Remarque

Les utilisateurs RAM partagent le quota du compte Alibaba Cloud.

Débogage

Alibaba Cloud met à votre disposition OpenAPI Explorer pour simplifier l'utilisation des API. Utilisez OpenAPI Explorer pour appeler cette opération et calculer automatiquement la valeur de signature. L'outil génère également des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	UpdateDeviceGroup	Opération à exécuter. Définissez la valeur sur UpdateDeviceGroup.
GroupId	String	Yes	W16X8Tvdosec****	ID du groupe, correspondant à son identifiant unique global (GUID).
IotInstanceId	String	No	iot_instc_pu***_c-v64********	ID de l'instance. Vous pouvez consulter l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez spécifier ce paramètre. Sinon, l'appel échouera. Si votre instance ne dispose pas de page Overview ou d'ID, il n'est pas nécessaire de définir ce paramètre. Pour plus d'informations, consultez la rubrique Overview.
GroupDesc	String	No	test2	Description du groupe. Elle doit contenir entre 1 et 100 caractères.
GroupType	String	No	LINK_PLATFORM_DYNAMIC	Type du groupe. Si vous définissez la valeur sur LINK_PLATFORM_DYNAMIC, le système interroge un groupe dynamique. Par défaut, si vous ne spécifiez pas ce paramètre, le système interroge un groupe statique.

Outre les paramètres de requête spécifiques à l'opération présentés ci-dessus, vous devez spécifier les paramètres de requête communs lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Paramètres de requête communs.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez la rubrique Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	B78B4FD1-AE89-417B-AD55-367EBB0C6759	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : Appel réussi. false : Échec de l'appel.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

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

Format JSON

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.