Amazon での設定リクエストの送信 CloudSearch

重要

設定リクエストを送信する最も簡単な方法は、Amazon CloudSearch コンソール、Amazon CloudSearch コマンドラインツール、または AWS SDK for Java、 JavaScript、、NETPHPRuby、Python (Boto) を使用することです。コマンドラインでは、署名プロセスがツールおよびSDKs処理され、Amazon CloudSearch 設定リクエストが適切に構成されていることを確認します。の詳細についてはSDKs、AWSAWS「 Software Development Kits」を参照してください。

クエリプロトコルを使用して、リージョンの Amazon CloudSearch エンドポイントに Amazon AWS CloudSearch 設定リクエストを送信します。現在サポートされているリージョンとエンドポイントのリストについては、「リージョンとエンドポイント」を参照してください。

AWS クエリリクエストは、 HTTPまたは Action という名前POSTのクエリパラメータを使用して HTTPGETを介して送信された または HTTPSリクエストです。すべての設定リクエストでAPIバージョンを指定する必要があります。そのバージョンは、ドメインの作成時に指定されたAPIバージョンと一致する必要があります。

すべてのリクエストに認証パラメータとデジタル署名を含める必要があります。​ Amazon CloudSearch はAWS署名バージョン 4 をサポートしています。署名手順の詳細については、 AWS全般のリファレンスの「署名 V4 署名プロセス」を参照してください。

注記

Amazon は、設定サービスへの過剰なリクエストを CloudSearch スロットリングします。スロットリングはアクション によって発生するため、過剰なDescribeDomainsリクエストによって Amazon がDescribeIndexFieldsリクエスト CloudSearch をスロットリングすることはありません。リクエストの制限はサービスのニーズによって変わりますが、1 時間当たりの各アクションに対する多数の呼び出しを許可します。

設定リクエストの構造

このリファレンスではURLs、Amazon CloudSearch 設定リクエストを として示しています。これはブラウザで直接使用できます。（GETリクエストは と表示されますがURLs、パラメータ値は読みやすくするためにエンコードされていません。 リクエストを送信するときは、パラメータ値をURLエンコードする必要があることに注意してください。） URL には 3 つの部分があります。

• エンドポイント — 処理対象のウェブサービスエントリポイント、cloudsearch.us-east-1.amazonaws.com。

• アクション - 実行する Amazon CloudSearch 設定アクション。アクションの詳細な一覧については、「アクション」を参照してください。

• パラメータ — 指定したアクションに必要なリクエストパラメータ。また、各クエリリクエストに、アクションの認証と選択を処理するための一般的なパラメータがいくつか含まれている必要もあります。詳細については、「リクエストの署名認証について」を参照してください。

Amazon CloudSearch 設定リクエストごとに Versionパラメータを指定する必要があります。現在の Amazon CloudSearch API バージョンは 2013-01-01 です。

例えば、次のGETリクエストは movies という名前の新しい検索ドメインを作成します。

https://cloudsearch.us-east-1.amazonaws.com
?Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2012-07-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
&X-Amz-Signature=c7600a00fea082dac002b247f9d6812f25195fbaf7f0a6fc4ce08a39666c6a10
3c8dcb

リクエストの署名認証について

設定に送信されたリクエストAPIは、AWSアクセスキーを使用して認証されます。すべてのリクエストに認証パラメータとデジタル署名を含める必要があります。​ Amazon CloudSearch はAWS署名バージョン 4 をサポートしています。署名手順の詳細については、 AWS全般のリファレンスの「署名 V4 署名プロセス」を参照してください。

注記

独自のAWSリクエストの署名を開始したばかりの場合は、 による署名のSDKs実装方法を確認してください。ほとんどの のソースAWSSDKsは https://github.com/aws で入手できます。

例えば、CreateDomain リクエストを作成する場合、次の情報が必要になります。

Region name: us-east-1
Service name: cloudsearch
API version: 2013-01-01
Date: 2014-03-12T21:41:29.094Z
Access key: AKIAIOSFODNN7EXAMPLE
Secret key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Action: CreateDomain
Action Parameters: DomainName=movies

CreateDomain リクエストの正規化されたクエリ文字列は次のようになります。

Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2012-07-12T21:41:29.094Z
&X-Amz-SignedHeaders=host

署名された最終リクエストは次のようになります:

https://cloudsearch.us-east-1.amazonaws.com
?Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2014-03-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
&X-Amz-Signature=c7600a00fea082dac002b247f9d6812f25195fbaf7f0a6fc4ce08a39666c6a10