翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon CloudSearch で設定リクエストを送信
**重要**
設定リクエストを送信する最も簡単な方法は、Amazon CloudSearch コンソール、Amazon CloudSearch コマンドラインツール、または AWS SDK for Java、JavaScript、.NET、PHP、Ruby、Python (Boto) を使用することです。コマンドラインツールおよび SDK は、ユーザーの代わりに署名プロセスを処理し、Amazon CloudSearch 設定リクエストが適切な形式で作成されるようにします。AWS SDK の詳細については、「[AWS Software Development Kits (SDK)](https://aws.amazon.com/code)」を参照してください。
ユーザーは、AWS クエリプロトコルを使用して Amazon CloudSearch 設定リクエストを リージョンの Amazon CloudSearch エンドポイントに送信します。現在サポートされているリージョンとエンドポイントのリストについては、「[リージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html#cloudsearch_region)」を参照してください。
AWS クエリリクエストは、HTTP GET または POST 経由でアクションというクエリパラメータを使って送信される HTTP または HTTPS リクエストです。すべての設定リクエストで API バージョンを指定する必要があり、そのバージョンはドメインを作成したときに指定されたバージョンと一致している必要があります。
すべてのリクエストに認可パラメータとデジタル署名を含める必要があります。 Amazon CloudSearch は、AWS 署名バージョン 4 をサポートします。署名の詳細な手順については、AWS 全般リファレンスの「[署名 V4 の署名処理](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)」を参照してください。
**注記**
Amazon CloudSearch は構成サービスに対する過剰なリクエストを調整します。スロットリングは*アクションによって*発生するため、過剰な `DescribeDomains` リクエストによって Amazon CloudSearch が`DescribeIndexFields`リクエストを調整することはありません。リクエストの制限はサービスのニーズによって変わりますが、1 時間当たりの各アクションに対する多数の呼び出しを許可します。
## 設定リクエストの構造
このリファレンスはブラウザで直接使用できる URL として Amazon CloudSearch 設定リクエストを示しています。(GET リクエストは URL として示されますが、パラメータ値は読みやすくするためにエンコードされていない状態で表示されています。 リクエストを送信するときは、パラメータ値を URL エンコードする必要があることに注意してください)。URL は次の 3 つの部分を含みます:
+ エンドポイント — 処理対象のウェブサービスエントリポイント、`cloudsearch.us-east-1.amazonaws.com`。
+ アクション — 実行する Amazon CloudSearch 設定アクションです。アクションの詳細な一覧については、「[アクション](API_Operations.md)」を参照してください。
+ パラメータ — 指定したアクションに必要なリクエストパラメータ。また、各クエリリクエストに、アクションの認証と選択を処理するための一般的なパラメータがいくつか含まれている必要もあります。詳細については、「[リクエストの署名認証について](#configuration-request-authentication)」を参照してください。
どの 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 の署名処理](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html)」を参照してください。
**注記**
独自の AWS リクエストに対する署名を始めたばかりの場合は、SDK がどのように署名機能を実装しているか確認してみてください。AWS SDK のほとんどのソースは [https://github.com/aws](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
```