Tüm Ürünler
Search

Bu Ürün

    IoT Platform:BatchPub

    Belge Merkezi

    IoT Platform:BatchPub

    Son Güncelleme:Oct 03, 2026

    Özel bir konu üzerinden bir ürünün birden fazla cihazına aynı anda mesaj gönderir.

    Kullanım notları

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

    Her hesap bu işlemi saniyede en fazla 50 kez çağırabilir.

    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'da çağırmanızı öneririz. OpenAPI Explorer, farklı SDK'ler için işlem örnek kodunu dinamik olarak oluşturur.

    İstek parametreleri

    Parameter

    Type

    Required

    Example

    Description
    Action String Yes BatchPub

    Gerçekleştirmek istediğiniz işlem. Değeri BatchPub olarak ayarlayın.
    DeviceName.N RepeatList Yes newdevice1

    Mesajı göndermek istediğiniz cihazın DeviceName değeri.

    Not

    • Bu parametre, ProductKey parametresi ile birlikte kullanılır. Belirtilen cihazlar aynı ürüne ait olmalıdır.

    • Tek bir istekte en fazla 100 cihaz adı belirtebilirsiniz. Her cihaz adı benzersiz olmalıdır.
    MessageContent String Yes eyJ0ZXN0IjoidGFzayBiYXRjaHB1YiBicm9hZGNhc3QifQ==

    Mesaj gövdesi. Maksimum boyut 256 KB'dir.

    Ham mesajı ikili verilere dönüştürün ve ardından Base64 kodlaması uygulayın.

    Not

    IoT Platform, verileri cihaza göndermeden önce Base64 kodlu verilerin kodunu çözer; bu nedenle cihazın kod çözme işlemi yapması gerekmez.
    ProductKey String Yes a1BwAGV****

    Cihazın ait olduğu ürünün ProductKey değeri.
    TopicShortName String Yes get

    Özel konunun son ekidir. Özel konu adı şu biçimi izler: /${productKey}/${deviceName}/user/${TopicShortName}. ${TopicShortName} son eki belirtir.

    Not

    Konunun Abone Ol (Subscribe) iznine veya Yayınlama ve Abone Olma (Publish and Subscribe) izinlerine sahip olması gerekir. Belirtilen tüm cihazların konuya abone olduğundan emin olun.

    Özel konuları aşağıdaki yöntemlerle görüntüleyebilirsiniz:

    • Ürün Ayrıntıları sayfasındaki Topic Categories sekmesinde ürünün özel konularını görüntüleyin.
    • Cihaz Ayrıntıları sayfasındaki Topic List sekmesinde cihazın abone olduğu özel konuları görüntüleyin.
    • Ürünün özel konularını sorgulamak için QueryProductTopic işlemini çağırın.
    IotInstanceId String No iot-cn-0pp1n8t****

    Örnek kimliği. IoT Platform konsolundaki Overview sayfasında ID değerini bulabilirsiniz.

    Önemli

    • Örneğinizin bir kimliği varsa bu parametreyi belirtmeniz gerekir. Aksi takdirde istek başarısız olur.
    • IoT Platform konsolunda Overview sayfası veya örnek kimliği görüntülenmiyorsa bu parametreyi belirtmeniz gerekmez.

    Daha fazla bilgi için bkz. Overview.
    Qos Integer No 0

    Mesajın hizmet kalitesi (QoS) düzeyi. Geçerli değerler:

    • 0: Mesaj en fazla bir kez gönderilir.
    • 1: Mesaj en az bir kez gönderilir.

    Varsayılan değer: 0.

    Not

    IoT Platform, QoS 1 mesajlarını en fazla yedi gün saklar. QoS 0 mesajları saklanmaz.

    İleme özgü istek parametrelerine ek olarak, bu işlemi çağırırken ortak istek parametrelerini de belirtmeniz gerekir. Daha fazla bilgi için bkz. Common parameters.

    Yanıt parametreleri

    Parameter

    Type

    Example

    Description
    Code String iot.system.SystemException

    İstek 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.

    İstek başarısız olursa döndürülen hata mesajı.
    RequestId String E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

    İstek kimliği.
    Success Boolean true

    İsteğin başarılı olup olmadığını gösterir. Geçerli değerler:

    • true
    • false

    Örnekler

    Örnek istekler

    http(s)://iot.cn-shanghai.aliyuncs.com/?Action=BatchPub
&DeviceName.1=newdevice1
&MessageContent=eyJ0ZXN0IjoidGFzayBiYXRjaHB1YiBicm9hZGNhc3QifQ==
&ProductKey=a1BwAGV****
&TopicShortName=get
&<Common request parameters>

    Örnek başarılı yanıtlar

    XML biçimi

    <BatchPubResponse>
  <RequestId>9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E</RequestId>
  <Success>true</Success>
</BatchPubResponse>

    JSON biçimi

    {
  "RequestId": "9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E",
  "Success": true
}

    Hata kodları

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