Compruebe varios dispositivos agregados a un producto de puerta de enlace en la nube de forma simultánea.
Notas de uso
La operación BatchCheckVehicleDevice es adecuada para escenarios en los que se requiere comprobar varios dispositivos agregados a un producto de puerta de enlace en la nube JT/T 808 o GB/T 32960 al mismo tiempo.
Límites de QPS
Puede invocar esta operación hasta 100 veces por segundo por cuenta.
Los usuarios RAM de una cuenta de Alibaba Cloud comparten la cuota de dicha cuenta.
Depuración
Parámetros de solicitud
Parámetro | Tipo | Obligatorio | Ejemplo | Descripción |
Action | String | Sí | BatchCheckVehicleDevice | La operación que desea ejecutar. Establezca el valor en BatchCheckVehicleDevice. |
IotInstanceId | String | Sí | iot-1n8t**** | El ID de la instancia. Consulte el ID de la instancia en la pestaña Descripción general de la consola de IoT Platform. Para obtener más información, consulte Descripción general. |
ProductKey | String | Sí | a1Bw**** | El ProductKey del producto al que pertenece el dispositivo. |
DeviceList.N.Manufacturer | String | No | mf0001 | El ID de fabricante del dispositivo. Si desea invocar la operación BatchCheckVehicleDevice para comprobar un dispositivo agregado a una puerta de enlace en la nube JT/T 808, configure este parámetro. El ID debe tener entre 4 y 11 caracteres de longitud, y puede contener letras, dígitos y guiones (-). Nota Puede especificar hasta 10,000 ID de fabricante de dispositivos en una sola invocación. Si la cantidad de ID de fabricante supera el límite, los ID excedentes se descartan. |
DeviceList.N.DeviceModel | String | No | dm0001 | El modelo del dispositivo. Si desea invocar la operación BatchCheckVehicleDevice para comprobar un dispositivo agregado a una puerta de enlace en la nube JT/T 808, configure este parámetro. El modelo del dispositivo debe tener entre 4 y 30 caracteres de longitud, y puede contener letras, dígitos y guiones (-). Nota Puede especificar hasta 10,000 modelos de dispositivos en una sola invocación. Si la cantidad de modelos supera el límite, los modelos excedentes se descartan. |
DeviceList.N.DeviceId | String | No | di0001 | El ID del dispositivo. Si desea invocar la operación BatchCheckVehicleDevice para comprobar un dispositivo agregado a una puerta de enlace en la nube JT/T 808, configure este parámetro. El ID debe tener entre 4 y 30 caracteres de longitud, y puede contener letras, dígitos y guiones (-). Nota Puede especificar hasta 10,000 ID de dispositivos en una sola invocación. Si la cantidad de ID supera el límite, los ID excedentes se descartan. |
DeviceList.N.DeviceName | String | No | vin0001 | El DeviceName del dispositivo. Si desea invocar la operación BatchCheckVehicleDevice para comprobar un dispositivo agregado a una puerta de enlace en la nube GB/T 32960, configure este parámetro. El DeviceName debe tener entre 1 y 17 caracteres de longitud, y puede contener letras y dígitos. Nota Puede especificar hasta 10,000 DeviceNames en una sola invocación. Si la cantidad de DeviceNames supera el límite, los DeviceNames excedentes se descartan. |
Además de los parámetros de solicitud específicos de la operación mencionados anteriormente, configure los parámetros de solicitud comunes al invocar esta operación. Para obtener más información sobre los parámetros de solicitud comunes, consulte Common parameters.
Parámetros de respuesta
Parámetro | Tipo | Ejemplo | Descripción |
Code | String | iot.system.SystemException | El código de error devuelto si la invocación falla. Para obtener más información, consulte la sección "Códigos de error" de este tema. |
Data | Struct | Los datos devueltos si la invocación es exitosa. Incluyen información sobre los dispositivos cuya verificación falló. | |
InvalidDetailList | Array of InvalidDetailList | Los detalles de los dispositivos no válidos devueltos. | |
DeviceId | String | di_*0001 | El ID del dispositivo de la puerta de enlace en la nube JT/T 808. |
DeviceModel | String | dm_*0001 | El modelo del dispositivo de la puerta de enlace en la nube JT/T 808. |
DeviceName | String | device_*0001 | El DeviceName del dispositivo de la puerta de enlace en la nube GB/T 32960. |
ErrorMsg | String | The device name is illegal. | El mensaje de error devuelto si falla la verificación del dispositivo. |
Manufacturer | String | mf_*0001 | El ID de fabricante del dispositivo de la puerta de enlace en la nube JT/T 808. |
InvalidDeviceIdList | List | { "InvalidDeviceIdList": [ "DEVIC^*$" ] } | Los ID de dispositivos de la puerta de enlace en la nube JT/T 808 no válidos devueltos si el sistema no logra comprobar los detalles de los dispositivos. |
InvalidDeviceModelList | List | { "InvalidDeviceModelList": [ "DEM$", "DE" ] } | Los modelos de dispositivos de la puerta de enlace en la nube JT/T 808 no válidos devueltos si el sistema no logra comprobar los detalles de los dispositivos. |
InvalidDeviceNameList | List | { "InvalidDeviceNameList": [ "APT$", "aw" ] } | Los DeviceNames de la puerta de enlace en la nube GB/T 32960 no válidos devueltos si el sistema no logra comprobar los detalles de los dispositivos. |
InvalidManufacturerList | List | { "InvalidManufacturerList": [ "manufacturer#&_", "aw" ] } | Los ID de fabricante de dispositivos de la puerta de enlace en la nube JT/T 808 no válidos devueltos si el sistema no logra comprobar los detalles de los dispositivos. |
RepeatedDeviceIdList | List | { "RepeatedDeviceIdList": [ "deviceId01", "deviceId02" ] } | Los ID de dispositivos de la puerta de enlace en la nube JT/T 808 duplicados devueltos si el sistema no logra comprobar los detalles de los dispositivos. |
RepeatedDeviceNameList | List | { "RepeatedDeviceNameList": [ "abcd", "asdf" ] } | Los ID de dispositivos de la puerta de enlace en la nube GB/T 32960 duplicados devueltos si el sistema no logra comprobar los detalles de los dispositivos. |
ErrorMessage | String | A system exception occurred. | El mensaje de error devuelto si la invocación falla. |
Success | Boolean | true | Indica si la invocación fue exitosa. Valores válidos:
|
RequestId | String | E4C0FF92-2A86-41DB-92D3-73B60310D25E | El ID de la solicitud. |
Ejemplos
Solicitudes de ejemplo
http(s)://iot.cn-shanghai.aliyuncs.com/?Action=BatchCheckVehicleDevice
&DeviceList.1.DeviceModel=dm0001
&DeviceList.1.Manufacturer=mf0001
&DeviceList.1.DeviceId=di0001
&ProductKey=a1BwAGV****
&IotInstanceId=iot-cv3********
&<Common request parameters>Respuestas exitosas de ejemplo
Formato XML
<BatchCheckVehicleDeviceResponse>
<RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
<Code></Code>
<Success>true</Success>
</BatchCheckVehicleDeviceResponse>Formato JSON
{
"RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
"Code": "",
"Success": true
}Código de error
|
HttpCode |
Código de error |
Mensaje de error |
Descripción |
|
400 |
iot.device.TooManyDeviceNamesPerRequest |
The devices you query exceed the maximum number. |
La cantidad de DeviceNames especificados en la solicitud supera el límite. |
|
400 |
iot.device.NoneDeviceNameElement |
The DeviceName list is empty. |
No se especificaron DeviceNames. |
|
400 |
iot.device.InvalidDeviceParams |
The request parameters are invalid. |
El valor del parámetro de solicitud no es válido. |
Para obtener una lista de códigos de error, consulte Códigos de error del servicio.