

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Konfigurieren von Amazon Textract für asynchrone Vorgänge
<a name="api-async-roles"></a>

Die folgenden Verfahren zeigen Ihnen, wie Sie Amazon Textract für die Verwendung mit einem Amazon Simple Notification Service (Amazon SNS) -Thema und einer Amazon-Simple-Queue-Service-Warteschlange (Amazon SQS) konfigurieren.

**Anmerkung**  
Wenn Sie diese Anweisungen verwenden, um das[Erkennen oder Analysieren von Text in einem mehrseitigen Dokument](async-analyzing-with-sqs.md)Beispiel müssen Sie die Schritte 3 — 6 nicht ausführen. Das Beispiel enthält Code zum Erstellen und Konfigurieren des Amazon SNS SNS-Themas und die Amazon SQS SQS-Warteschlange.

**So konfigurieren Sie Amazon Textract**

1. Einrichten einesAWS-Konto für den Zugriff auf Amazon Textract. Weitere Informationen finden Sie unter [Schritt 1: Einrichten eines AWS-Kontos und Erstellen eines IAM-Benutzers](setting-up.md) .

   Stellen Sie sicher, dass der Benutzer mindestens über die folgenden Berechtigungen verfügt:
   + AmazonTextractFullAccess
   + AmazonS3ReadOnlyAccess
   + AmazonSNSFullAccess
   + AmazonSQSFullAccess

1. Installieren und konfigurieren Sie das erforderliche AWS-SDK. Weitere Informationen finden Sie unter [Schritt 2: Einrichten derAWS CLIundAWS-SDKs](setup-awscli-sdk.md) . 

1. [Erstellen Sie ein Amazon SNS-Thema.](https://docs.aws.amazon.com/sns/latest/dg/sns-tutorial-create-topic.html)aus. Stellen Sie dem Themennamen voran*AmazonTextract*aus. Notieren Sie den ARN (Amazon-Ressourcenname). Stellen Sie sicher, dass sich das -Thema in derselben -Region befindet wie dasAWSEndpunkt, den Sie mit Ihrem AWS-Konto verwenden.

1. [Erstellen einer Amazon SQS SQS-Standardwarteschlange](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-create-queue.html)indem Sie die[Amazon SQS SQS-Konsole](https://console.aws.amazon.com/sqs/)aus. Notieren Sie den ARN der Warteschlange.

1. [Abonnieren Sie die Warteschlange zum Thema](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/sqs-subscribe-queue-sns-topic.html), das Sie in Schritt 3 erstellt haben.

1. [Erteilen Sie die Berechtigung für das Amazon SNS SNS-Thema zum Senden von Nachrichten an die Amazon SQS SQS-Warteschlange](https://docs.aws.amazon.com/sns/latest/dg/subscribe-sqs-queue-to-sns-topic.html)aus.

1. Erstellen Sie eine IAM-Servicerolle, um Amazon Textract Zugriff auf Ihre Amazon SNS SNS-Themen zu gewähren. Notieren Sie sich den Amazon-Ressourcennamen (ARN) der Service-Rolle. Weitere Informationen finden Sie unter [Amazon Textract Zugriff auf Ihr Amazon SNS SNS-Thema gewähren](#api-async-roles-all-topics) .

1. [Fügen Sie die folgende Inlinerichtlinie hinzu](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#embed-inline-policy-console)an den IAM-Anwender, den Sie in Schritt 1 erstellt haben. 

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

   Geben Sie der Inlinerichtlinie einen Namen.

1. Jetzt können Sie die Beispiele in ausführen[Erkennen oder Analysieren von Text in einem mehrseitigen Dokument](async-analyzing-with-sqs.md)aus.

## Amazon Textract Zugriff auf Ihr Amazon SNS SNS-Thema gewähren
<a name="api-async-roles-all-topics"></a>

Amazon Textract benötigt die Berechtigung, eine Nachricht an Ihr Amazon SNS SNS-Thema zu senden, wenn ein asynchroner Vorgang abgeschlossen ist. Sie verwenden eine IAM-Servicerolle, um Amazon Textract Zugriff auf das Amazon SNS SNS-Thema zu gewähren. 

 Wenn Sie das Amazon SNS SNS-Thema erstellen, müssen Sie dem Themennamen vorangestellt werden**AmazonTextract**—beispielsweise**AmazonTextractMyTopicName**aus. 

1. Melden Sie sich bei der IAM-Konsole an ([https://console.aws.amazon.com/iam](https://console.aws.amazon.com/iam)).

1. Wählen Sie im Navigationsbereich **Roles** aus.

1. Wählen Sie **Create role (Rolle erstellen)** aus.

1. Wählen Sie unter **Select type of trusted entity (Typ der vertrauenswürdigen Entität wählen)** die Option **AWS service (Service)** aus. 

1. Für**Wählen Sie den Service aus, der diese Rolle verwendet**, wählen**Textract**aus.

1. Wählen Sie **Weiter**. **Berechtigungen**.

1. Stellen Sie sicher, dass die**AmazonTextractServiceRole**Die Richtlinie wurde in die Liste der angehängten Richtlinien aufgenommen. Um die Richtlinie in der Liste anzuzeigen, geben Sie einen Teil des Richtliniennamens in der**Filtern von Richtlinien**aus.

1. Wählen Sie **Weiter**. **Tags**.

1. Sie müssen keine Tags hinzufügen, wählen Sie also**Weiter: Prüfen**.

1. Geben Sie im Bereich **Review (Prüfen)** für **Role name (Rollenname)** einen Namen für die Rolle ein (z. B. `TextractRole`). In :**Rollenbeschreibung**aktualisieren Sie die Beschreibung für die Rolle und wählen Sie dann**Erstellen einer -Rolle**aus.

1. Wählen Sie die neue Rolle aus, um die Detailseite der Rolle zu öffnen.

1. Kopieren Sie unter **Summary (Übersicht)**den **Role ARN (Rollen-ARN)**-Wert und speichern Sie ihn.

1. Wählen Sie **Trust Relationships (Vertrauensbeziehungen)** aus.

1. Klicken Sie auf**Bearbeiten von Vertrauensstellungen**und stellen Sie sicher, dass die Vertrauensrichtlinie wie folgt aussieht.

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

1. Wählen Sie **Update Trust Policy**.