翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon CloudSearch ドメインの作成
Amazon CloudSearch でデータを検索するために、最初に必要なことは検索ドメインを作成することです。検索可能にするデータのコレクションが複数ある場合は、複数の検索ドメインを作成できます。新しいドメインに[検索リクエストを送信する](searching.md)前に、[アクセスポリシーの設定](configuring-access.md)、[インデックスフィールドの設定](configuring-index-fields.md)、および[検索対象データのアップロード](uploading-data.md)も行う必要があります。
検索ドメインを作成する場合、検索ドメインに一意の名前を付ける必要があります。ドメイン名は、3 文字以上、28 文字以内で、先頭は英字または数字にする必要があります。使用できる文字は、a～z、0～9、およびハイフン (-) です。大文字、下線 (\$1)、およびその他の特殊文字は、ドメイン名には使用できません。
デフォルトでは、すべての新しいドメインは 2013-01-01 API バージョンを使用して作成されます。2011-02-01 API バージョンを使用して、以前に検索ドメインを作成していた場合は、新しいドメインに古い API を使用することもできます。ただし、まったく新しいユースケースでは、2013-01-01 API を使用することをお勧めします。2011-02-01 API が使用中止になったときには、すべてのドメインを 2013-01-01 API に移行する必要があります。
検索ドメインを作成する AWS のリージョンを選択できます。一般的に、オペレーションの最寄りのリージョンを選択する必要があります。例えば、所在地がヨーロッパである場合は、ヨーロッパ (アイルランド) リージョン (eu-west-1) に検索ドメインを作成します。現在サポートされているリージョンとエンドポイントのリストについては、「[リージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html)」を参照してください。リージョンの選択の詳細については、「[Amazon CloudSearch のリージョンとエンドポイント](what-is-cloudsearch.md#endpoints)」を参照してください。
**注記**
異なるリージョンにある Amazon CloudSearch ドメインは完全に独立しています。例えば、*my-domain* という検索ドメインを us-east-1 に作成し、*my-domain* という別のドメインを eu-west-1 に作成した場合、これらは完全に独立しており、データは共有されません。
各検索ドメインには、インデックス作成用のデータのアップロードや、検索リクエストの送信に使用できる一意のエンドポイントがあります。ドメインのドキュメントエンドポイントと検索エンドポイントは、ドメインが存在している間変わりません。例えば、imdb-movies というドメインのエンドポイントは次のようになります。
```
doc-imdb-movies-nypdffbzrfkoudsurkxvgwbpi4.us-east-1.cloudsearch.amazonaws.com
search-imdb-movies-nypdffbzrfkoudsurkxvgwbpi4.us-east-1.cloudsearch.amazonaws.com
```
**重要**
デフォルトでは、新しいドメインのドキュメントエンドポイントと検索エンドポイントへのアクセスは、すべての IP アドレスに対してブロックされます。ドメインの検索エンドポイントに検索リクエストを送信して、コマンドラインまたはドメインのドキュメントエンドポイントからデータをアップロードするには、ドメインのアクセスポリシーを設定する必要があります。Amazon CloudSearch コンソールを使用すると、アクセスポリシーを設定せずに、ドキュメントをアップロードし、ドメインを検索できます。
[Amazon CloudSearch console](#create-domain-console) から、`aws cloudsearch create-domain` コマンドを使用して、または AWS SDK のいずれかを使用して、検索ドメインを作成できます。
**Topics**
+ [Amazon CloudSearch console](#create-domain-console)
+ [create-domain](#create-domain-clt)
+ [AWS SDK を使用した Amazon CloudSearch ドメインの作成](#create-domain-sdk)
## Amazon CloudSearch コンソールを使用したドメインの作成
Amazon CloudSearch コンソールでは、簡単に新しい検索ドメインを作成することができ、インデックス作成オプションを設定するためのさまざまなオプションが用意されています。
**ドメインを作成するには**
1. AWS マネジメントコンソール にサインインした後、[https://console.aws.amazon.com/cloudsearch/home](https://console.aws.amazon.com/cloudsearch/home) で Amazon CloudSearch コンソールを開きます。
1. **[ドメインを作成]** をクリックします。
1. 新しいドメインの名前を入力します。ドメイン名は、3 文字以上、28 文字以内で、先頭は英字または数字にする必要があります。ドメイン名に含めることができる文字は、a～z (小文字)、0～9、および - (ハイフン) です。大文字、下線 (\$1)、およびその他の特殊文字は、ドメイン名には使用できません。
オプションで、**[必要なインスタンスタイプ]** と **[必要なレプリケーション数]** を設定し、事前にドメインをスケーリングすることができます。詳細については、「[Amazon CloudSearch でのスケーリングオプションの設定](configuring-scaling-options.md)」を参照してください。
1. [**Next (次へ)**] を選択します。
1. 設定オプションで **[手動設定]** を選択し、**[次へ]** を選択します。
1. ドメインのインデックスフィールドを設定します。手順については、[インデックスフィールドの設定](configuring-index-fields.md) を参照してください。
1. [**Next (次へ)**] を選択します。
1. ドメインアクセスポリシーを設定します。手順については、[Amazon CloudSearch のアクセスの設定](configuring-access.md) を参照してください。
**注記**
アクセスポリシーを設定するまで、コンソールを使用した場合にのみ、ドキュメントをアップロードして検索クエリを送信できます。デフォルトでは、ドキュメントエンドポイントと検索エンドポイントは、すべての IP アドレスをブロックするように設定されます。
1. [**Next (次へ)**] を選択します。
1. ドメイン設定を確認して、**[作成]** を選択します。
ドメインのドキュメントエンドポイントおよび検索サービスエンドポイントは、ドメインがアクティブになったときにドメインダッシュボードに表示されます。この時点で、インデックス作成のためにドキュメントをアップロードし、データの検索を開始できます。
## を使用したドメインの作成 AWS CLI
検索ドメインを作成するには、`aws cloudsearch create-domain` コマンドを使用します。のインストールとセットアップの詳細については AWS CLI、「 [AWS Command Line Interface ユーザーガイド](https://docs.aws.amazon.com/cli/latest/userguide/)」を参照してください。
**ドメインを作成するには**
+ `aws cloudsearch create-domain` コマンドを実行し、`--domain-name` オプションで作成するドメインの名前を指定します。例えば、*movies* という名前のドメインを作成するには、次のコマンドを実行します。
**Example**
```
aws cloudsearch create-domain --domain-name movies
{
"DomainStatus": {
"DomainId": "965407640801/movies",
"Created": true,
"Deleted": false,
"SearchInstanceCount": 0,
"DomainName": "movies",
"SearchService": {},
"RequiresIndexDocuments": false,
"Processing": false,
"DocService": {},
"ARN": "arn:aws:cloudsearch:us-east-1:965407640801:domain/movies",
"SearchPartitionCount": 0
}
}
```
`aws cloudsearch create-domain` コマンドは直ちに制御を戻します。新しいドメインのエンドポイントを作成するのに約 10 分かかります。ドメインのステータスと設定の概要を表示するには、`aws cloudsearch describe-domains` コマンドを使用できます。詳細については、「[Amazon CloudSearch ドメインに関する情報の取得](getting-domain-info.md)」を参照してください。
**重要**
ドメインのエンドポイントがアクティブになると、ドメインが存在している間、エンドポイントは変わりません。エンドポイントをキャッシュに保存してください。ドキュメントや検索サービスリクエストを送信する前にエンドポイントにクエリを実行する必要はありません。このようなクエリを実行すると、リクエストの調整が発生する可能性があります。
## AWS SDK を使用した Amazon CloudSearch ドメインの作成
AWS SDK では (Android および iOS SDK を除く)、`CreateDomain` も含めて、Amazon CloudSearch 設定 API で定義されたすべての Amazon CloudSearch アクションがサポートされています。AWS SDK のインストールと使用の詳細については、[「AWS Software Development Kits」](https://aws.amazon.com/code)(AWS ソフトウェアデベロップメントキット) を参照してください。