Bir grubu siler.
Kullanım notları
Grubun kaynaklarını serbest bırakmanız gerektiğinde bu işlemi çağırarak bir grubu silebilirsiniz. Örneğin, bir uygulama yayından kaldırıldıktan sonra bu uygulama için kullanılan grupları silebilirsiniz.
Bir grubu sildikten sonra Message Queue for Apache RocketMQ arka ucu, söz konusu grubun kaynaklarını serbest bırakır. Kaynakların serbest bırakılması uzun sürebilir. Bu nedenle, bir grubu sildikten hemen sonra aynı ada sahip yeni bir grup oluşturmanızı önermiyoruz. Sistem belirtilen grubu silemezse hatayı hata koduna göre giderin.
Bir grubu sildikten sonra gruptaki tüketiciler mesaj almayı hemen durdurur. Bu işlemi çağırırken dikkatli olun.
İstek sınırı
Her Alibaba Cloud hesabı bu işlemi saniyede en fazla 10 kez çağırabilir. 1 saniye içinde gönderilen istek sayısı isteği sınırına ulaşırsa yeni istekler başarısız olur. Bu durum iş sürekliliğinizin kesintiye uğramasına neden olabilir. Her işlemin istek sınırı hakkında bilgi için bkz. API hız 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 |
ad alanı kullanan bir örnekteki kaynak |
ad alanı kullanmayan bir örnekteki kaynak |
|
OnsGroupDelete |
mq:QueryInstanceBaseInfo mq:DeleteGroup |
acs:mq:::{instanceId}%{groupId} |
acs:mq:::{groupId} |
İstek parametreleri
|
Parametre |
Tür |
Zorunlu |
Örnek |
Açıklama |
|
Action |
String |
Evet |
OnsGroupDelete |
Gerçekleştirmek istediğiniz işlem. Değeri OnsGroupDelete olarak ayarlayın. |
|
GroupId |
String |
Evet |
GID_test_groupId |
Silmek istediğiniz tüketici grubunun ID'si. |
|
InstanceId |
String |
Evet |
MQ_INST_111111111111_DOxxxxxx |
Belirtilen grubu içeren Message Queue for Apache RocketMQ örneğinin ID'si. |
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 giderebilirsiniz. |
Örnekler
Örnek istekler
http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsGroupDelete
&GroupId=GID_test_groupId
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&<Common request parameters>Başarılı yanıt örnekleri
XML biçimi
HTTP/1.1 200 OK
Content-Type:application/xml
<OnsGroupDeleteResponse>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsGroupDeleteResponse>JSON biçimi
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 bir grup silme
Bir grubu Message Queue for Apache RocketMQ konsolunda da silebilirsiniz. Daha fazla bilgi için bkz. Grupları yönetme.