BatchDeleteDeviceGroupRelations - IoT Platform - Centre de documentation Alibaba Cloud

Supprime plusieurs appareils d'un groupe spécifié. Cette opération supprime uniquement les associations entre les appareils et le groupe. Les appareils eux-mêmes ne sont pas supprimés.

Limites

Chaque compte Alibaba Cloud est limité à 50 requêtes par seconde (QPS).

Remarque

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

Débogage

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

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	BatchDeleteDeviceGroupRelations	Opération à effectuer. Définissez la valeur sur BatchDeleteDeviceGroupRelations.
Device.N.DeviceName	String	Oui	ZHuPo6sZzv7pOzYh****	Noms des appareils à supprimer. Vous pouvez spécifier jusqu'à 200 appareils.
Device.N.ProductKey	String	Oui	a1kORrK****	ProductKeys des produits auxquels appartiennent les appareils. Vous pouvez spécifier jusqu'à 200 ProductKeys.
GroupId	String	Oui	W16X8Tvdosec****	ID du groupe. Il s'agit de l'identifiant global unique (GUID) du groupe.
IotInstanceId	String	Non	iot_instc_pu***_c-v64********	ID de l'instance. Vous pouvez consulter l'ID de l'instance sur la page Aperçu de la console IoT Platform. Important Si votre instance possède un ID, vous devez configurer ce paramètre. À défaut, l'appel échoue. Si votre instance ne dispose ni de la page Aperçu ou ni d'ID, vous n'avez pas besoin de définir ce paramètre. Pour plus d'informations, consultez la rubrique Aperçu.

En plus des paramètres de requête spécifiques à l'opération mentionnés précédemment, vous devez spécifier les paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations, consultez la rubrique Paramètres de requête communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
AlreadyRelatedGroupDeviceCount	Integer	2	Nombre d'appareils présents dans le groupe.
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	8739385E-143F-4389-B900-B7DF9174CE0D	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é.
SuccessDeviceCount	Integer	2	Nombre d'appareils supprimés du groupe.
ValidDeviceCount	Integer	2	Nombre d'appareils valides spécifiés.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format XML

<BatchDeleteDeviceGroupRelationsResponse>
      <SuccessDeviceCount>2</SuccessDeviceCount>
      <ValidDeviceCount>2</ValidDeviceCount>
      <AlreadyRelatedGroupDeviceCount>2</AlreadyRelatedGroupDeviceCount>
      <RequestId>8739385E-143F-4389-B900-B7DF9174CE0D</RequestId>
      <Success>true</Success>
</BatchDeleteDeviceGroupRelationsResponse>

Format JSON

{
    "SuccessDeviceCount":2,
    "ValidDeviceCount":2,
    "AlreadyRelatedGroupDeviceCount":2,
    "RequestId":"8739385E-143F-4389-B900-B7DF9174CE0D",
    "Success":true    
}

Codes d'erreur

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