CreateDeviceGroup - IoT Platform - Centre de documentation Alibaba Cloud

Créez un groupe.

Limites

Chaque compte Alibaba Cloud peut exécuter un maximum de 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 à votre disposition OpenAPI Explorer pour simplifier l’utilisation des API. OpenAPI Explorer calcule automatiquement la valeur de la signature. Pour plus de commodité, nous vous recommandons d’appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer 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	CreateDeviceGroup	L’opération que vous souhaitez effectuer. Définissez la valeur sur CreateDeviceGroup.
GroupName	String	Oui	grouptest	Le nom du groupe. L’alias doit comporter entre 4 et 30 caractères et peut contenir des lettres, des chiffres et des traits de soulignement (_).
IotInstanceId	String	Non	iot_instc_pu***_c-v64********	L’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. Si vous ne définissez pas ce paramètre, l’appel échouera. Si votre instance ne possède pas de Aperçu ou d’ID, vous n’avez pas besoin de définir ce paramètre. Pour plus d’informations, consultez la rubrique Aperçu.
SuperGroupId	String	Non	SuperGroupId1	L’ID du groupe parent. Si vous devez créer un groupe de premier niveau, ne spécifiez pas ce paramètre.
GroupDesc	String	Non	Test de groupe	La description du groupe. La description doit comporter entre 1 et 100 caractères.

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 lorsque vous appelez 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
Code	String	iot.system.SystemException	Le code d’erreur renvoyé en cas d’échec de l’appel. Pour plus d’informations, consultez la rubrique Codes d’erreur.
Data	Struct		Les informations relatives au groupe renvoyées en cas de réussite de l’appel.
GroupDesc	String	Test de groupe	La description de chaque groupe.
GroupId	String	HtMLECKbdJQL****	L’ID du groupe. L’ID correspond à l’identifiant unique global (GUID) généré par le système pour le groupe.
GroupName	String	grouptest	Le nom du groupe.
UtcCreate	String	2018-10-17T11:19:31.000Z	L’heure de création du groupe.
ErrorMessage	String	Une exception système s’est produite.	Le message d’erreur renvoyé en cas d’échec de l’appel.
RequestId	String	4D6D7F71-1C94-4160-8511-EFF4B8F0634D	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é.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

Format XML

<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>

Format JSON

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

Codes d’erreur

Pour obtenir la liste des codes d’erreur, consultez le Centre d’erreurs API.