Publishes a message to a specified topic. After the message is published to the topic, MNS pushes the message to the specified endpoints.
Request header
This operation uses only common request headers. For more information, see Common parameters.
Request syntax
POST /topics/$TopicName/messages HTTP/1.1
Request parameters
Parameter | Type | Required | Description |
---|---|---|---|
MessageBody | String | Yes | The content of the message. |
MessageTag | String | No | The tag of the message. |
MessageAttributes | Object | Yes | The endpoint to which messages are pushed.
Valid values:
|
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
MessageId | String | D273CD6A89564E54-1-15180395A19-20000**** | The ID of the message. The message ID is unique in the topic. |
MessageBodyMD5 | String | 3AC6DD36D2D6B7283F2F490A0975**** | The MD5 hash of the message body. |
Examples
Sample success responses
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>
Error codes
Error code | Error message | HTTP status code |
---|---|---|
TopicNotExist | The topic you provided does not exist. | 404 |