Memublikasikan pesan ke topik tertentu. Setelah pesan dipublikasikan ke topik, Message Service (MNS) mendorong pesan tersebut ke titik akhir yang telah ditentukan.
Header permintaan
Operasi ini hanya menggunakan header permintaan umum dan tidak memiliki header permintaan spesifik operasi. Untuk informasi lebih lanjut, lihat Parameter Umum.
Sintaksis permintaan
POST /topics/$TopicName/messages HTTP/1.1
Sebelum memanggil operasi API ini untuk mengirim pesan, enkode badan pesan menggunakan Base64. Ini mencegah kesalahan tak terduga akibat karakter khusus.
Parameter permintaan
Parameter | Tipe | Diperlukan | Deskripsi |
MessageBody | String | Ya | Konten dari pesan. |
MessageTag | String | Tidak | Tag dari pesan. |
MessageAttributes | Object | Tidak | Atribut pesan. Jika Anda mendorong pesan ke server HTTP atau antrian, Anda tidak perlu menyetel parameter ini. |
Parameter respons
Parameter | Tipe | Contoh | Deskripsi |
MessageId | String | D273CD6A89564E54-1-15180395A19-20000**** | ID pesan. ID pesan bersifat unik dalam topik. |
MessageBodyMD5 | String | 3AC6DD36D2D6B7283F2F490A0975**** | Hash MD5 dari badan pesan. |
Contoh
Contoh Permintaan
POST /topics/MyTopic/messages HTTP/1.1
Host: 123456789098****.mns.cn-hangzhou.aliyuncs.com
Date: Tue, 08 Dec 2015 06:13:40 GMT
Content-Length:500
Content-Type:text/xml;charset=utf-8
Authorization: MNS 15B4D3461F177624****:aibzWu1iDEx9LwO56+kHgA3e****
x-mns-version: 2015-06-06
<?xml version="1.0" encoding="UTF-8"?>
<Message xmlns="http://mns.aliyuncs.com/doc/v1">
<MessageBody>hello topic</MessageBody>
</Message>Contoh Respons
HTTP/1.1 201 Created
Content-Length:120
Content-Type:text/xml;charset=utf-8
x-mns-request-id:56667514B2B71C9C1600****
x-mns-version:2015-06-06
<?xml version="1.0" encoding="utf-8"?>
<Message xmlns="http://mns.aliyuncs.com/doc/v1/">
<MessageId>D273CD6A89564E54-1-15180395A19-20000****</MessageId>
<MessageBodyMD5>3AC6DD36D2D6B7283F2F490A0975****</MessageBodyMD5>
</Message> Kode kesalahan
Kode kesalahan | Pesan kesalahan | Kode status HTTP |
TopicNotExist | Topik yang Anda berikan tidak ada. | 404 |