BatchImportDevice - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Cihazları bir MQTT ağ geçidi ürününe eklemeden önce bir MQTT ağ geçidi ve ilgili ürünü oluşturun, ardından ProductKey değerini alın. Daha fazla bilgi için bkz. MQTT ağ geçidi oluşturma.

Saniye başına sorgu (QPS) sınırları

Bu API işlemini hesap başına saniyede en fazla 10 kez çağırabilirsiniz.

Not

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

Hata ayıklama

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şlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	BatchImportDevice	Gerçekleştirmek istediğiniz işlem. Değeri BatchImportDevice olarak ayarlayın.
ProductKey	String	Evet	a1BwAGV****	Cihazın ait olduğu ürünün ProductKey değeri. ProductKey, IoT Platform'daki bir ürünün benzersiz tanımlayıcısıdır. Ürünleri IoT Platform konsolunda görüntüleyebilir veya QueryProductList işlemini çağırarak listeleyebilirsiniz.
DeviceList.N.DeviceName	String	Evet	device1	Cihazın DeviceName değeri. DeviceName 4 ila 32 karakter uzunluğunda olmalı ve harf, rakam, 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	Evet	b4d43f7******10ba5e5	Cihazın DeviceSecret değeri. DeviceSecret 1 ila 32 karakter uzunluğunda olmalı ve harf, rakam, 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	Hayır	QC4******001	Cihazın seri numarası (SN). SN 1 ila 64 karakter uzunluğunda olmalı ve harf, rakam 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	Hayır	iot-1n8t****	Örneğin ID değeri. Bu ID değerini IoT Platform konsolundaki Overview sayfasında 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 sayfası veya ID oluşturulmamışsa bu parametreyi yapılandırmanız gerekmez. Daha fazla bilgi için bkz. Overview.

Yukarıda listelenen işleme özel parametrelere ek olarak, bu işlemi çağırırken ortak istek parametrelerini de belirtmeniz gerekir. Daha fazla bilgi için bkz. Ortak parametreler.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
Code	String	iot.system.SystemException	Çağrı başarısız olursa döndürülen hata kodu. Daha fazla bilgi için bkz. Hata kodları.
Data	Struct		Çağrı başarılı olursa döndürülen veriler.
ApplyId	Long	1295006	Başarılı bir istek için oluşturulan uygulama kimliği (ApplyId).
InvalidDetailList	Array of InvalidDetailList		Çağrı başarısız olursa döndürülen geçersiz cihazların ayrıntıları.
InvalidDetailList
DeviceName	String	light%	Cihazın DeviceName değeri.
DeviceSecret	String	^67$	Cihazın DeviceSecret değeri.
ErrorMsg	String	The device name is illegal.	Çağrı başarısız olursa döndürülen hata mesajı.
Sn	String	QC4001#	Cihazın SN değeri.
InvalidDeviceNameList	List	{ "InvalidDeviceNameList": [ "APT$", "aw" ] }	Çağrı başarısız olursa döndürülen geçersiz cihazların DeviceName değerleri.
InvalidDeviceSecretList	List	{ "InvalidDeviceSecretList": [ "^67$", "1" ] }	Çağrı başarısız olursa döndürülen geçersiz cihazların DeviceSecret değerleri.
InvalidSnList	List	{ "InvalidSnList": [ "" ] }	Çağrı başarısız olursa döndürülen geçersiz cihazların SN değerleri.
RepeatedDeviceNameList	List	{ "RepeatedDeviceNameList": [ "abcd", "asdf" ] }	Çağrı başarısız olursa döndürülen yinelenen DeviceName değerleri.
ErrorMessage	String	A system exception occurred.	Çağrı başarısız olursa 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.

Açıklama

Örnek istekler

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=BatchImportDevice
&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

<BatchImportDeviceResponse>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <Data>
        <ApplyId>1295006</ApplyId>
  </Data>
  <Success>true</Success>
</BatchImportDeviceResponse>

JSON biçimi

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

Hata kodları

HttpCode	Hata kodu	Hata mesajı	Açıklama
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.ApplyManyDevicesFailed	An error occurred while creating multiple devices.	Sistem, aynı anda birden çok cihaz oluşturamadı.
400	iot.device.DeviceNumerExceedTenant	The device total number beyond limit.	Cihaz sayısı sınırı aşıyor.

Hata kodlarının listesi için bkz. Hizmet hata kodları.