Tüm Ürünler
Search

Bu Ürün

    IoT Platform:BatchCheckImportDevice

    Belge Merkezi

    IoT Platform:BatchCheckImportDevice

    Son Güncelleme:Oct 03, 2026

    Standart Enterprise Edition örneğine veya MQTT cloud gateway ürününe aktarılan aygıtları toplu olarak doğrular.

    QPS limits

    Bu işlemi hesap başına saniyede en fazla 100 kez çağırabilirsiniz.

    Not

    Bir Alibaba Cloud hesabının RAM kullanıcıları, hesabın kotasını paylaşır.

    Debugging

    OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer üzerinden çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'lar için işlemin örnek kodunu dinamik olarak oluşturur.

    Request parameters

    Parameter

    Type

    Required

    Example

    Details
    Action String Yes BatchCheckImportDevice

    Gerçekleştirmek istediğiniz işlem. Değeri BatchCheckImportDevice olarak belirtin.

    ProductKey String Yes a1BwAGV****

    Aygıtların ait olduğu ürünün ProductKey değeri.

    DeviceList.N.DeviceName String Yes light

    Aygıtın DeviceName değeri.

    DeviceName 4 ila 32 karakter uzunluğunda olmalı ve harfler, rakamlar, tire (-), alt çizgi (_), at işareti (@), nokta (.) ile iki nokta üst üste (:) içerebilir.

    DeviceName, ürün içinde benzersiz olmalıdır.

    Not Tek bir çağrıda en fazla 10.000 DeviceName belirtebilirsiniz. DeviceName sayısı sınırı aşarsa fazladan gelenler dikkate alınmaz.
    DeviceList.N.DeviceSecret String Yes b4d43f7******10ba5e5

    Aygıtın DeviceSecret değeri.

    DeviceSecret 1 ila 32 karakter uzunluğunda olmalı ve harfler, rakamlar, tire (-), alt çizgi (_), at işareti (@), nokta (.) ile iki nokta üst üste (:) içerebilir.

    Not Tek bir çağrıda en fazla 10.000 DeviceSecret belirtebilirsiniz. DeviceSecret sayısı sınırı aşarsa fazladan gelenler dikkate alınmaz.
    DeviceList.N.Sn String No QC4******001

    Aygıtın seri numarası (SN).

    SN 1 ila 64 karakter uzunluğunda olmalı ve harfler, rakamlar ile alt çizgi (_) içerebilir.

    Not Tek bir çağrıda en fazla 10.000 SN belirtebilirsiniz. SN sayısı sınırı aşarsa fazladan gelenler dikkate alınmaz.
    IotInstanceId String No iot-1n8t****

    Örneğin ID değeri. ID bilgisini IoT Platform konsolundaki Overview sekmesinde bulabilirsiniz.

    Önemli
    • Örneğinizin bir ID değeri varsa bu parametre için ID belirtmeniz gerekir; aksi takdirde çağrı başarısız olur.
    • Örneğiniz için bir Overview sekmesi veya ID oluşturulmadıysa bu parametreyi yapılandırmanız gerekmez.

    Daha fazla bilgi için bkz. Instance overview.

    Yukarıdaki işleme özel istek parametrelerine ek olarak, bu işlemi çağırırken ortak istek parametrelerini de belirtmeniz gerekir. Daha fazla bilgi için bkz. Common parameters.

    Response parameters

    Parameter

    Type

    Example

    Details
    Code String iot.system.SystemException

    Çağrı başarısız olduğunda döndürülen hata kodu. Daha fazla bilgi için bkz. Error codes.

    Data Struct

    Çağrı başarılı olduğunda döndürülen veriler; doğrulama başarısız olan aygıtlara ilişkin bilgileri içerir.

    InvalidDetailList Array of InvalidDetailList

    Geçersiz aygıtlar.

    DeviceName String light%

    Aygıtın DeviceName değeri.

    DeviceSecret String ^67$

    Aygıtın gizli anahtarı.

    ErrorMsg String The device name is illegal.

    Çağrı başarısız olduğunda döndürülen hata mesajı.

    Sn String QC4001#

    Aygıtın SN değeri.

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

    Geçersiz DeviceName değerleri.

    InvalidDeviceSecretList List { "InvalidDeviceSecretList": [ "^67$", "1" ] }

    Geçersiz DeviceSecret değerleri.

    InvalidSnList List { "InvalidSnList": [ "" ] }

    Geçersiz aygıt SN değerleri.

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

    Yinelenen DeviceName değerleri.

    ErrorMessage String A system exception occurred.

    Çağrı başarısız olduğunda döndürülen hata mesajı.

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

    İsteğin ID değeri.

    Success Boolean true

    Çağrının başarılı olup olmadığını gösterir. Geçerli değerler:

    • true: Çağrı başarılı oldu.
    • false: Çağrı başarısız oldu.

    Examples

    Örnek istekler

    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>

    Başarılı yanıt örnekleri

    XML biçimi

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

    JSON biçimi

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

    Error codes


    HttpCode


    Error Code


    Error message


    Description
    400 iot.device.TooManyDeviceNamesPerRequest The devices you query exceed the maximum number. İstekte belirttiğiniz DeviceName sayısı sınırı aşıyor.
    400 iot.device.NoneDeviceNameElement The DeviceName list is empty. DeviceName belirtilmemiş.
    400 iot.device.InvalidDeviceParams The request parameters are invalid. İstek parametresinin değeri geçersiz.

    Hata kodlarının listesi için bkz. Service error codes.