Belirtilen bir tüketiciye mesaj gönderir.
Not
Bu işlem, belirtilen bir konudaki mesajların belirtilen bir tüketici grubundaki tüketiciler tarafından tüketilip tüketilemeyeceğini kontrol etmek için kullanılabilir. İşlem, MsgId parametresiyle belirtilen mesajın gövdesini alır, mesaj gövdesini yeniden kapsülleyerek yeni bir mesaj oluşturur ve ardından bu yeni mesajı belirtilen bir tüketiciye gönderir. Tüketiciye gönderilen mesajın içeriği, orijinal mesajın içeriğiyle aynıdır. Farklı mesaj kimlikleri kullandıkları için bunlar aynı mesaj değildir.
İstek sınırı
Her Alibaba Cloud hesabı bu işlemi saniyede en fazla 10 kez çağırabilir. Bir saniye içinde bu işlemi çağırmak için gönderdiğiniz istek sayısı isteği sınırına 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, 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 |
|
OnsMessagePush |
mq:QueryInstanceBaseInfo mq:SUB |
acs:mq:::{instanceId}%{topic} |
acs:mq:::{topic} |
İstek parametreleri
|
Parametre |
Tür |
Gerekli |
Örnek |
Açıklama |
|
Action |
String |
Evet |
OnsMessagePush |
Gerçekleştirmek istediğiniz işlem. Değeri OnsMessagePush olarak ayarlayın. |
|
GroupId |
String |
Evet |
GID_test_group_id |
Tüketici grubunun ID'si. Tüketici grubunun ne olduğu hakkında bilgi için bkz. Terimler. |
|
ClientId |
String |
Evet |
30.5.121.**@24813#-1999745829#-1737591554#453111174894656 |
Tüketicinin ID'si. Bir tüketici grubundaki her tüketicinin ID'sini sorgulamak için OnsConsumerGetConnection işlemini çağırabilirsiniz. |
|
MsgId |
String |
Evet |
0BC1669963053CF68F733BB70396**** |
Mesajın ID'si. |
|
Topic |
String |
Evet |
test-mq_topic |
Mesajın gönderildiği konu. |
|
InstanceId |
String |
Evet |
MQ_INST_111111111111_DOxxxxxx |
Belirtilen tüketici grubunun ait olduğu Message Queue for Apache RocketMQ örneğinin ID'si. |
Yanıt parametreleri
|
Parametre |
Tür |
Örnek |
Açıklama |
|
RequestId |
String |
B8EDC90D-F726-4B9E-8BEF-F0DD25EC**** |
İ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-zhangjiakou.aliyuncs.com/?Action=OnsMessagePush
&GroupId=GID_test_group_id
&ClientId=30.5.121.**@24813#-1999745829#-1737591554#453111174894656
&MsgId=0BC1669963053CF68F733BB70396****
&Topic=test-mq_topic
&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
<OnsMessagePushResponse>
<RequestId>B8EDC90D-F726-4B9E-8BEF-F0DD25EC****</RequestId>
</OnsMessagePushResponse>JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "B8EDC90D-F726-4B9E-8BEF-F0DD25EC****"
}Hata kodları
Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.