QueryDeviceSubTopic - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

QPS limits

Bu işlemi, Alibaba Cloud hesabı başına saniyede en fazla 100 kez çağırabilirsiniz.

Not

RAM kullanıcıları, Alibaba Cloud hesabını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'ler için işlemin örnek kodunu dinamik olarak oluşturur.

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	QueryDeviceSubTopic	Gerçekleştirmek istediğiniz işlem. Değeri QueryDeviceSubTopic olarak belirtin.
ProductKey	String	Yes	hf768****	Cihazın ait olduğu ürünün ProductKey değeri. Alibaba Cloud hesabınız altındaki tüm ürünleri IoT Platform konsolunda görüntüleyebilir veya QueryProductList işlemini çağırarak listeleyebilirsiniz.
DeviceName	String	Yes	device1	Cihazın adı. Cihaz bilgilerini IoT Platform konsolunda görüntüleyebilir veya QueryDeviceInfo işlemini çağırarak alabilirsiniz.
IotInstanceId	String	No	iot-cn-0pp1n8t****	Örnek kimliği (ID). Örnek kimliğini IoT Platform konsolundaki Overview sayfasında bulabilirsiniz. Önemli Örneğiniz bir kimliğe (ID) sahipse bu parametreyi belirtmeniz gerekir. Aksi takdirde çağrı başarısız olur. IoT Platform konsolunda Overview sayfası veya örnek kimliği (ID) görüntülenmiyorsa bu parametreyi atlayın. Daha fazla bilgi için bkz. 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	Description
Code	String	iot.system.SystemException	Çağrı başarısız olursa döndürülen hata kodu. Daha fazla bilgi için bkz. Error codes.
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	İstek kimliği (ID).
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.
TopicList	Array of topic		Cihazın abone olduğu konular. Yalnızca çağrı başarılı olduğunda döndürülür.
Timestamp	Long	1662039965873	Cihazın konuya abone olduğu zaman. Birim: milisaniye.
TopicName	String	/hf768****/device1/user/test	Konunun adı.

Examples

Örnek istekler

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

Örnek başarılı yanıt

XML biçimi

<QueryDeviceSubTopicResponse>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <TopicList>
        <Timestamp>1662039965873</Timestamp>
        <TopicName>/hf768****/device1/user/test</TopicName>
  </TopicList>
  <TopicList>
        <Timestamp>1662039965873</Timestamp>
        <TopicName>/hf768****/device1/user/down</TopicName>
  </TopicList>
  <Success>true</Success>
</QueryDeviceSubTopicResponse>

JSON biçimi

{
    "RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
    "TopicList": [
    {
        "Timestamp": 1662039965873,
        "TopicName": "/hf768****/device1/user/test"
    },
    {
        "Timestamp": 1662039965873,
        "TopicName": "/hf768****/device1/user/down"
    }
    ],
    "Success": true
}

Error codes

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