BatchRegisterDevice - IoT Platform - Centre de documentation Alibaba Cloud

Enregistre plusieurs appareils pour un produit. Les DeviceNames de ces appareils sont générés aléatoirement.

Notes d'utilisation

Utilisez l'une des méthodes suivantes pour enregistrer plusieurs appareils :

Pour générer des DeviceNames aléatoires, appelez l'opération BatchRegisterDevice.

Procédez comme suit pour enregistrer les appareils et consulter le résultat :

1. Appelez l'opération BatchRegisterDevice pour enregistrer plusieurs appareils. Une réponse positive indique que la demande d'enregistrement a été soumise. L'enregistrement effectif est asynchrone et prend quelques minutes.

2. Appelez l'opération QueryBatchRegisterDeviceStatus pour interroger le statut d'enregistrement des appareils.

3. Appelez l'opération QueryPageByApplyId pour afficher les détails des appareils enregistrés, notamment les paramètres DeviceName, DeviceSecret et IotId.
Pour spécifier des DeviceNames personnalisés, appelez l'opération BatchRegisterDeviceWithApplyId. Pour plus d'informations, consultez BatchRegisterDeviceWithApplyId .

Limites

Vous pouvez créer jusqu'à 10 000 appareils par appel.
Chaque compte Alibaba Cloud est limité à 10 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 signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il 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	BatchRegisterDevice	Opération à effectuer. Définissez la valeur sur BatchRegisterDevice.
Count	Integer	Oui	100	Nombre d'appareils à enregistrer. Remarque Vous pouvez enregistrer jusqu'à 10 000 appareils par appel.
ProductKey	String	Oui	a1BwAGV****	ProductKey du produit auquel appartiennent les appareils.
IotInstanceId	String	Non	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 configurer ce paramètre, sinon l'appel échoue. Si votre instance ne possède pas de page Overview ou d'ID, ce paramètre est facultatif. Pour plus d'informations, consultez Overview.

Outre les paramètres spécifiques à l'opération, vous devez inclure les paramètres de requête communs lors de l'appel. Pour plus d'informations, consultez Paramètres de requête communs .

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez Codes d'erreur.
Data	Struct		Données renvoyées en cas de succès de l'appel.
ApplyId	Long	1295006	ID de demande (ApplyId) renvoyé en cas de succès de l'appel.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	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

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=BatchRegisterDevice
&ProductKey=a1BwAGV****
&Count=10
&<Common request parameters>

Exemple de réponse réussie

Format XML

<BatchRegisterDeviceResponse>
  <Data>
        <ApplyId>12345678</ApplyId>
  </Data>
  <RequestId>92C67DC1-41B5-45F8-9AFD-1FB42448D405</RequestId>
  <Success>true</Success>
</BatchRegisterDeviceResponse>

Format JSON

{
    "Data": {
        "ApplyId": 12345678
    },
    "RequestId": "92C67DC1-41B5-45F8-9AFD-1FB42448D405",
    "Success": true
}

Codes d'erreur

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