SubscribeTopic - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

Kullanım notları

Cihazın IoT Platform'a bağlı ve çevrimiçi olması gerekir.
Her çağrı, tek bir cihazın konularına abonelik oluşturur. Çağrı başına en fazla 10 konu belirtebilirsiniz.

Saniye Başına Sorgu (QPS) sınırları

Her Alibaba Cloud hesabı bu işlemi saniyede en fazla 10 kez çağırabilir (QPS).

Not

RAM kullanıcıları, Alibaba Cloud hesabını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 içinde çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'ler için işlem örnek kodlarını dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	SubscribeTopic	Gerçekleştirmek istediğiniz işlem. Değeri SubscribeTopic olarak ayarlayın.
DeviceName	String	Evet	device1	Konunun ait olduğu cihazın DeviceName değeri.
ProductKey	String	Evet	a1Q5XoY***	Cihazın ait olduğu ürünün ProductKey değeri.
Topic.N	RepeatList	Evet	/a1Q5XoY***/device1/user/get	Abone olunacak konular. En fazla 10 konu belirtebilirsiniz. Konuların Subscribe veya Publish and Subscribe izinlerine sahip olması gerekir.
IotInstanceId	String	Hayır	iot-06***	Örnek kimliği. IoT Platform konsolundaki Overview sayfasında ID değerini görüntüleyebilirsiniz. Önemli Örneğinizin bir kimliği varsa bu parametreyi belirtmeniz gerekir. Aksi takdirde çağrı başarısız olur. Örneğiniz için bir Overview sayfası veya kimlik oluşturulmadıysa bu parametreyi belirtmeniz gerekmez. Daha fazla bilgi için bkz. Genel Bakış.

Yukarıda listelenen işleme özel istek parametrelerine ek olarak, 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	Hata kodu. Daha fazla bilgi için bkz. Hata kodları.
ErrorMessage	String	A system exception occurred.	Çağrı başarısız olursa döndürülen hata mesajı.
RequestId	String	BB71E443-4447-4024-A000-EDE09922891E	İstek kimliği.
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=SubscribeTopic
&DeviceName=device1
&ProductKey=a1Q5XoY***
&Topic.1=/a1Q5XoY***/device1/user/get
&Topic.2=/a1Q5XoY***/device1/user/add
&<Common request parameters>

Örnek başarılı yanıt

XML formatı

<SubscribeTopicResponse>
  <RequestId>32B9828A-25DD-48E2-8E26-D1664B341940</RequestId>
  <Success>true</Success>
</SubscribeTopicResponse>

JSON formatı

{
    "RequestId": "32B9828A-25DD-48E2-8E26-D1664B341940",
    "Success": true
}

Hata kodları

HttpCode	Error code	Error message	Description
500	Iot.MessageBroker.BatchSubTopicFailed	An error occurred while batch subscribing to the topic.	Toplu abonelik başarısız olduğu için döndürülen hata mesajı.
400	Iot.System.BillIsOverDue	Your account has overdue payments. Go to the expense center and add funds to your account.	Ödemesi gecikmiş faturalarınız olduğu için döndürülen hata mesajı. Hesap merkezine gidin ve hesabınıza bakiye ekleyin.
400	Iot.MessageBroker.EmptySubTopicList	The subscription topic list is empty.	Konu listesi boş olduğu için döndürülen hata mesajı.
400	Iot.Device.NotExistedDevice	The device does not exist.	Cihaz mevcut olmadığı veya etkinleştirilmediği için döndürülen hata mesajı.
403	Iot.Device.NotDeviceOwner	You are not the device owner.	Geçerli operatör cihazın sahibi olmadığı için döndürülen hata mesajı.
400	Iot.MessageBroker.TopicTemplateIsNotFound	The topic template does not exist.	Belirtilen şablon mevcut olmadığı için döndürülen hata mesajı.
400	iot.prod.NotExistedProduct	The specified product does not exist.	Belirtilen ürün mevcut olmadığı için döndürülen hata mesajı.
400	iot.device.InactiveDevice	The device is inactive.	Cihaz etkinleştirilmediği için döndürülen hata mesajı. Bu durum, cihazın IoT Platform'a hiç bağlanmadığını gösterir.

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