Bir gruptaki tüketicilerin abone olduğu konuları sorgular.
Not
Bu işlemi çağırarak bir gruptaki tüketicilerin abone olduğu konular hakkında bilgi alabilirsiniz. Belirtilen gruptaki tüm tüketiciler çevrimdışıysa herhangi bir konu döndürülmez.
İstek 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ı sınıra ulaşırsa yeni istekler başarısız olur. Bu durum iş sürekliliğinizi kesintiye uğratabilir. Her işlemin istek sınırı hakkında bilgi için bkz. API istek sınırları.
Yetkilendirme
Varsayılan olarak Alibaba Cloud hesapları bu işlemi çağırabilir. Bir 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. İzinlerin nasıl verileceği hakkında bilgi için bkz. İlkeler.
|
API |
Action |
ad alanı kullanan bir örnekteki Kaynak |
ad alanı kullanmayan bir örnekteki Kaynak |
|
OnsGroupSubDetail |
mq:QueryInstanceBaseInfo mq:QueryGroupSubDetail |
acs:mq:::{instanceId}%{groupId} |
acs:mq:::{groupId} |
İstek parametreleri
|
Parametre |
Tür |
Gerekli |
Örnek |
Açıklama |
|
Action |
String |
Evet |
OnsGroupSubDetail |
Gerçekleştirmek istediğiniz işlem. Değeri OnsGroupSubDetail olarak ayarlayın. |
|
InstanceId |
String |
Evet |
MQ_INST_111111111111_DOxxxxxx |
Sorgulamak istediğiniz tüketici grubunu içeren Message Queue for Apache RocketMQ örneğinin kimliği. |
|
GroupId |
String |
Evet |
GID_test_group_id |
Sorgulamak istediğiniz tüketici grubunun kimliği. |
Yanıt parametreleri
| Parametre | Tür | Örnek | Açıklama |
| RequestId | String | 3364E875-013B-442A-BC3C-C1A84DC6**** | İsteğin kimliği. Sistem her istek için benzersiz bir kimlik oluşturur. Sorunları istek kimliğine göre giderebilirsiniz. |
| Data | Object | Döndürülen veriler. |
|
| SubscriptionDataList | Array of SubscriptionDataList | Tüketici grubundaki tüketicilerin abone olduğu konular. Belirtilen gruptaki tüm tüketiciler çevrimdışıysa herhangi bir konu döndürülmez. |
|
| SubscriptionDataList | |||
| SubString | String | * | Tüketici grubundaki tüketicilerin konuya abone olma esasını oluşturan ifade. |
| Topic | String | test-mq_topic | Tüketici grubundaki tüketicilerin abone olduğu konunun adı. |
| GroupId | String | GID_test_group_id | Tüketici grubunun kimliği. |
| MessageModel | String | CLUSTERING | Tüketim modu. Geçerli değerler:
Tüketim modları hakkında daha fazla bilgi için bkz. Kümeleme tüketimi ve yayınlama tüketimi. |
| Online | Boolean | true | Gruptaki tüketicilerin çevrimiçi olup olmadığını gösterir. |
Örnekler
Örnek istekler
http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsGroupSubDetail
&GroupId=GID_test_group_id
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&<Common request parameters>
Örnek başarılı yanıt
XML biçimi
HTTP/1.1 200 OK
Content-Type:application/xml
<OnsGroupSubDetailResponse>
<Data>
<MessageModel>CLUSTERING</MessageModel>
<Online>true</Online>
<SubscriptionDataList>
<SubscriptionDataList>
<SubString>*</SubString>
<Topic>test-mq_topic</Topic>
</SubscriptionDataList>
</SubscriptionDataList>
<GroupId>GID_test_group_id</GroupId>
</Data>
<RequestId>3364E875-013B-442A-BC3C-C1A84DC6****</RequestId>
</OnsGroupSubDetailResponse>
JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"Data" : {
"MessageModel" : "CLUSTERING",
"Online" : true,
"SubscriptionDataList" : {
"SubscriptionDataList" : [ {
"SubString" : "*",
"Topic" : "test-mq_topic"
} ]
},
"GroupId" : "GID_test_group_id"
},
"RequestId" : "3364E875-013B-442A-BC3C-C1A84DC6****"
}
Hata kodları
Hata kodlarının listesi için API Hata Merkezi sayfasını ziyaret edin.
Konsolda bir tüketici grubunun abone olduğu konuları görüntüleme
Message Queue for Apache RocketMQ konsolunda bir gruptaki tüketicilerin abone olduğu konuları görüntüleyebilirsiniz. Daha fazla bilgi için bkz. Abonelikleri görüntüleme.