

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

# Amazon Kendra のセットアップ
<a name="setup"></a>

Amazon Kendra を使用する前に、Amazon Web Services (AWS) アカウントを持っている必要があります。AWS アカウントを取得したら、Amazon Kendra コンソール、AWS Command Line Interface (AWS CLI)、または AWS SDK を使用して、Amazon Kendra にアクセスできます。

このガイドには、AWS CLI の例、Java の例、Python の例が含まれています。

**Topics**
+ [AWS にサインアップする](#aws-kendra-set-up-aws-account)
+ [リージョンとエンドポイント](#endpoints)
+ [のセットアップAWS CLI](aws-kendra-set-up-aws-cli.md)
+ [AWS SDK のセットアップ](aws-kendra-set-up-sdks.md)

## AWS にサインアップする
<a name="aws-kendra-set-up-aws-account"></a>

Amazon Web Services (AWS) にサインアップすると、Amazon Kendra を含む AWS のすべてのサービスに、お客様のアカウントが自動的にサインアップされます。請求されるのは、使用したサービスの料金のみです。

AWS アカウントを既にお持ちの場合は、次のタスクに進んでください。AWS アカウントをお持ちでない場合は、以下の手順に従ってアカウントを作成してください。<a name="proc-set-up-aws-account"></a>

**AWS にサインアップするには**

1. [http://aws.amazon.com/](https://aws.amazon.com/) を開いて、**[Create an AWS Account]** ( アカウントの作成) を選択します。

1. 画面上の指示に従ってアカウントの作成を完了します。12 桁の AWS アカウント番号を書き留めます。サインアップ手順の一環として、通話呼び出しを受け取り、電話のキーパッドを用いて PIN を入力することが求められます。

1. AWS Identity and Access Management (IAM) 管理者ユーザーを作成します。作成手順については、*AWS Identity and Access Management IAM ユーザーガイド*の[最初の IAM ユーザーおよびグループの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_create-admin-group.html)を参照してください。

## リージョンとエンドポイント
<a name="endpoints"></a>

エンドポイントは、ウェブサービスのエントリポイントとなるURLです。各エンドポイントは特定の AWS リージョンに関連付けられています。Amazon Kendra コンソールの組み合わせを使用する場合、AWS CLI、および Amazon Kendra SDK では、指定されたキャンペーンのすべての Amazon Kendra コンポーネント (インデックス、クエリなど) を同じリージョンに作成する必要があるため、それらのデフォルトのリージョンに注意してください。Amazon Kendra でサポートされているリージョンやエンドポイントについては、[リージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/kendra.html)を参照してください。

# のセットアップAWS CLI
<a name="aws-kendra-set-up-aws-cli"></a>

AWS コマンドラインインターフェイス (AWS CLI)は、Amazon Kendra を含む AWS のサービスを管理するための統合されたデベロッパーツールです。このツールをインストールすることをお勧めします。

1. AWS CLI をインストールするには、*AWS コマンドラインインターフェイスユーザーガイド*の [AWS コマンドラインインターフェイスのインストール](https://docs.aws.amazon.com/cli/latest/userguide/installing.html)の手順に従います。

1. AWS CLI を設定するには、AWS CLI プロファイルを設定して、*AWS コマンドラインインターフェイスユーザーガイド*の [AWS CLI の設定](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html)の手順に従ってください。

1. AWS CLI プロファイルが適切に設定されていることを確認するには、次のコマンドを実行します。

   ```
   aws configure --profile default
   ```

   プロファイルが正しく設定されている場合は、次のような出力が表示されます。

   ```
   AWS Access Key ID [****************52FQ]: 
   AWS Secret Access Key [****************xgyZ]: 
   Default region name [us-west-2]: 
   Default output format [json]:
   ```

1. AWS CLI が Amazon Kendra との使用に合わせて設定されていることを確認するには、以下のコマンドを実行します。

   ```
   aws kendra help
   ```

   AWS CLI が正しく設定されている場合は、Amazon Kendra、Amazon Kendra ランタイム、および Amazon Kendra イベントでサポートされている AWS CLI コマンドが一覧表示されます。

# AWS SDK のセットアップ
<a name="aws-kendra-set-up-sdks"></a>

使用する AWS SDK をダウンロードしてインストールします。このガイドでは、Python の例を示しています。AWS SDK の詳細については、[Amazon Web Services のツール](https://aws.amazon.com/tools/)を参照してください。

Python SDK 用のパッケージは *Boto3* と呼ばれています。

以下の Python コマンドを実行する前に、まず、ご使用のオペレーティングシステム用の [Python 3.6 以降](https://www.python.org/downloads/)をダウンロードして、インストールする必要があります。Python 3.5 以前のサポートは廃止されました。Python Scripts ディレクトリに pip が含まれていない場合は、[get-pip.py](https://bootstrap.pypa.io/get-pip.py) をダウンロードして Scripts ディレクトリに保存できます。ターミナルプログラムを使用して Python ディレクトリを [Path 変数または環境変数](https://docs.python.org/3/using/cmdline.html#envvar-PYTHONPATH)として設定することもできます。

```
# Install the latest Boto3 release via pip
pip install boto3

# You can install a specific version of Boto3 for compatibility reasons
# Install Boto3 version 1.0 specifically
pip install boto3==1.0.0

# Make sure Boto3 is no older than version 1.15.0
pip install boto3>=1.15.0

# Avoid versions of Boto3 newer than version 1.15.3
pip install boto3<=1.15.3
```

Boto3 を使用するには、[IAM コンソール](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey)を使用して AWS アカウントの認証情報を設定する必要があります。