BatchCheckImportDevice - IoT Platform - Centre de documentation Alibaba Cloud

Limites QPS

Vous pouvez appeler cette opération jusqu'à 100 fois par seconde par compte.

Remarque

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

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer, qui génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Details
Action	String	Yes	BatchCheckImportDevice	L'opération à effectuer. Définissez la valeur sur BatchCheckImportDevice.
ProductKey	String	Yes	a1BwAGV****	La ProductKey du produit auquel appartiennent les appareils.
DeviceList.N.DeviceName	String	Yes	light	Le DeviceName de l'appareil. Le DeviceName doit comporter entre 4 et 32 caractères et peut contenir des lettres, des chiffres, des traits d'union (-), des underscores (_), des signes at (@), des points (.) et deux-points (:). Le DeviceName doit être unique au sein du produit. Remarque Vous pouvez spécifier jusqu'à 10 000 DeviceNames dans un seul appel. Si le nombre de DeviceNames dépasse la limite, les DeviceNames excédentaires sont ignorés.
DeviceList.N.DeviceSecret	String	Yes	b4d43f7******10ba5e5	Le DeviceSecret de l'appareil. Le DeviceSecret doit comporter entre 1 et 32 caractères et peut contenir des lettres, des chiffres, des traits d'union (-), des underscores (_), des signes at (@), des points (.) et deux-points (:). Remarque Vous pouvez spécifier jusqu'à 10 000 DeviceSecrets dans un seul appel. Si le nombre de DeviceSecrets dépasse la limite, les DeviceSecrets excédentaires sont ignorés.
DeviceList.N.Sn	String	No	QC4******001	Le numéro de série (SN) de l'appareil. Le SN doit comporter entre 1 et 64 caractères et peut contenir des lettres, des chiffres et des underscores (_). Remarque Vous pouvez spécifier jusqu'à 10 000 SN dans un seul appel. Si le nombre de SN dépasse la limite, les SN excédentaires sont ignorés.
IotInstanceId	String	No	iot-1n8t****	L'ID de l'instance. Vous trouverez l'ID sur l'onglet Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez le spécifier pour ce paramètre. Sinon, l'appel échouera. Si aucun onglet Overview ni ID n'est généré pour votre instance, vous n'avez pas besoin de configurer ce paramètre. Pour plus d'informations, consultez Présentation des instances.

Outre les 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 Paramètres communs.

Paramètres de réponse

Parameter	Type	Example	Details
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.
Data	Struct		Les données renvoyées en cas de réussite de l'appel, y compris les informations sur les appareils dont la vérification a échoué.
InvalidDetailList	Array of InvalidDetailList		Les appareils non valides.
DeviceName	String	light%	Le DeviceName de l'appareil.
DeviceSecret	String	^67$	Le secret de l'appareil.
ErrorMsg	String	The device name is illegal.	Le message d'erreur renvoyé en cas d'échec de l'appel.
Sn	String	QC4001#	Le SN de l'appareil.
InvalidDeviceNameList	List	{ "InvalidDeviceNameList": [ "APT$", "aw" ] }	Les DeviceNames non valides.
InvalidDeviceSecretList	List	{ "InvalidDeviceSecretList": [ "^67$", "1" ] }	Les DeviceSecrets non valides.
InvalidSnList	List	{ "InvalidSnList": [ "" ] }	Les SN d'appareil non valides.
RepeatedDeviceNameList	List	{ "RepeatedDeviceNameList": [ "abcd", "asdf" ] }	Les DeviceNames en double.
ErrorMessage	String	A system exception occurred.	Le message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	E4C0FF92-2A86-41DB-92D3-73B60310D25E	L'ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. Valeurs possibles : true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemples de requêtes

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=BatchCheckImportDevice
&DeviceList.1.DeviceName=device1
&DeviceList.2.DeviceName=device2
&DeviceList.1.DeviceSecret=b4d43f7******10ba5e5
&DeviceList.2.DeviceSecret=912179******700210b4
&ProductKey=a1BwAGV****
&IotInstanceId=iot-1n8t****
&<Common request parameters>

Exemples de réponses réussies

XML format

<BatchCheckImportDeviceResponse>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <Success>true</Success>
</BatchCheckImportDeviceResponse>

JSON format

{
    "RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
    "Success": true
}

Codes d'erreur

|
**HttpCode**
|
**Error Code**
|
**Error message**
|
**Description**
| | --- | --- | --- | --- | | 400 | iot.device.TooManyDeviceNamesPerRequest | The devices you query exceed the maximum number. | Le nombre de DeviceNames que vous avez spécifié dans la requête dépasse la limite. | | 400 | iot.device.NoneDeviceNameElement | The DeviceName list is empty. | Aucun DeviceName n'est spécifié. | | 400 | iot.device.InvalidDeviceParams | The request parameters are invalid. | La valeur du paramètre de requête n'est pas valide. |

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.