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.

# AnalyzeID
<a name="API_AnalyzeID"></a>

Analysiert Ausweisdokumente auf relevante Informationen. Diese Informationen werden extrahiert und als`IdentityDocumentFields`, das sowohl das normalisierte Feld als auch den Wert des extrahierten Textes aufzeichnet. Im Gegensatz zu anderen Amazon Textract Textract-Vorgängen`AnalyzeID`gibt keine Geometrie-Daten zurück.

## Anforderungssyntax
<a name="API_AnalyzeID_RequestSyntax"></a>

```
{
   "DocumentPages": [ 
      { 
         "Bytes": blob,
         "S3Object": { 
            "Bucket": "string",
            "Name": "string",
            "Version": "string"
         }
      }
   ]
}
```

## Anfrageparameter
<a name="API_AnalyzeID_RequestParameters"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [DocumentPages](#API_AnalyzeID_RequestSyntax) **   <a name="Textract-AnalyzeID-request-DocumentPages"></a>
Das Dokument wird an AnalyeID übergeben.  
Type: Array-Reihe[Document](API_Document.md)Objekte  
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl von 2 Elementen.  
Erforderlich: Ja

## Antwortsyntax
<a name="API_AnalyzeID_ResponseSyntax"></a>

```
{
   "AnalyzeIDModelVersion": "string",
   "DocumentMetadata": { 
      "Pages": number
   },
   "IdentityDocuments": [ 
      { 
         "DocumentIndex": number,
         "IdentityDocumentFields": [ 
            { 
               "Type": { 
                  "Confidence": number,
                  "NormalizedValue": { 
                     "Value": "string",
                     "ValueType": "string"
                  },
                  "Text": "string"
               },
               "ValueDetection": { 
                  "Confidence": number,
                  "NormalizedValue": { 
                     "Value": "string",
                     "ValueType": "string"
                  },
                  "Text": "string"
               }
            }
         ]
      }
   ]
}
```

## Antwortelemente
<a name="API_AnalyzeID_ResponseElements"></a>

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.

 ** [AnalyzeIDModelVersion](#API_AnalyzeID_ResponseSyntax) **   <a name="Textract-AnalyzeID-response-AnalyzeIDModelVersion"></a>
Die Version der AnalyeIdentity API, die zur Verarbeitung von Dokumenten verwendet wird.  
Type: String (Zeichenfolge)

 ** [DocumentMetadata](#API_AnalyzeID_ResponseSyntax) **   <a name="Textract-AnalyzeID-response-DocumentMetadata"></a>
Informationen über das Eingabedokument.  
Typ: [DocumentMetadata](API_DocumentMetadata.md) Objekt

 ** [IdentityDocuments](#API_AnalyzeID_ResponseSyntax) **   <a name="Textract-AnalyzeID-response-IdentityDocuments"></a>
Die Liste der von AnalyeID verarbeiteten Dokumente. Schließt eine Zahl ein, die ihren Platz in der Liste und die Antwortstruktur für das Dokument angibt.  
Type: Array-Reihe[IdentityDocument](API_IdentityDocument.md)Objekte

## Fehler
<a name="API_AnalyzeID_Errors"></a>

 ** 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

 ** InternalServerError **   
Amazon Textract hat ein Service-Problem festgestellt. Wiederholen Sie den Aufruf.  
HTTP-Statuscode: 500

 ** 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

 ** 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:
<a name="API_AnalyzeID_SeeAlso"></a>

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/AnalyzeID) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeID) 
+  [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeID) 
+  [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeID) 
+  [AWSSDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeID) 
+  [AWS-SDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeID) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeID) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeID) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeID)