Enregistre plusieurs appareils simultanément à l'aide d'un ID de demande.
Notes d'utilisation
Pour enregistrer plusieurs appareils en même temps, utilisez l'une des méthodes suivantes :
Appelez l'opération BatchRegisterDevice pour générer des DeviceNames aléatoires.
-
Appelez les opérations BatchRegisterDeviceWithApplyId et BatchCheckDeviceNames pour spécifier des DeviceNames personnalisés. Procédure :
Appelez l'opération BatchCheckDeviceNames et spécifiez les noms des appareils à enregistrer. Si les DeviceNames sont valides, IoT Platform renvoie un ID de demande via le paramètre ApplyId. Vous pouvez interroger les résultats de configuration des DeviceNames, les résultats d'enregistrement des appareils et les détails des appareils à l'aide du paramètre ApplyId.
Appelez l'opération QueryBatchRegisterDeviceStatus pour consulter le résultat de la configuration des noms.
Appelez l'opération BatchRegisterDeviceWithApplyId pour enregistrer plusieurs appareils. Le succès retourné par cette opération indique uniquement que la demande d'enregistrement par lot a été soumise. En pratique, le processus d'enregistrement prend quelques minutes.
(Facultatif) Appelez l'opération QueryBatchRegisterDeviceStatus pour consulter le résultat de l'enregistrement des appareils.
Appelez l'opération QueryPageByApplyId pour afficher les détails des appareils enregistrés par lot.
Limites QPS
Chaque compte Alibaba Cloud est limité à 500 requêtes par seconde (QPS).
Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota de ce compte.
Débogage
OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. 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 | BatchRegisterDeviceWithApplyId | Opération à effectuer. Définissez la valeur sur BatchRegisterDeviceWithApplyId. |
| ApplyId | Long | Yes | 1295006 | ID de la demande. L'opération BatchCheckDeviceNames renvoie cet ID. |
| ProductKey | String | Yes | a1BwAGV**** | ProductKey du produit auquel l'appareil appartient. |
| IotInstanceId | String | No | iot_instc_pu****_c*-v64******** | ID de l'instance. Vous pouvez afficher l'ID de l'instance sur la page Overview de la console IoT Platform. Important
Pour plus d'informations, consultez la rubrique Overview. |
En plus des paramètres de requête spécifiques à l'opération mentionné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. |
| Data | Struct | Données renvoyées en cas de succès de l'appel. Pour plus d'informations, consultez les paramètres suivants. |
|
| ApplyId | Long | 1295006 | ID de la demande. |
| ErrorMessage | String | A system exception occurred. | Message d'erreur renvoyé en cas d'échec de la requête. |
| RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | ID de la requête. |
| Success | Boolean | true | Indique si l'appel a réussi.
|
Exemples
Exemple de requête
https://iot.cn-shanghai.aliyuncs.com/?Action=BatchRegisterDeviceWithApplyId
&ProductKey=alNdd3i****
&ApplyId=1234567
&<Common request parameters>Exemple de réponse réussie
Format XML
<BatchRegisterDeviceWithApplyIdResponse>
<Data>
<ApplyId>1234567</ApplyId>
</Data>
<RequestId>82C16DC1-41B5-45F8-9AFD-1FB42448D405</RequestId>
<Success>true</Success>
</BatchRegisterDeviceWithApplyIdResponse>Format JSON
{
"Data": {
"ApplyId": 1234567
},
"RequestId": "82C16DC1-41B5-45F8-9AFD-1FB42448D405",
"Success": true
}Codes d'erreur
Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs de l'API.