クエリ APIリクエストを行う - Amazon Simple Queue Service

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

クエリ APIリクエストを行う

このセクションでは、 Amazon SQSエンドポイントを作成する方法、 GETおよびPOSTリクエストを行う方法、およびレスポンスを解釈する方法について説明します。

エンドポイントの構築

Amazon SQSキューを使用するには、エンドポイントを構築する必要があります。Amazon SQSエンドポイントの詳細については、「Amazon Web Services 全般リファレンス」の以下のページを参照してください。

Amazon SQSエンドポイントはそれぞれ独立しています。たとえば、2つのキューの名前が MyQueue で、一方にはエンドポイント sqs.us-east-2.amazonaws.comがあり、もう一方にはエンドポイントsqs.eu-west-2.amazonaws.comがある場合、2つのキューは互いにどのデータも共有しません。

キューを作成するリクエストを行うエンドポイントの例を次に示します。

https://sqs.eu-west-2.amazonaws.com/ ?Action=CreateQueue &DefaultVisibilityTimeout=40 &QueueName=MyQueue &Version=2012-11-05 &AUTHPARAMS
注記

キュー名とキュー URL は大文字と小文字が区別します。

AUTHPARAMSの構造はAPIリクエストの署名によって異なります。詳細については、「Amazon Web Services 一般リファレンス」のSigningAWSAPIリクエスト」を参照してください。

GETリクエストの作成

Amazon SQSのGETリクエストは、以下のような構成からなるURLとして構造化されます。

  • エンドポイント-リクエストが作用するリソース (キュー名と URL)。たとえば: https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue

  • アクション-エンドポイントに実行したい アクション。疑問符 (?) によってエンドポイントとアクションが区切られます。たとえば?Action=SendMessage&MessageBody=Your%20Message%20Textなど:

  • パラメーター-すべてのリクエストパラメーター。各パラメーターは、アンパサンド (&)で区切られます。たとえば &Version=2012-11-05&AUTHPARAMS:

メッセージを Amazon SQSキューに送信するGETリクエストの例を以下に示します。

https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue ?Action=SendMessage&MessageBody=Your%20message%20text &Version=2012-11-05 &AUTHPARAMS
注記

キュー URL とキュー名は大文字と小文字を区別します。

GETリクエストは URL なので、すべてのパラメータ値をURLエンコードする必要があります。URLにはスペースを使用できないため、各スペースは「%20」としてURLエンコードされます。(残りの例では、読みやすくするためURLエンコードされていません)。

POSTリクエストの作成

Amazon SQSのPOSTリクエストは、クエリパラメータを HTTPリクエストボディの形で送信します。

Content-Typeapplication/x-www-form-urlencodedに設定されたHTTPヘッダーの例を以下に示します。

POST /123456789012/MyQueue HTTP/1.1 Host: sqs.us-east-2.amazonaws.com Content-Type: application/x-www-form-urlencoded

ヘッダーの後には、メッセージをAmazon SQSキューに送信する form-urlencodedPOSTリクエストが続きます。各パラメータは、アンパサンド (&)で区切られています。

Action=SendMessage &MessageBody=Your+Message+Text &Expires=2020-10-15T12%3A00%3A00Z &Version=2012-11-05 &AUTHPARAMS
注記

Content-TypeHTTPヘッダーのみが必須です。AUTHPARAMSは、GETリクエストの場合と同じです。

HTTPクライアントは、クライアントのHTTP バージョンによっては、他の項目を HTTPリクエストに追加する可能性があります。