すべてのプロダクト
Search
ドキュメントセンター

Simple Message Queue (formerly MNS):PublishMessage

最終更新日:Mar 12, 2026

トピックにメッセージを公開します。メッセージが公開されると、Simple Message Queue (旧称:MNS) がそれを指定されたエンドポイントにプッシュします。

リクエスト構文

POST /topics/$TopicName/messages HTTP/1.1

$TopicName は、対象のトピック名に置き換えてください。

リクエストヘッダー

この操作では共通のリクエストヘッダーのみを使用します。詳細については、「共通パラメーター」をご参照ください。

リクエストボディ

リクエストボディは、以下の要素を含む XML メッセージです。

パラメータータイプ必須説明
MessageBodyStringはいメッセージ本文。
MessageTagStringいいえメッセージタグ。
MessageAttributesObjectはいプッシュエンドポイントタイプ。有効な値:HTTP(HTTP ゲートウェイ)および Queue(SMQ キューへのプッシュ)。
説明

XML 名前空間は http://mns.aliyuncs.com/doc/v1/ である必要があります。名前空間を省略または誤って指定したリクエストはエラーになります。

応答パラメーター

パラメータータイプ説明
MessageIdStringD273CD6A89564E54-1-15180395A19-20000\*\*\*\*トピック内でのメッセージの一意な識別子。
MessageBodyMD5String3AC6DD36D2D6B7283F2F490A0975\*\*\*\*メッセージ本文の 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 ステータスコードエラーコードエラーメッセージ説明
404TopicNotExistThe topic you provided does not exist.リクエスト URI 内のトピック名が既存のトピックと一致しません。トピック名を確認してください。