トピックにメッセージを公開します。メッセージが公開されると、Simple Message Queue (旧称:MNS) がそれを指定されたエンドポイントにプッシュします。
リクエスト構文
POST /topics/$TopicName/messages HTTP/1.1$TopicName は、対象のトピック名に置き換えてください。
リクエストヘッダー
この操作では共通のリクエストヘッダーのみを使用します。詳細については、「共通パラメーター」をご参照ください。
リクエストボディ
リクエストボディは、以下の要素を含む XML メッセージです。
| パラメーター | タイプ | 必須 | 説明 |
|---|---|---|---|
| MessageBody | String | はい | メッセージ本文。 |
| MessageTag | String | いいえ | メッセージタグ。 |
| MessageAttributes | Object | はい | プッシュエンドポイントタイプ。有効な値:HTTP(HTTP ゲートウェイ)および Queue(SMQ キューへのプッシュ)。 |
説明
XML 名前空間は http://mns.aliyuncs.com/doc/v1/ である必要があります。名前空間を省略または誤って指定したリクエストはエラーになります。
応答パラメーター
| パラメーター | タイプ | 例 | 説明 |
|---|---|---|---|
| MessageId | String | D273CD6A89564E54-1-15180395A19-20000\*\*\*\* | トピック内でのメッセージの一意な識別子。 |
| MessageBodyMD5 | String | 3AC6DD36D2D6B7283F2F490A0975\*\*\*\* | メッセージ本文の MD5 ハッシュ。ローカルで計算したハッシュ値と比較して、メッセージの整合性を検証します。 |
成功時の応答例
成功時の応答例
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>エラーコード
すべての操作に共通するエラーについては、「共通パラメーター」をご参照ください。
以下の表は、PublishMessage 操作に固有のエラーコードを示しています。
| HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
|---|---|---|---|
| 404 | TopicNotExist | The topic you provided does not exist. | リクエスト URI 内のトピック名が既存のトピックと一致しません。トピック名を確認してください。 |