Tüm Ürünler
Search

Bu Ürün

    :OnsGroupCreate

    Belge Merkezi

    :OnsGroupCreate

    Son Güncelleme:Oct 04, 2026

    Bir grup oluşturur.

    Kullanım notları

    Yeni bir uygulama yayınladığınızda veya yeni bir iş mantığı uyguladığınızda yeni gruplara ihtiyacınız olur. Bir grup oluşturmak için bu işlemi çağırabilirsiniz.

    İstek sınırı

    Her Alibaba Cloud hesabı bu işlemi saniyede en fazla 10 kez çağırabilir. 1 saniye içinde bu işlemi çağırmak için gönderdiğiniz istek sayısı sınıra ulaşırsa yeni istekler başarısız olur. Bu durum iş süreçlerinizi kesintiye uğratabilir. Her işlemin istek sınırı hakkında bilgi için bkz. API oran sınırları.

    Yetkilendirme

    Varsayılan olarak yalnızca Alibaba Cloud hesapları bu işlemi çağırabilir. Bir Resource Access Management (RAM) kullanıcısı, gerekli izinler verildikten sonra bu işlemi çağırabilir. Aşağıdaki tabloda, bir RAM kullanıcısının bu işlemi çağırabilmesi için verilmesi gereken izinler açıklanmaktadır. İzinlerin nasıl verileceği hakkında bilgi için bkz. İlkeler ve örnekler.

    API

    Action

    Resource

    OnsGroupCreate

    mq:QueryInstanceBaseInfo

    mq:CreateGroup

    acs:mq:::{instanceId}

    İstek parametreleri

    Parametre Tür Gerekli Örnek Açıklama
    Action String Evet OnsGroupCreate

    Gerçekleştirmek istediğiniz işlem. Değeri OnsGroupCreate olarak ayarlayın.

    GroupId String Evet GID_test_groupId

    Oluşturmak istediğiniz grubun ID'si. Grup ID'sini aşağıdaki kurallara göre belirtin:

    • ID 2 ila 64 karakter uzunluğunda olmalı ve yalnızca harf, rakam, tire (-) ve alt çizgi (_) içerebilir.
    • Grubu oluşturmak istediğiniz Message Queue for Apache RocketMQ örneği bir ad alanı kullanıyorsa grup ID'si örnek içinde benzersiz olmalıdır. Grup ID'si, örnekteki mevcut bir grup ID'si veya konu adıyla aynı olamaz. Grup ID'si, ad alanı kullanan başka bir örnekteki bir grup ID'si veya konu adıyla aynı olabilir. Örneğin, Örnek A ve Örnek B farklı ad alanları kullanıyorsa Örnek A'daki bir grup ID'si Örnek B'deki bir grup ID'si veya konu adıyla aynı olabilir.
    • Örnek bir ad alanı kullanmıyorsa grup ID'si tüm örnekler ve bölgeler genelinde genel olarak benzersiz olmalıdır. Grup ID'si, Alibaba Cloud hesabınızdaki Message Queue for Apache RocketMQ örneklerinde bulunan mevcut bir grup ID'si veya konu adıyla aynı olamaz.
    Not
    • Grup oluşturulduktan sonra grup ID'si değiştirilemez.
    • Bir örneğin ad alanı kullanıp kullanmadığını kontrol etmek için Message Queue for Apache RocketMQ konsoluna giriş yapın, Instance Details sayfasına gidin ve ardından Basic Information bölümündeki Namespace alanının değerini görüntüleyin.
    Remark String Hayır test

    Grubun açıklaması.

    InstanceId String Evet MQ_INST_111111111111_DOxxxxxx

    Grubu oluşturmak istediğiniz Message Queue for Apache RocketMQ örneğinin ID'si.

    GroupType String Hayır tcp

    Gruptaki istemcilerin Message Queue for Apache RocketMQ aracı sunucusuyla iletişim kurduğu protokol. Bir gruptaki tüm istemciler Message Queue for Apache RocketMQ aracı sunucusuyla aynı protokol üzerinden iletişim kurar. TCP istemcileri ve HTTP istemcileri için farklı gruplar oluşturmanız gerekir. Geçerli değerler:

    • tcp: Gruptaki istemciler mesajları TCP üzerinden yayınlar veya alır. Bu varsayılan değerdir.
    • http: Gruptaki istemciler mesajları HTTP üzerinden yayınlar veya alır.

    Yanıt parametreleri

    Parametre

    Tür

    Örnek

    Açıklama

    RequestId

    String

    A07E3902-B92E-44A6-B6C5-6AA111111****

    İsteğin ID'si. Sistem her istek için benzersiz bir ID oluşturur. Sorunları istek ID'sine göre gidermek mümkündür.

    Örnekler

    Örnek istekler

    http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsGroupCreate
&GroupId=GID_test_groupId
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Remark=test
&GroupType=tcp
&<Common request parameters>

    Başarılı örnek yanıtlar

    XML formatı

    HTTP/1.1 200 OK
Content-Type:application/xml

<OnsGroupCreateResponse>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsGroupCreateResponse>

    JSON formatı

    HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "A07E3902-B92E-44A6-B6C5-6AA111111****"
}

    Hata kodları

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

    Konsolda grup oluşturma

    Message Queue for Apache RocketMQ console üzerinden de bir grup oluşturabilirsiniz. Daha fazla bilgi için bkz. Grupları yönetme.