Tous les produits
Search

Ce produit

    IoT Platform:BatchCheckVehicleDevice

    Centre de documentation

    IoT Platform:BatchCheckVehicleDevice

    Dernière mise à jour :Aug 10, 2026

    Vérifie plusieurs appareils ajoutés simultanément à un produit de passerelle cloud.

    Notes d'utilisation

    L'opération BatchCheckVehicleDevice permet de vérifier simultanément plusieurs appareils ajoutés à un produit de passerelle cloud JT/T 808 ou GB/T 32960.

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

    Parameter

    Type

    Required

    Example

    Description

    Action

    String

    Yes

    BatchCheckVehicleDevice

    Opération à effectuer. Définissez la valeur sur BatchCheckVehicleDevice.

    IotInstanceId

    String

    Yes

    iot-1n8t****

    ID de l'instance. Vous pouvez consulter l'ID de l'instance dans l'onglet Overview de la console IoT Platform.

    Pour plus d'informations, consultez Overview.

    ProductKey

    String

    Yes

    a1Bw****

    ProductKey du produit auquel appartient l'appareil.

    DeviceList.N.Manufacturer

    String

    No

    mf0001

    ID de fabrication de l'appareil. Si vous souhaitez appeler l'opération BatchCheckVehicleDevice pour vérifier un appareil ajouté à une passerelle cloud JT/T 808, vous devez configurer ce paramètre.

    L'ID doit comporter entre 4 et 11 caractères et peut contenir des lettres, des chiffres et des traits d'union (-).

    Remarque

    Vous pouvez spécifier jusqu'à 10 000 ID de fabricant d'appareils dans un seul appel. Si le nombre d'ID de fabricant d'appareils dépasse la limite, les ID excédentaires sont ignorés.

    DeviceList.N.DeviceModel

    String

    No

    dm0001

    Modèle de l'appareil. Si vous souhaitez appeler l'opération BatchCheckVehicleDevice pour vérifier un appareil ajouté à une passerelle cloud JT/T 808, vous devez configurer ce paramètre.

    Le modèle d'appareil doit comporter entre 4 et 30 caractères et peut contenir des lettres, des chiffres et des traits d'union (-).

    Remarque

    Vous pouvez spécifier jusqu'à 10 000 modèles d'appareils dans un seul appel. Si le nombre de modèles d'appareils dépasse la limite, les modèles excédentaires sont ignorés.

    DeviceList.N.DeviceId

    String

    No

    di0001

    ID de l'appareil. Si vous souhaitez appeler l'opération BatchCheckVehicleDevice pour vérifier un appareil ajouté à une passerelle cloud JT/T 808, vous devez configurer ce paramètre.

    L'ID doit comporter entre 4 et 30 caractères et peut contenir des lettres, des chiffres et des traits d'union (-).

    Remarque

    Vous pouvez spécifier jusqu'à 10 000 ID d'appareils dans un seul appel. Si le nombre d'ID d'appareils dépasse la limite, les ID excédentaires sont ignorés.

    DeviceList.N.DeviceName

    String

    No

    vin0001

    DeviceName de l'appareil. Si vous souhaitez appeler l'opération BatchCheckVehicleDevice pour vérifier un appareil ajouté à une passerelle cloud GB/T 32960, vous devez configurer ce paramètre.

    Le DeviceName doit comporter entre 1 et 17 caractères et peut contenir des lettres et des chiffres.

    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.

    Outre les paramètres de requête spécifiques à l'opération mentionnés ci-dessus, vous devez configurer les paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations sur les paramètres de requête communs, consultez Common parameters.

    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 section « Codes d'erreur » de cette rubrique.

    Data

    Struct

    Données renvoyées en cas de succès de l'appel. Les données incluent les informations sur les appareils dont la vérification a échoué.

    InvalidDetailList

    Array of InvalidDetailList

    Détails des appareils non valides renvoyés.

    DeviceId

    String

    di_*0001

    ID de l'appareil de la passerelle cloud JT/T 808.

    DeviceModel

    String

    dm_*0001

    Modèle de l'appareil de la passerelle cloud JT/T 808.

    DeviceName

    String

    device_*0001

    DeviceName de l'appareil de la passerelle cloud GB/T 32960.

    ErrorMsg

    String

    The device name is illegal.

    Message d'erreur renvoyé si la vérification de l'appareil a échoué.

    Manufacturer

    String

    mf_*0001

    ID de fabricant de l'appareil de la passerelle cloud JT/T 808.

    InvalidDeviceIdList

    List

    { "InvalidDeviceIdList": [ "DEVIC^*$" ] }

    ID d'appareils de la passerelle cloud JT/T 808 non valides renvoyés si le système n'a pas pu vérifier les détails des appareils.

    InvalidDeviceModelList

    List

    { "InvalidDeviceModelList": [ "DEM$", "DE" ] }

    Modèles d'appareils de la passerelle cloud JT/T 808 non valides renvoyés si le système n'a pas pu vérifier les détails des appareils.

    InvalidDeviceNameList

    List

    { "InvalidDeviceNameList": [ "APT$", "aw" ] }

    DeviceNames de la passerelle cloud GB/T 32960 non valides renvoyés si le système n'a pas pu vérifier les détails des appareils.

    InvalidManufacturerList

    List

    { "InvalidManufacturerList": [ "manufacturer#&_", "aw" ] }

    ID de fabricants d'appareils de la passerelle cloud JT/T 808 non valides renvoyés si le système n'a pas pu vérifier les détails des appareils.

    RepeatedDeviceIdList

    List

    { "RepeatedDeviceIdList": [ "deviceId01", "deviceId02" ] }

    ID d'appareils de la passerelle cloud JT/T 808 en double renvoyés si le système n'a pas pu vérifier les détails des appareils.

    RepeatedDeviceNameList

    List

    { "RepeatedDeviceNameList": [ "abcd", "asdf" ] }

    ID d'appareils de la passerelle cloud GB/T 32960 en double renvoyés si le système n'a pas pu vérifier les détails des appareils.

    ErrorMessage

    String

    A system exception occurred.

    Message d'erreur renvoyé en cas d'échec de l'appel.

    Success

    Boolean

    true

    Indique si l'appel a réussi. Valeurs possibles :

    • true : L'appel a réussi.

    • false : L'appel a échoué.

    RequestId

    String

    E4C0FF92-2A86-41DB-92D3-73B60310D25E

    ID de la requête.

    Exemples

    Exemple de requête

    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>

    Exemple de réponse réussie

    XML format

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

    JSON format

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

    Code 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és 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.