Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# AnalyzeID
Analizza i documenti di identità alla ricerca di informazioni pertinenti. Queste informazioni vengono estratte e restituite come`IdentityDocumentFields`, che registra sia il campo normalizzato che il valore del testo estratto.A differenza di altre operazioni di Amazon Textract,`AnalyzeID`non restituisce alcun dato Geometry.
## Sintassi della richiesta
```
{
"DocumentPages": [
{
"Bytes": blob,
"S3Object": {
"Bucket": "string",
"Name": "string",
"Version": "string"
}
}
]
}
```
## Parametri della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [DocumentPages](#API_AnalyzeID_RequestSyntax) **
Il documento che viene passato ad AnalyzeID.
Type: Matrice di[Document](API_Document.md)oggetti
Membri dell'array: Numero minimo di 1 elemento. Numero massimo di 2 elementi.
campo obbligatorio Sì
## Sintassi della risposta
```
{
"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"
}
}
]
}
]
}
```
## Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
** [AnalyzeIDModelVersion](#API_AnalyzeID_ResponseSyntax) **
La versione dell'API AnalyzeIdentity utilizzata per elaborare i documenti.
Type: Stringa
** [DocumentMetadata](#API_AnalyzeID_ResponseSyntax) **
Informazioni sul documento di input.
Tipo: [DocumentMetadata](API_DocumentMetadata.md) oggetto
** [IdentityDocuments](#API_AnalyzeID_ResponseSyntax) **
L'elenco dei documenti elaborati da AnalyzeID. Include un numero che indica la loro posizione nell'elenco e la struttura di risposta per il documento.
Type: Matrice di[IdentityDocument](API_IdentityDocument.md)oggetti
## Errori
** AccessDeniedException **
Non sei autorizzato a eseguire l'operazione. Utilizzare l'ARN (Amazon Resource Name) di un utente autorizzato o un ruolo IAM per eseguire l'operazione.
Codice di stato HTTP: 400
** BadDocumentException **
Amazon Textract non è in grado di leggere il documento. Per ulteriori informazioni sui limiti dei documenti in Amazon Textract, consulta[Limiti rigidi per Amazon Textract](limits.md).
Codice di stato HTTP: 400
** DocumentTooLargeException **
Il documento non può essere elaborato perché è troppo grande. La dimensione massima dei documenti per operazioni sincrone 10 MB. La dimensione massima del documento per le operazioni asincrone è di 500 MB per i file PDF.
Codice di stato HTTP: 400
** InternalServerError **
Amazon Textract ha riscontrato un problema del servizio. Riprova la chiamata.
Codice di stato HTTP: 500
** InvalidParameterException **
Un parametro di input ha violato un vincolo. Ad esempio, nelle operazioni sincrone, un`InvalidParameterException`eccezione si verifica quando nessuno dei due`S3Object`o`Bytes`i valori sono forniti nel`Document`parametro della richiesta. Convalida il parametro prima di chiamare nuovamente l'operazione API.
Codice di stato HTTP: 400
** InvalidS3ObjectException **
Amazon Textract non è in grado di accedere all'oggetto S3 specificato nella richiesta. Per ulteriori informazioni,[Configura l'accesso a Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html)Per informazioni sulla risoluzione dei problemi, consulta[Risoluzione dei problemi Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/troubleshooting.html)
Codice di stato HTTP: 400
** ProvisionedThroughputExceededException **
Il numero di richieste ha superato il limite di throughput. Per aumentare questo limite, contatta Amazon Textract.
Codice di stato HTTP: 400
** ThrottlingException **
Amazon Textract non è temporaneamente in grado di elaborare la richiesta. Riprova la chiamata.
Codice di stato HTTP: 500
** UnsupportedDocumentException **
Il formato del documento di input non è supportato. I documenti per le operazioni possono essere in formato PNG, JPEG, PDF o TIFF.
Codice di stato HTTP: 400
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue:
+ [Interfaccia a riga di comando AWS](https://docs.aws.amazon.com/goto/aws-cli/textract-2018-06-27/AnalyzeID)
+ [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/AnalyzeID)
+ [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/AnalyzeID)
+ [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/AnalyzeID)
+ [AWSSDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/AnalyzeID)
+ [SDK AWS per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/AnalyzeID)
+ [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/AnalyzeID)
+ [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/AnalyzeID)
+ [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/AnalyzeID)