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

# Amazon Textract の開始方法
<a name="getting-started"></a>

このセクションでは、Amazon Textract の使用を開始する方法について説明します。Amazon Textract を初めて使用する場合は、最初に「」の概念と用語に目をおすすめします。[Amazon Textract 仕組み](how-it-works.md)。

Amazon Textract コンソールでデモを使用して API を試すことができます。詳細については、「」を参照してください。[https://console.aws.amazon.com/textract/](https://console.aws.amazon.com/textract/)。

**Topics**
+ [ステップ 1: AWS アカウントを設定して IAM ユーザーの作成](setting-up.md)
+ [ステップ 2: のセットアップAWS CLIそしてAWSSDK](setup-awscli-sdk.md)
+ [ステップ 3: の使用開始AWS CLIそしてAWSSDK API](get-started-exercise.md)

# ステップ 1: AWS アカウントを設定して IAM ユーザーの作成
<a name="setting-up"></a>

Amazon Textract を初めて使用する場合は、事前に以下のタスクをすべて実行してください。

1. [AWS にサインアップする](#setting-up-signup).

1. [IAM ユーザーを作成する](#setting-up-iam).

## AWS にサインアップする
<a name="setting-up-signup"></a>

Amazon Web Services (AWS) にサインアップすると、AWS アカウントが AWS でリリースされているすべてのサービスに自動的にサインアップされます。サービスを実際に使用した分の料金のみが請求されます。

Amazon Textract は、使用したリソース分のみお支払いいただくだけで利用可能です。Amazon Textract の使用料の詳細については、「」を参照してください。[Amazon Textract の料金](https://aws.amazon.com/textract/pricing/)。AWS の新規のお客様の場合、Amazon Textract は無料で使い始めることができます。詳細については、「[AWS 無料利用枠](https://aws.amazon.com/free/)」を参照してください。

すでに AWS アカウントをお持ちの場合は次のタスクに進んでください。AWS アカウントをお持ちでない場合は、次に説明する手順を実行してアカウントを作成してください。

**AWS アカウントを作成するには**

1. [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup) を開きます。

1. オンラインの手順に従います。

   サインアップ手順の一環として、通話呼び出しを受け取り、電話のキーパッドを用いて確認コードを入力するように求められます。

AWS アカウント ID は次のタスクでも必要となるので、メモしておいてください。

## IAM ユーザーを作成する
<a name="setting-up-iam"></a>

Amazon Textract などの AWS のサービスは、サービスにアクセスする際に認証情報を提供する必要があります。これにより、サービスのリソースにアクセスする権限の有無が判定されます。コンソールを使用するにはパスワードが必要です。AWS アカウントによる AWS CLI または API へのアクセス用にアクセスキーを作成できます。ただし、AWS アカウントの認証情報を使用して AWS にアクセスすることはお勧めしません。代わりに、以下をお勧めします。
+ を使用するAWS Identity and Access Management(IAM) を使用して IAM ユーザーを作成します。
+ 管理権限を持つ IAM グループにユーザーを追加します。

その後、特別な URL とその IAM ユーザーの認証情報を使用して AWS にアクセスできます。

AWS にサインアップしても、ご自分の IAM ユーザーをまだ作成していない場合は、IAM コンソールを使用して作成できます。アカウントに IAM ユーザーを作成するには、次の手順に従います。



**IAM ユーザーを作成してコンソールにサインインするには**

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

1. IAM ユーザーとして、特別な URL を使用して AWS マネジメントコンソール にサインインします。詳細については、「」を参照してください。[ユーザーがアカウントにサインインする方法](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started_how-users-sign-in.html)の*IAM ユーザーガイド*。

**注記**  
管理者権限を持つ IAM ユーザーには、AWSアカウント内のサービス。このガイドのコード例では、`AmazonTextractFullAccess`アクセス許可。`AmazonS3ReadOnlyAccess`Amazon S3 バケットに格納されているドキュメントにアクセスする場合は、が必要です。セキュリティ要件によっては、これらのアクセス権限に制限した IAM グループを使用することもできます。詳細については、「」を参照してください。[IAM グループの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_groups_create.html)。



IAM の詳細については、以下を参照してください。
+ [AWS Identity and Access Management (IAM)](https://aws.amazon.com/iam/)
+ [開始方法](https://docs.aws.amazon.com/IAM/latest/UserGuide/getting-started.html)
+ [IAM ユーザーガイド](https://docs.aws.amazon.com/IAM/latest/UserGuide/)

## 次のステップ
<a name="setting-up-next-step-2"></a>

[ステップ 2: のセットアップAWS CLIそしてAWSSDK](setup-awscli-sdk.md)

# ステップ 2: のセットアップAWS CLIそしてAWSSDK
<a name="setup-awscli-sdk"></a>

以下の手順では、以下の例で使用する AWS Command Line Interface (AWS CLI) と AWS SDK をインストールする方法を示します。

AWS SDK の呼び出しは、さまざまな方法で認証できます。以下の例では、デフォルトの認証情報プロファイルを使用して AWS CLI コマンドと AWS SDK API オペレーションを呼び出します。デフォルトの認証情報はサービス間で機能するため、認証情報をすでに設定している場合は、再度行う必要はありません。ただし、このサービスの別のクレデンシャルセットを作成する場合は、名前プロファイルを作成できます。プロファイルの作成の詳細については、[名前を指定されたプロファイルを参照してください。](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-profiles.html)

使用可能なのリストについてはAWSリージョン、「」を参照してください[のリージョンとエンドポイント](https://docs.aws.amazon.com/general/latest/gr/rande.html)の*Amazon Web Services 全般リファレンス*。

**AWS CLI と AWS SDK をセットアップするには**

1. 使用する AWS CLI と AWS SDK をダウンロードしてインストールします。このガイドでは、の例を示しています。AWS CLI、Java、Python、など。AWS SDK の詳細については、[Amazon Web Services のツール](https://aws.amazon.com/tools/)を参照してください。
   + [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-set-up.html)
   + [AWS SDK for Java](https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/)
   + [AWS SDK for Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/index.html)

1. 「」で作成したユーザーのアクセスキーを作成します。[IAM ユーザーを作成する](setting-up.md#setting-up-iam)。

   1. AWS マネジメントコンソール にサインインして、IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。

   1. ナビゲーションペインで **[Users]** (ユーザー) を選択します。

   1. 「」で作成したユーザーの名前を選択します。[IAM ユーザーを作成する](setting-up.md#setting-up-iam)。

   1. ［**Security credentials**］タブを選択します。

   1. [**アクセスキーの作成**] を選択します。次に、[**.csv ファイルのダウンロード**] を選択して、ご使用のコンピュータにアクセスキー ID とシークレットアクセスキーをファイルに保存します。このファイルは安全な場所に保存してください。このダイアログボックスを閉じた後で、シークレットアクセスキーに再度アクセスすることはできません。CSV ファイルをダウンロードしたら、**Close**。

1. 次の場所にあるローカルシステム上の AWS 認証プロファイルファイルで認証情報を設定する 
   + `~/.aws/credentials`Linux、macOS、Unix の場合は。
   + `C:\Users\USERNAME\.aws\credentials`Windows の場合は。

   -`.aws`フォルダは、AWS インスタンスの最初の初期設定の前に存在しません。CLI で認証情報を初めて設定すると、このフォルダが作成されます。AWS 認証情報の詳細については、「」を参照してください。[設定ファイルと認証情報ファイルの設定。](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)

   このファイルには以下の形式の行が含まれている必要があります。

   ```
   [default]
   aws_access_key_id = your_access_key_id
   aws_secret_access_key = your_secret_access_key
   ```

   アクセスキー ID とシークレットアクセスキーを*your\$1access\$1key\$1id*そして*secret\$1access\$1key*。

1. AWS でデフォルトの AWS リージョンを設定する`config`ローカルシステム上のファイル。次の場所にあります。
   + `~/.aws/config`Linux、macOS、Unix の場合は。
   + `C:\Users\USERNAME\.aws\config`Windows の場合は。

   -`.aws`フォルダは、AWS インスタンスの最初の初期設定の前に存在しません。CLI で認証情報を初めて設定すると、このフォルダが作成されます。AWS 認証情報の詳細については、「」を参照してください。[設定ファイルと認証情報ファイルの設定。](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html)

   このファイルには次の行が含まれています。

   ```
   [default]
   region = your_aws_region
   ```

   使用する AWS リージョン (「us-west-2" など) に置き換えます。*your\$1aws\$1region*。
**注記**  
リージョンを選択しないと、デフォルトで us-east-1 が使用されます。

## 次のステップ
<a name="setting-up-next-step-3"></a>

[ステップ 3: の使用開始AWS CLIそしてAWSSDK API](get-started-exercise.md)

# ステップ 3: の使用開始AWS CLIそしてAWSSDK API
<a name="get-started-exercise"></a>

設定後AWS CLIそしてAWS使用する SDK は、Amazon Textract を使用するアプリケーションを構築できます。以下のトピックでは、Amazon Textract の開始方法を示しています。
+ [Amazon Textract を使用したドキュメントテキストの分析](analyzing-document-text.md)

## AWS CLI のサンプルの書式設定
<a name="format-cli"></a>

このガイドの AWS CLI の例は、Linux オペレーティングシステム用に書式設定されています。Microsoft Windows で例を使用するには、`--document` パラメータの JSON 形式を変更し、改行をバックスラッシュ (\$1) からキャレット (^) に変える必要があります。JSON 形式の詳細については、「[AWS Command Line Interface のパラメータ値の指定](https://docs.aws.amazon.com/cli/latest/userguide/cli-using-param.html)」を参照してください。