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. # StartDocumentTextDetection Startet die asynchrone Erkennung von Text in einem Dokument. Amazon Textract kann Textzeilen und Wörter erkennen, aus denen eine Textzeile besteht. `StartDocumentTextDetection`kann Text in Dokumenten analysieren, die im JPEG-, PNG-, TIFF- und PDF-Format vorliegen. Die Dokumente werden in einem Amazon S3 S3-Bucket gespeichert. Verwenden von[DocumentLocation](API_DocumentLocation.md)um den -Bucket-Namen und den Dateinamen des Dokuments anzugeben. `StartTextDetection`gibt eine Job-ID zurück (`JobId`), die Sie verwenden, um die Ergebnisse der Operation zu erhalten. Wenn die Texterkennung abgeschlossen ist, veröffentlicht Amazon Textract einen Abschlussstatus im Amazon Simple Notification Service (Amazon SNS) -Thema, das Sie in`NotificationChannel`aus. Um die Ergebnisse des Texterkennungsvorgangs zu erhalten, überprüfen Sie zunächst, ob der im Amazon SNS SNS-Thema veröffentlichte Statuswert lautet`SUCCEEDED`aus. Wenn ja, ruf an[GetDocumentTextDetection](API_GetDocumentTextDetection.md)und übergeben Sie die Job-ID (`JobId`) vom ersten Anruf an`StartDocumentTextDetection`aus. Weitere Informationen finden Sie unter[Texterkennung von Dokumenten](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html)aus. ## Anforderungssyntax ``` { "ClientRequestToken": "string", "DocumentLocation": { "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } }, "JobTag": "string", "KMSKeyId": "string", "NotificationChannel": { "RoleArn": "string", "SNSTopicArn": "string" }, "OutputConfig": { "S3Bucket": "string", "S3Prefix": "string" } } ``` ## Anfrageparameter Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [ClientRequestToken](#API_StartDocumentTextDetection_RequestSyntax) ** Das idempotente Token, das verwendet wird, um die Startanfrage zu identifizieren. Wenn Sie dasselbe Token mit mehreren verwenden`StartDocumentTextDetection`Anfragen, das gleiche`JobId`wird zurückgegeben. Verwenden von`ClientRequestToken`um zu verhindern, dass derselbe Job versehentlich mehr als einmal gestartet wird. Weitere Informationen finden Sie unter[Asynchrone Operationen von Amazon Textract aufrufen](https://docs.aws.amazon.com/textract/latest/dg/api-async.html)aus. Type: String (Zeichenfolge) Einschränkungen der Länge: Mindestlänge 1. Höchstlänge = 64 Zeichen. Pattern: `^[a-zA-Z0-9-_]+$` : Erforderlich Nein ** [DocumentLocation](#API_StartDocumentTextDetection_RequestSyntax) ** Der Speicherort des zu verarbeitenden Dokuments. Typ: [DocumentLocation](API_DocumentLocation.md) Objekt : Erforderlich Ja ** [JobTag](#API_StartDocumentTextDetection_RequestSyntax) ** Eine Kennung, die Sie angeben, die in der zum Amazon SNS SNS-Thema veröffentlichten Abschlussbenachrichtigung enthalten ist. Sie können beispielsweise die Datei verwenden`JobTag`um die Art des Dokuments anzugeben, dem die Abschlussmitteilung entspricht (z. B. ein Steuerformular oder eine Quittung). Type: String (Zeichenfolge) Einschränkungen der Länge: Mindestlänge 1. Höchstlänge = 64 Zeichen. Pattern: `[a-zA-Z0-9_.\-:]+` : Erforderlich Nein ** [KMSKeyId](#API_StartDocumentTextDetection_RequestSyntax) ** Der KMS-Schlüssel, der zum Verschlüsseln der Inferenzergebnisse verwendet wird. Dies kann entweder im Key ID- oder Key Alias Format vorliegen. Wenn ein KMS-Schlüssel bereitgestellt wird, wird der KMS-Schlüssel zur serverseitigen Verschlüsselung der Objekte im Kunden-Bucket verwendet. Wenn dieser Parameter nicht aktiviert ist, wird das Ergebnis serverseitig mit SSE-S3 verschlüsselt. Type: String (Zeichenfolge) Einschränkungen der Länge: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen. Pattern: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$` : Erforderlich Nein ** [NotificationChannel](#API_StartDocumentTextDetection_RequestSyntax) ** Das Amazon SNS SNS-Thema ARN, in dem Amazon Textract den Abschlussstatus des Vorgangs veröffentlichen soll. Typ: [NotificationChannel](API_NotificationChannel.md) Objekt : Erforderlich Nein ** [OutputConfig](#API_StartDocumentTextDetection_RequestSyntax) ** Legt fest, ob die Ausgabe an einen vom Kunden definierten Bucket gesendet wird. Standardmäßig speichert Amazon Textract die Ergebnisse intern, auf die mit dem GetDocumentTextDetection -Vorgang zugegriffen werden soll. Typ: [OutputConfig](API_OutputConfig.md) Objekt : Erforderlich Nein ## Antwortsyntax ``` { "JobId": "string" } ``` ## Antwortelemente Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück. Die folgenden Daten werden vom Service im JSON-Format zurückgegeben. ** [JobId](#API_StartDocumentTextDetection_ResponseSyntax) ** Die Kennung des Texterkennungsauftrags für das Dokument. Verwenden von`JobId`um den Job in einem nachfolgenden Aufruf zu identifizieren`GetDocumentTextDetection`aus. EIN`JobId`Wert ist nur 7 Tage lang gültig. Type: String (Zeichenfolge) Einschränkungen der Länge: Mindestlänge 1. Höchstlänge = 64 Zeichen. Pattern: `^[a-zA-Z0-9-_]+$` ## Fehler ** AccessDeniedException ** Sie sind nicht berechtigt, die Aktion auszuführen. Verwenden Sie den Amazon-Ressourcennamen (ARN) der IAM-Rolle oder eines autorisierten Benutzers, um den Vorgang auszuführen. HTTP-Statuscode: 400 ** BadDocumentException ** Amazon Textract kann das Dokument nicht lesen. Weitere Informationen zu den Beleglimits in Amazon Textract finden Sie unter[Hard Limits in Amazon Textract](limits.md)aus. HTTP-Statuscode: 400 ** DocumentTooLargeException ** Das Dokument kann nicht verarbeitet werden, da es zu groß ist. Die maximale Dokumentgröße für synchrone Operationen 10 MB. Die maximale Dokumentgröße für asynchrone Vorgänge beträgt 500 MB für PDF-Dateien. HTTP-Statuscode: 400 ** IdempotentParameterMismatchException ** EIN`ClientRequestToken`Der Eingabeparameter wurde mit einer Operation wiederverwendet, aber mindestens eine der anderen Eingabeparameter ist anders als im vorherigen Aufruf der Operation. HTTP-Statuscode: 400 ** InternalServerError ** Amazon Textract hat ein Service-Problem festgestellt. Wiederholen Sie den Aufruf. HTTP-Statuscode: 500 ** InvalidKMSKeyException ** Zeigt an, dass Sie keine Entschlüsselungsberechtigungen mit dem eingegebenen KMS-Schlüssel haben oder der KMS-Schlüssel falsch eingegeben wurde. HTTP-Statuscode: 400 ** InvalidParameterException ** Ein Eingabeparameter verletzt eine Beschränkung. Zum Beispiel wird bei synchronen Operationen ein`InvalidParameterException`Ausnahme tritt auf, wenn keiner der`S3Object`oder`Bytes`Werte werden im`Document`Anforderungsparameter. Validieren Sie den Parameter, bevor Sie die API-Operation erneut aufrufen. HTTP-Statuscode: 400 ** InvalidS3ObjectException ** Amazon Textract kann auf das in der Anforderung angegebene S3-Objekt nicht zugreifen.[Konfigurieren des Zugriffs auf Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Informationen zur Problembehebung finden Sie unter[Fehlerbehebung für Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html) HTTP-Statuscode: 400 ** LimitExceededException ** Ein Amazon Textract Textract-Service-Limit wurde überschritten. Wenn Sie beispielsweise zu viele asynchrone Jobs gleichzeitig starten, rufen Sie den Betrieb auf (`StartDocumentTextDetection`lösen beispielsweise eine LimitExcedeException-Ausnahme (HTTP-Statuscode: 400) aus, bis die Anzahl der gleichzeitig ausgeführten Aufträge unter dem Amazon Textract Textract-Service-Limit liegt. HTTP-Statuscode: 400 ** ProvisionedThroughputExceededException ** Die Anzahl der Anforderungen hat das Durchsatzlimit überschritten. Wenn Sie dieses Limit erhöhen müssen, wenden Sie sich an Amazon Textract. HTTP-Statuscode: 400 ** ThrottlingException ** Amazon Textract kann die Anforderung vorübergehend nicht verarbeiten. Wiederholen Sie den Aufruf. HTTP-Statuscode: 500 ** UnsupportedDocumentException ** Das Format des Eingabedokuments wird nicht unterstützt. Dokumente für Operationen können im PNG-, JPEG-, PDF- oder TIFF-Format vorliegen. HTTP-Statuscode: 400 ## Weitere Informationen finden Sie unter: Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: + [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/StartDocumentTextDetection) + [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentTextDetection) + [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentTextDetection) + [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentTextDetection) + [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentTextDetection) + [AWS-SDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentTextDetection)