Memublikasikan pesan ke suatu topik. Setelah dipublikasikan, Simple Message Queue (formerly MNS) mendorong pesan tersebut ke titik akhir yang ditentukan.
Sintaksis permintaan
POST /topics/$TopicName/messages HTTP/1.1Ganti $TopicName dengan nama topik target.
Header permintaan
Operasi ini hanya menggunakan header permintaan umum. Untuk informasi selengkapnya, lihat Parameter umum.
Badan permintaan
Badan permintaan berupa pesan XML yang mencakup elemen-elemen berikut.
| Parameter | Type | Required | Description |
|---|---|---|---|
| MessageBody | String | Yes | Konten pesan. |
| MessageTag | String | No | Tag pesan. |
| MessageAttributes | Object | Yes | Jenis titik akhir dorong. Nilai yang valid: HTTP (HTTP gateway) dan Queue (dorong ke antrian SMQ). |
Catatan
Namespace XML harus berupa http://mns.aliyuncs.com/doc/v1/. Permintaan yang menghilangkan atau menggunakan namespace yang salah akan mengembalikan error.
Parameter respons
| Parameter | Type | Example | Description |
|---|---|---|---|
| MessageId | String | D273CD6A89564E54-1-15180395A19-20000\*\*\*\* | Pengidentifikasi unik untuk pesan dalam topik tersebut. |
| MessageBodyMD5 | String | 3AC6DD36D2D6B7283F2F490A0975\*\*\*\* | Hash MD5 dari badan pesan. Bandingkan nilai ini dengan hash yang dihitung secara lokal untuk memverifikasi integritas pesan. |
Contoh respons sukses
Contoh respons sukses
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
Untuk kesalahan umum pada semua operasi, lihat Parameter umum.
Tabel berikut mencantumkan kode kesalahan khusus untuk operasi PublishMessage.
| Kode status HTTP | Kode kesalahan | Pesan kesalahan | Deskripsi |
|---|---|---|---|
| 404 | TopicNotExist | Topik yang Anda berikan tidak ada. | Nama topik dalam URI permintaan tidak cocok dengan topik yang ada. Verifikasi nama topik tersebut. |