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

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

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

重要

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

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

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

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

注記

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

設定リクエストの構造

このリファレンスは、ブラウザで直接使用できる URLsとして Amazon CloudSearch 設定リクエストを示しています。(GET リクエストは URL として示されますが、パラメータ値は読みやすくするためにエンコードされていない状態で表示されています。 リクエストを送信するときは、パラメータ値を 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 リクエストに対する署名を始めたばかりの場合は、SDK がどのように署名機能を実装しているか確認してみてください。AWS SDK のほとんどのソースは 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