OnsGroupList - - Alibaba Cloud Dokümantasyon Merkezi

Not

Bu işlem bir tüketici grubu listesi döndürür ancak tüketici gruplarının ayrıntılı bilgilerini içermez.

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

Her Alibaba Cloud hesabı bu işlemi saniyede en fazla 10 kez çağırabilir. Bir saniye içinde bu işlem için gönderilen istek sayısı saniye başına sorgu (QPS) sınırını aşarsa kısıtlama uygulanır. Bu durum iş sürekliliğinizi kesintiye uğratabilir. Her işlemin QPS sınırı hakkında bilgi edinmek için bkz. API hız sınırları.

Yetkilendirme

Varsayılan olarak Alibaba Cloud hesapları bu işlemi çağırabilir. Resource Access Management (RAM) kullanıcısı yalnızca 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.

API	Action	Resource
OnsGroupList	mq:QueryInstanceBaseInfo	acs:mq:::{instanceId}

Not

Bu işlemi bir RAM kullanıcısının kimlik bilgilerini kullanarak çağırdığınızda, işlem yalnızca RAM kullanıcısına gerekli izinlerin verildiği tüketici gruplarıyla ilgili bilgileri döndürür. Erişmek istediğiniz tüketici grupları üzerinde RAM kullanıcısına gerekli izinleri vermek için Alibaba Cloud hesabınızla RAM konsolunda oturum açın. İzin verme hakkında bilgi için bkz.

İlkeler

.

İstek parametreleri

Parametre	Tür	Zorunlu	Örnek	Açıklama
Action	String	Evet	OnsGroupList	Gerçekleştirmek istediğiniz işlem. Değeri OnsGroupList olarak ayarlayın.
InstanceId	String	Evet	MQ_INST_111111111111_DOxxxxxx	Sorgulamak istediğiniz tüketici gruplarının ait olduğu Message Queue for Apache RocketMQ örneğinin ID'si.
GroupId	String	Hayır	GID_test_group_id	Bu parametre yalnızca bulanık sorgulama yöntemiyle belirli tüketici gruplarını sorgularken gereklidir. Bu parametre yapılandırılmazsa sistem mevcut hesabın erişebileceği tüm tüketici gruplarını sorgular. Bu parametreyi GID_ABC olarak ayarlarsanız ID'lerinde GID_ABC içeren tüketici gruplarıyla ilgili bilgiler döndürülür. Örneğin, GID_test_GID_ABC_123 ve GID_ABC_356 tüketici gruplarıyla ilgili bilgiler döndürülür.
GroupType	String	Hayır	tcp	Sorgulanacak tüketici gruplarının mesajları tükettiği protokol. Bir tüketici grubundaki tüm istemciler Message Queue for Apache RocketMQ broker ile aynı protokol üzerinden iletişim kurar. Bir tüketici grubu aynı anda hem TCP hem de HTTP istemcilerini içeremez. TCP istemcileri ve HTTP istemcileri için farklı tüketici grupları oluşturmanız gerekir. Geçerli değerler: tcp: Mesajların TCP üzerinden tüketildiği tüketici gruplarını belirtir. Bu varsayılan değerdir. http: Mesajların HTTP üzerinden tüketildiği tüketici gruplarını belirtir.
Tag.N.Key	String	Evet	CartService	Tüketici grubuna eklenen bir etiketin anahtarı. Bu parametre zorunlu değildir. Bu parametreyi yapılandırırsanız Tag.N.Value parametresini de yapılandırmanız gerekir. Etiketleri belirtirseniz sistem tüketici gruplarını belirtilen etiketlere göre filtreler. Etiketleri belirtmezseniz sistem mevcut hesabın erişebileceği tüm tüketici gruplarını sorgular. N için geçerli değerler: 1 ila 20. Parametre değeri boş bir dize olamaz. Değer en fazla 128 karakter uzunluğunda olabilir. Değer acs: veya aliyun ile başlayamaz, http:// veya https:// içermemelidir.
Tag.N.Value	String	Evet	ServiceA	Tag.N.Key parametresi tarafından belirtilen etiketin değeri. Bu parametre zorunlu değildir. Bu parametreyi yapılandırırsanız Tag.N.Value parametresini de yapılandırmanız gerekir. Etiketleri belirtirseniz sistem tüketici gruplarını belirtilen etiketlere göre filtreler. Etiketleri belirtmezseniz sistem mevcut hesabın erişebileceği tüm tüketici gruplarını sorgular. N için geçerli değerler: 1 ila 20. Parametre değeri boş bir dize olabilir. Değer en fazla 128 karakter uzunluğunda olabilir. Değer acs: veya aliyun ile başlayamaz, http:// veya https:// içermemelidir.

Yanıt parametreleri

Parametre	Tür	Örnek	Açıklama
RequestId	String	16996623-AC4A-43AF-9248-FD9D2D75****	İsteğin ID'si. Sistem her istek için benzersiz bir ID oluşturur. Sorunları istek ID'sine göre giderebilirsiniz.
Data	SubscribeInfoDo Dizisi		Döndürülen veriler.
SubscribeInfoDo
Owner	String	138015630679****	Tüketici grubunu oluşturan kullanıcının ID'si.
UpdateTime	Long	1570700979000	Tüketici grubunun en son güncellendiği zaman.
IndependentNaming	Boolean	true	Tüketici grubunun ait olduğu Message Queue for Apache RocketMQ örneği için bir ad alanı yapılandırılıp yapılandırılmadığını gösterir. Geçerli değerler: true: Örnek için ayrı bir ad alanı yapılandırılır. Her kaynağın adı örnek içinde benzersiz olmalıdır. Örnekler arası kaynaklar aynı adı kullanabilir. false: Örnek için ayrı bir ad alanı yapılandırılmaz. Her kaynağın adı tüm örnekler arasında benzersiz olmalıdır.
GroupId	String	GID_test_group_id	Tüketici grubunun ID'si.
Remark	String	test	Tüketici grubunun açıklaması.
CreateTime	Long	1568896605000	Tüketici grubunun oluşturulduğu zaman.
Tags	Tag Dizisi		Tüketici grubuna eklenen etiketler.
Tag
Key	String	CartService	Etiketin anahtarı.
Value	String	ServiceA	Etiketin değeri.
InstanceId	String	MQ_INST_111111111111_DOxxxxxx	Örneğin ID'si.
GroupType	String	tcp	Sorgulanacak tüketici gruplarının mesajları tükettiği protokol. Bir tüketici grubundaki tüm istemciler Message Queue for Apache RocketMQ broker ile aynı protokol üzerinden iletişim kurar. Bir tüketici grubu aynı anda hem TCP hem de HTTP istemcilerini içeremez. TCP istemcileri ve HTTP istemcileri için farklı tüketici grupları oluşturmanız gerekir. Geçerli değerler: tcp: Tüketici grubunun mesajları TCP üzerinden tükettiğini gösterir. http: Tüketici grubunun mesajları HTTP üzerinden tükettiğini gösterir.

Örnekler

Örnek istekler

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsGroupList
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Tag.1.Key=CartService
&Tag.1.Value=ServiceA
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

<OnsGroupListResponse>
<RequestId>16996623-AC4A-43AF-9248-FD9D2D75****</RequestId>
<Data>
    <SubscribeInfoDo>
        <Owner>138015630679****</Owner>
        <GroupType>tcp</GroupType>
        <InstanceId>MQ_INST_111111111111_DOxxxxxx</InstanceId>
        <CreateTime>1568896605000</CreateTime>
        <UpdateTime>1570700979000</UpdateTime>
        <IndependentNaming>true</IndependentNaming>
        <GroupId>GID_test_group_id</GroupId>
        <Remark>test</Remark>
        <Tags>
            <Tag>
                <Value>ServiceA</Value>
                <Key>CartService</Key>
            </Tag>
        </Tags>
    </SubscribeInfoDo>
</Data>
</OnsGroupListResponse>

JSON biçimi

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

{
  "RequestId" : "16996623-AC4A-43AF-9248-FD9D2D75****",
  "Data" : {
    "SubscribeInfoDo" : [ {
      "Owner" : "138015630679****",
      "GroupType" : "tcp",
      "InstanceId" : "MQ_INST_111111111111_DOxxxxxx",
      "CreateTime" : 1568896605000,
      "UpdateTime" : 1570700979000,
      "IndependentNaming" : true,
      "GroupId" : "GID_test_group_id",
      "Remark" : "test",
      "Tags" : {
        "Tag" : [ {
          "Value" : "ServiceA",
          "Key" : "CartService"
        } ]
      }
    } ]
  }
}

Hata kodları

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