QueryDeviceInfo - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Belirtilen cihazın temel bilgilerini sorgular. Bu bilgiler arasında cihaz ID'si, cihaz sertifikası ve takma ad yer alır.

Sınırlamalar

Her Alibaba Cloud hesabı saniyede en fazla 500 sorgu (QPS) gerçekleştirebilir.

Not

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

Hata Ayıklama

Alibaba Cloud, API kullanımını basitleştirmek için OpenAPI Explorer sağlar. OpenAPI Explorer imza değerini otomatik olarak hesaplar. Kolaylık sağlaması açısından bu işlemi OpenAPI Explorer içinde çağırmanızı öneririz. OpenAPI Explorer farklı SDK'lar için işlemin örnek kodunu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	QueryDeviceInfo	Gerçekleştirmek istediğiniz işlem. Değeri QueryDeviceInfo olarak ayarlayın.
IotInstanceId	String	Hayır	iot_instc_pu***_c-v64********	Örneğin ID'si. IoT Platform konsolundaki Overview sayfasında örnek IDsini görüntüleyebilirsiniz. Önemli Örneğinizin bir ID'si varsa bu parametreyi yapılandırmanız gerekir. Bu parametreyi ayarlamazsanız çağrı başarısız olur. Örneğinizde Overview sayfası veya ID yoksa bu parametreyi ayarlamanız gerekmez. Daha fazla bilgi için bkz. Overview.
ProductKey	String	Hayır	a1BwAGV****	Cihazın ait olduğu ürünün ProductKey değeri. Önemli Bu parametreyi belirtirseniz DeviceName parametresini de belirtmeniz gerekir.
DeviceName	String	Hayır	light	Cihazın DeviceName değeri. Önemli Bu parametreyi belirtirseniz ProductKey parametresini de belirtmeniz gerekir.
IotId	String	Hayır	Q7uOhVRdZRRlDnTLv****00100	Cihazın ID'si. Önemli Bu parametreyi belirtirseniz ProductKey veya DeviceName belirtmeniz gerekmez. IotId parametresi, cihazın genel olarak benzersiz tanımlayıcısını (GUID) belirtir; bu değer, ProductKey ve DeviceName kombinasyonuna karşılık gelir. Hem IotId hem de ProductKey ile DeviceName kombinasyonunu belirtirseniz IotId önceliklidir.

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. Ortak istek parametreleri.

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 cihaz bilgileri.
DeviceName	String	light	Cihazın DeviceName değeri.
DeviceSecret	String	mz2Canp4GB7qRVf1OYPNtRqB2anu****	Cihazın DeviceSecret değeri.
IotId	String	Q7uOhVRdZRRlDnTLv****00100	Cihazın ID'si. Bu ID, IoT Platform tarafından cihaza verilen benzersiz tanımlayıcıdır.
Nickname	String	detectors_in_beijing	Cihazın takma adı.
ProductKey	String	a1rYuVF****	Cihazın ait olduğu ürünün ProductKey değeri.
ErrorMessage	String	A system exception occurred.	Çağrı başarısız olursa döndürülen hata mesajı.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	İsteğin ID'si.
Success	Boolean	true	Çağrının başarılı olup olmadığını gösterir. true: Çağrı başarılı oldu. false: Çağrı başarısız oldu.

Örnekler

Örnek istekler

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceInfo
&ProductKey=a1rYuVF****
&DeviceName=light
&<Common request parameters>

Örnek başarılı yanıtlar

XML biçimi

<QueryDeviceInfoResponse>
  <RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
  <Data>
        <IotId>Q7uOhVRdZRRlDnTLv****00100</IotId>
        <DeviceSecret>mz2Canp4GB7qRVf1OYPNtRqB2anu****</DeviceSecret>
        <ProductKey>a1rYuVF****</ProductKey>
        <Nickname>detectors_in_beijing</Nickname>
        <DeviceName>light</DeviceName>
  </Data>
  <Success>true</Success>
</QueryDeviceInfoResponse>

JSON biçimi

{
    "RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
    "Data": {
        "IotId": "Q7uOhVRdZRRlDnTLv****00100",
        "DeviceSecret": "mz2Canp4GB7qRVf1OYPNtRqB2anu****",
        "ProductKey": "a1rYuVF****",
        "Nickname": "detectors_in_beijing",
        "DeviceName": "light"
    },
    "Success": true
}

Hata kodları

HttpCode	Hata kodu	Hata mesajı	Açıklama
200	Iot.common.QueryDeviceActionError	An error occurred while querying the device.	Sistem cihaz bilgilerini sorgulayamadığı için döndürülen hata mesajı.

Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.