Simple Message Queue (formerly MNS):SendMessage

認証情報

デフォルトでは、Alibaba Cloud アカウントのみを使用してこのオペレーションを呼び出すことができます。 RAM ユーザーがこのオペレーションを呼び出すには、必要な権限を RAM ユーザーに付与する必要があります。次の表に、このオペレーションの認証情報を示します。 詳細については、「権限ポリシーと例」をご参照ください。

使用上の注意

• このオペレーションを呼び出して、キューにメッセージを送信できます。標準メッセージは、キューに送信された直後にコンシュー厶されます。メッセージがすぐにコンシュー厶されないようにするには、メッセージを送信するときに DelaySeconds パラメーターを指定します。 DelaySeconds パラメーターを 0 より大きい値に設定すると、メッセージがキューに送信された後、メッセージの初期ステータスは「遅延」になります。 DelaySeconds パラメーターで指定された期間が終了し、メッセージのステータスが「アクティブ」に変わるまで、メッセージはコンシュー厶されません。

• メッセージの DelaySeconds パラメーターの値が、キューの DelaySeconds パラメーターの値と異なる場合、メッセージの DelaySeconds パラメーターの値が有効になります。

• この API オペレーションを呼び出してメッセージを送信する前に、Base64 を使用してメッセージ本文をエンコードします。これは、特殊文字による予期しないエラーを防ぎます。

リクエスト

リクエストは、次の部分で構成されます。

• リクエスト行

  POST /queues/$queueName/messages HTTP/1.1

• オペレーション固有のリクエストヘッダー

  なし。

• リクエストボディ

  リクエストボディは XML 形式で、メッセージのパラメーターが含まれています。

  パラメーター	タイプ	必須	例	説明
  MessageBody	文字列	はい	This is a test message	メッセージの本文。
  DelaySeconds	整数	いいえ	60	キューに送信されたメッセージがコンシュー厶されるまでの遅延時間。 有効な値：0 ～ 604800。単位：秒。 デフォルト値：0。

レスポンス

レスポンスは、次の部分で構成されます。

• HTTP ステータスコード

  HTTP/1.1 201 Created

• オペレーション固有のレスポンスヘッダー

  なし。

• レスポンスボディ

  レスポンスボディは XML 形式です。メッセージの MessageId パラメーターと MessageBodyMD5 パラメーターが返されます。

  パラメーター	タイプ	例	説明
  MessageId	文字列	5F290C926D472878-2-14D9529A8FA-20000****	メッセージの ID。メッセージ ID は、キュー内で一意です。
  MessageBodyMD5	文字列	C5DD56A39F5F7BB8B3337C6D11B6****	メッセージ本文の MD5 ハッシュ。
  ReceiptHandle	文字列	1-ODU4OTkzNDU5My0xNDM1MTk3NjAwLTItNg==	遅延メッセージを受信した後に返された受信ハンドル。

例

リクエストの例

POST /queues/$queueName/messages HTTP/1.1
Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
Date: Wed, 18 Mar 2012 12:00:00 GMT
Content-Length:500
Content-Type:text/xml;charset=utf-8
x-mns-version: 2015-06-06
Authorization: MNS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEX****

<?xml version="1.0" encoding="UTF-8"?>
<Message xmlns="http://mns.aliyuncs.com/doc/v1/">
    <MessageBody>This is a test message</MessageBody>
    <DelaySeconds>60</DelaySeconds>
    <Priority>1</Priority>
</Message>            

レスポンスの例

HTTP/1.1 201 Created
Content-Length:120
Content-Type:text/xml;charset=utf-8
x-mns-request-id:512B2A634403E52B1956****
x-mns-version: 2015-06-06

<?xml version="1.0" encoding="UTF-8"?>
<Message xmlns="http://mns.aliyuncs.com/doc/v1/">
<MessageId>5F290C926D472878-2-14D9529****-200000001</MessageId>
<MessageBodyMD5>C5DD56A39F5F7BB8B3337C6D11B6****</MessageBodyMD5>
<ReceiptHandle>1-ODU4OTkzNDU5My0xNDM1MTk3NjAwLTItNg==</ReceiptHandle>
</Message>           

エラーコード