BatchAddDeviceGroupRelations - IoT Platform - Centre de documentation Alibaba Cloud

Limites

Chaque compte Alibaba Cloud peut exécuter au maximum 500 requêtes par seconde (QPS).

Remarque

Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota du compte.

Débogage

Alibaba Cloud met à disposition OpenAPI Explorer pour simplifier l'utilisation des API. OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	BatchAddDeviceGroupRelations	L'opération à effectuer. Définissez la valeur sur BatchAddDeviceGroupRelations.
Device.N.DeviceName	String	Yes	ZHuPo6sZzv7pOzYh****	Les noms des appareils à ajouter. Spécifiez jusqu'à 200 appareils.
Device.N.ProductKey	String	Yes	a1kORrK****	Les ProductKeys des produits auxquels appartiennent les appareils. Spécifiez jusqu'à 200 ProductKeys.
GroupId	String	Yes	6VfhebLg5iUe****	L'identifiant global unique (GUID) du groupe.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	L'ID de l'instance. Consultez l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, spécifiez ce paramètre. Sinon, l'appel échoue. 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 Overview.

En plus des paramètres de requête spécifiques à l'opération mentionnés ci-dessus, spécifiez les paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations, consultez Paramètres de requête communs.

Paramètres de réponse

Parameter	Type	Example	Description
AlreadyRelatedGroupDeviceCount	Integer	0	Le nombre d'appareils déjà présents dans le groupe.
Code	String	iot.system.SystemException	Le code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Le message d'erreur renvoyé en cas d'échec de l'appel.
ExceedTenGroupDeviceCount	Integer	0	Le nombre d'appareils appartenant déjà à 10 groupes ou plus. Un appareil peut appartenir à un maximum de 10 groupes.
RequestId	String	671D0F8F-FDC7-4B12-93FA-336C079C965A	L'ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : L'appel a réussi. false : L'appel a échoué.
SuccessAddedDeviceCount	Integer	2	Le nombre d'appareils ajoutés avec succès au groupe.
ValidDeviceCount	Integer	2	Le nombre d'appareils valides spécifiés.

Exemples

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=BatchAddDeviceGroupRelations
&Device.1.DeviceName=ZHuPo6sZzv7pOzYh****
&Device.1.ProductKey=a1kORrK****
&Device.2.DeviceName=rB4V9PDW2FCPmwuf****
&Device.2.ProductKey=a1kORrK****
&GroupId=6VfhebLg5iUe****
&<Common request parameters>

Exemple de réponse en cas de succès

Format XML

<BatchAddDeviceGroupRelationsResponse>
      <SuccessAddedDeviceCount>2</SuccessAddedDeviceCount>
      <ExceedTenGroupDeviceCount>0</ExceedTenGroupDeviceCount>
      <ErrorMessage>2 devices have been added, and 0 devices failed to be added.</ErrorMessage>
      <ValidDeviceCount>2</ValidDeviceCount>
      <AlreadyRelatedGroupDeviceCount>0</AlreadyRelatedGroupDeviceCount>
      <RequestId>671D0F8F-FDC7-4B12-93FA-336C079C965A</RequestId>
      <Success>true</Success>
</BatchAddDeviceGroupRelationsResponse>

Format JSON

{
    "SuccessAddedDeviceCount":2,
    "ExceedTenGroupDeviceCount":0,
    "ErrorMessage":"2 devices have been added, and 0 devices failed to be added.",
    "ValidDeviceCount":2,
    "AlreadyRelatedGroupDeviceCount":0,
    "RequestId":"671D0F8F-FDC7-4B12-93FA-336C079C965A",
    "Success":true   
}

Codes d'erreur

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