指定されたトピックにメッセージをパブリッシュします。メッセージがトピックにパブリッシュされると、Message Service（MNS）は指定されたエンドポイントにメッセージをプッシュします。
リクエストヘッダー
この操作は共通リクエストヘッダーのみを使用し、操作固有のリクエストヘッダーはありません。詳細については、共通パラメーターをご参照ください。
リクエスト構文
POST /topics/$TopicName/messages HTTP/1.1
説明
この API 操作を呼び出してメッセージを送信する前に、Base64 を使用してメッセージ本文をエンコードします。これにより、特殊文字による予期しないエラーを防ぎます。
リクエストパラメーター
パラメーター | タイプ | 必須 | 説明 |
MessageBody | String | はい | メッセージの内容。 |
MessageTag | String | いいえ | メッセージのタグ。 |
MessageAttributes | Object | いいえ | メッセージ属性。 HTTP サーバーまたはキューにメッセージをプッシュする場合、このパラメーターを設定する必要はありません。 |
レスポンスパラメーター
パラメーター | タイプ | 例 | 説明 |
MessageId | String | D273CD6A89564E54-1-15180395A19-20000**** | メッセージの ID。メッセージ ID はトピック内で一意です。 |
MessageBodyMD5 | String | 3AC6DD36D2D6B7283F2F490A0975**** | メッセージ本文の MD5 ハッシュ。 |
例
リクエストの例
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>レスポンスの例
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> エラーコード
エラーコード | エラーメッセージ | HTTP ステータスコード |
TopicNotExist | 指定されたトピックが存在しません。 | 404 |