OnsGroupConsumerUpdate - - Alibaba Cloud Dokümantasyon Merkezi

Not

Belirtilen bir tüketici grubundaki tüketicilerin mesajları okuyup okuyamayacağını belirtmek için bu işlemi çağırabilirsiniz. Belirli bir gruptaki tüketicilerin mesaj okumasını engellemek istediğiniz senaryolarda bu işlemi kullanabilirsiniz.

İstek sınırı

Her Alibaba Cloud hesabı bu işlemi saniyede en fazla 10 kez çağırabilir. Bir saniye içinde 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 limiti 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, bu işlemi çağırmak için bir RAM kullanıcısına 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

OnsGroupConsumerUpdate

mq:QueryInstanceBaseInfo

mq:UpdateGroupConsumer

acs:mq:::{instanceId}%{groupId}

acs:mq:::{groupId}

İstek parametreleri

Parametre	Tür	Gerekli	Örnek	Açıklama
Action	String	Evet	OnsGroupConsumerUpdate	Gerçekleştirmek istediğiniz işlem. Değeri OnsGroupConsumerUpdate olarak ayarlayın.
GroupId	String	Evet	GID_test_groupId	Okuma izinlerini yapılandırmak istediğiniz tüketici grubunun ID'si.
ReadEnable	Boolean	Evet	true	Belirtilen tüketici grubuna mesaj okuma yetkisi verilip verilmeyeceğini belirtir. Geçerli değerler: true: Tüketici grubu mesajları okuyabilir. false: Tüketici grubu mesajları okuyamaz. Varsayılan değer: true.
InstanceId	String	Evet	MQ_INST_111111111111_DOxxxxxx	Belirtilen tüketici grubunu 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=OnsGroupConsumerUpdate
&GroupId=GID_test_groupId
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&ReadEnable=true
&<Common request parameters>

Başarılı yanıt örnekleri

XML biçimi

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

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

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 Hata Merkezi sayfasını ziyaret edin.