All Products
Search
Document Center

Simple Message Queue (formerly MNS):PublishMessage

Last Updated:Mar 12, 2026

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.1

Ganti $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.

ParameterTypeRequiredDescription
MessageBodyStringYesKonten pesan.
MessageTagStringNoTag pesan.
MessageAttributesObjectYesJenis 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

ParameterTypeExampleDescription
MessageIdStringD273CD6A89564E54-1-15180395A19-20000\*\*\*\*Pengidentifikasi unik untuk pesan dalam topik tersebut.
MessageBodyMD5String3AC6DD36D2D6B7283F2F490A0975\*\*\*\*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 HTTPKode kesalahanPesan kesalahanDeskripsi
404TopicNotExistTopik yang Anda berikan tidak ada.Nama topik dalam URI permintaan tidak cocok dengan topik yang ada. Verifikasi nama topik tersebut.