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

# 非同期オペレーション用の Amazon Textract の設定
<a name="api-async-roles"></a>

以下の手順は、Amazon Simple Notification Service (Amazon SNS) トピックと Amazon Simple Queue Service (Amazon SQS) キューと一緒に使用する Amazon Textract を設定する方法を示しています。

**注記**  
これらの手順を使用してをセットアップする場合[複数ページドキュメント内のテキストの検出または分析](async-analyzing-with-sqs.md)たとえば、ステップ 3 ～ 6 を実行する必要はありません。この例には、Amazon SNS トピックと Amazon SQS キューを作成して設定するコードが含まれています。

**Amazon Textract を設定するには**

1. をセットアップするAWSAmazon Textract にアクセスするためのアカウント。詳細については、「[ステップ 1: AWS アカウントを設定して IAM ユーザーの作成](setting-up.md)」を参照してください。

   ユーザーに少なくとも以下のアクセス許可があることを確認します。
   + AmazonTextractFullAccess
   + AmazonS3ReadOnlyAccess
   + AmazonSNSFullAccess
   + AmazonSQSFullAccess

1. 必要な AWS SDK をインストールして設定します。詳細については、「[ステップ 2: のセットアップAWS CLIそしてAWSSDK](setup-awscli-sdk.md)」を参照してください。

1. [Amazon SNS トピックを作成する](https://docs.aws.amazon.com/sns/latest/dg/sns-tutorial-create-topic.html)。トピック名の先頭に「」を追加します。*AmazonExtract*。その Amazon リソースネーム (ARN) をメモします。トピックが、と同じリージョンにあることを確認します。AWSAWS アカウントで使用しているエンドポイント。

1. [Amazon SQS 標準キューを作成する](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-create-queue.html)を使用して[Amazon SQS コンソール](https://console.aws.amazon.com/sqs/)。キューの ARN をメモします。

1. ステップ 3 で作成した[トピックにキューをサブスクライブ](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-subscribe-queue-sns-topic.html)します。

1. [Amazon SQS キューにメッセージを送信するアクセス許可を Amazon SNS トピックに付与する](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html)。

1. IAM サービスロールを作成して、Amazon Textract に Amazon SNS トピックへのアクセス権を付与します。このサービスロールの Amazon リソースネーム (ARN) をメモします。詳細については、「[Amazon SNS トピックへの Amazon Textract アクセスを付与する](#api-async-roles-all-topics)」を参照してください。

1. [以下のインラインポリシーを追加します。](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#embed-inline-policy-console)をステップ 1 で作成した IAM ユーザーに指定します。

   ```
   {
       "Version": "2012-10-17",
       "Statement": [
           {
               "Sid": "MySid",
               "Effect": "Allow",
               "Action": "iam:PassRole",
               "Resource": "Service role ARN from step 7"
           }
       ]
   }
   ```

   インラインポリシーに名前を付けます。

1. これで、の例を実行できます。[複数ページドキュメント内のテキストの検出または分析](async-analyzing-with-sqs.md)。

## Amazon SNS トピックへの Amazon Textract アクセスを付与する
<a name="api-async-roles-all-topics"></a>

Amazon Textract では、非同期操作が完了したときに Amazon SNS トピックにメッセージを送信するためのアクセス許可が必要です。IAM サービスロールを使用して、Amazon Textract に Amazon SNS トピックへのアクセス権を付与します。

 Amazon SNS トピックを作成するときは、トピック名の先頭に「」を付ける必要があります。**AmazonTextract**— たとえば、**AmazonTextractMyTopicName**。

1. IAM コンソール ([https://console.aws.amazon.com/iam](https://console.aws.amazon.com/iam)) にサインインします。

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

1. [**ロールの作成**] を選択します。

1. [**Select type of trusted entity (信頼されたエンティティのタイプの選択)**] で、[**AWS サービス**] を選択します。

1. を使用する場合**このロールを使用するサービスを選択**で、**Textract**。

1. [**Next: (次へ:)**] を選択します **アクセス許可**.

1. になっていることを確認します。**AmazonTextractServiceRole**ポリシーがアタッチされたポリシーのリストに含まれている。リストにポリシーを表示するには、にポリシー名の一部を入力します。**フィルタポリシー**。

1. [**Next: (次へ:)**] を選択します **タグ**

1. タグの作成は必要ないため、**次へ: 確認**.

1. [**確認**] セクションの [**ロール名**] に、ロールの名前を入力します (例: `TextractRole`)。Eclipse**ロールの説明**で、ロールの説明を更新して、**ロールの作成**。

1. 新しいロールを選択して、ロールの詳細ページを開きます。

1. [**概要**] で、[**ロール ARN**] の値をコピーして保存します。

1. [**Trust relationships (信頼関係)**] を選択します。

1. 選択**信頼関係を編集する**を選択し、信頼ポリシーが次のようになっていることを確認します。

   ```
   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "textract.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }
   ```

1. **[Update Trust Policy]** (信頼ポリシーの更新) をクリックします。