CreateProductTopic - IoT Platform - Alibaba Cloud Dokümantasyon Merkezi

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

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

Not

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 örnek kodu dinamik olarak oluşturur.

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	CreateProductTopic	Gerçekleştirmek istediğiniz işlem. Değeri CreateProductTopic olarak ayarlayın.
Operation	String	Evet	PUB	Cihazın özel konu kategorisindeki izinleri. Geçerli değerler: SUB: Abone ol. PUB: Yayınla. ALL: Yayınla ve Abone ol.
ProductKey	String	Evet	aldDEin****	Özel konu kategorisini oluşturmak istediğiniz ürünün ProductKey değeri.
TopicShortName	String	Evet	submit	Özel konu kategorisinin adı. Bir konu kategorisi birkaç alandan oluşur. Alanları eğik çizgiler (`/`) ile ayırın. Ad harf, rakam ve alt çizgi (_) içerebilir. Konu kategorisinin her seviye adı boş olamaz. Not Operation değerini SUB olarak ayarlarsanız cihazların aynı anda birden çok konuya abone olmasına olanak tanımak için konu kategorisi adında artı işareti (`+`) ve diyez işareti (`#`) joker karakterlerini belirtebilirsiniz. Joker karakterlerin kullanımı hakkında daha fazla bilgi için bkz. Joker karakterli özel konular. Bulut ağ geçidi ürünü kullanıyorsanız hiçbir ön ek otomatik olarak belirtilmez. Parametre için özel bir değer belirtmeniz gerekir. Bir DeviceName belirtmek için `${deviceName}` kullanabilirsiniz. Bulut ağ geçidi olmayan bir ürün kullanıyorsanız TopicShortName değerinin ön eki olarak `/${productKey}/${deviceName}/user/` otomatik olarak belirtilir. Yalnızca konu kategorisi için özel bir ad belirtmeniz gerekir.
IotInstanceId	String	Hayır	iot_instc_pu***_c-v64********	Örneğin ID'si. Örneğin ID'sini IoT Platform konsolundaki Overview sekmesinde görüntüleyebilirsiniz. Önemli Örneğinizin bir ID'si varsa bu parametre için ID'yi belirtmeniz gerekir. Aksi takdirde çağrı başarısız olur. Örneğinizin bir ID'si yoksa parametreyi yapılandırmanız gerekmez. Örnekler hakkında daha fazla bilgi için bkz. Overview.
Desc	String	Hayır	submit a test topic	Özel konu kategorisinin açıklaması. Açıklama en fazla 100 karakter uzunluğunda olabilir.
EnableProxySubscribe	Boolean	Hayır	false	Operation değerini SUB veya ALL olarak ayarlarsanız devredilmiş abonelik özelliğini etkinleştirebilirsiniz. Geçerli değerler: true: Devredilmiş abonelik özelliğini etkinleştirir. false: Devredilmiş abonelik özelliğini devre dışı bırakır. Bir konu için devredilmiş abonelik özelliğini etkinleştirirseniz IoT Platform konunun ayrıntılarını alır ve cihazı IoT Platform'a bağladığınızda cihazın konuya abone olmasına yardımcı olur.
Codec	String	Hayır	compress	Özel bir konu için veri sıkıştırma veya açma özelliğinin etkinleştirilip etkinleştirilmeyeceğini belirtir. Bu parametre yalnızca Standard veya Exclusive Enterprise Edition örneği kullanıyorsanız kullanılabilir. Geçerli değerler: compress: Veri sıkıştırmayı etkinleştirir. decompress: Veri açmayı etkinleştirir. Daha fazla bilgi için bkz. Veri sıkıştırma. Önemli TopicShortName için artı işareti (`+`) ve diyez işareti (`#`) dahil olmak üzere joker karakterler içeren bir değer belirtirseniz Codec yapılandıramazsınız. Joker karakterleri kullanarak bir konu kategorisi oluştururken veri sıkıştırma veya açma özelliği etkinleştirilirse çağrı başarısız olur.

Yukarıdaki işleme özgü istek parametrelerine ek olarak bu işlemi çağırırken ortak istek parametrelerini de yapılandırmanız gerekir. Ortak istek parametreleri hakkında 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ı.
ErrorMessage	String	A system exception occurred.	Çağrı başarısız olursa döndürülen hata mesajı.
RequestId	String	FCC27691-9151-4B93-9622-9C90F30542EC	İsteğin ID'si.
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.
TopicId	Long	10000	Özel konu kategorisinin ID'si. Çağrı başarılı olursa bu ID IoT Platform tarafından verilir. Not Özel konu kategorisi ID'sini gizli tutun. Özel konu kategorisiyle ilgili belirli işlemleri çağırırken özel konu kategorisi ID'si gereklidir.

Örnekler

Örnek istekler

https://iot.cn-shanghai.aliyuncs.com/?Action=CreateProductTopic
&ProductKey=aldDEin****
&TopicShortName=submit
&Operation=PUB
&Desc=submit a test topic
&<Common request parameters>

Örnek başarılı yanıt

XML biçimi

<CreateProductTopicResponse>
      <RequestId>FCC27691-9151-4B93-9622-9C90F30542EC</RequestId>
      <Success>true</Success>
      <TopicId>10000</TopicId>
</CreateProductTopicResponse>

JSON biçimi

{
    "RequestId":"FCC27691-9151-4B93-9622-9C90F30542EC",
    "Success":true,
    "TopicId":10000
}

Hata kodları

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