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à. # GetDocumentTextDetection Ottiene i risultati di un'operazione asincrona Amazon Textract che rileva il testo in un documento. Amazon Textract è in grado di rilevare le righe di testo e le parole che costituiscono una riga di testo. Si avvia il rilevamento asincrono del testo chiamando[StartDocumentTextDetection](API_StartDocumentTextDetection.md), che restituisce un identificatore di lavoro (`JobId`). Al termine dell'operazione di rilevamento del testo, Amazon Textract pubblica uno stato di completamento nell'argomento Amazon Simple Notification Service (Amazon SNS) registrato nella chiamata iniziale a`StartDocumentTextDetection`. Per ottenere i risultati dell'operazione di rilevamento del testo, verificare innanzitutto che il valore di stato pubblicato nell'argomento Amazon SNS sia`SUCCEEDED`. Se è così, chiama`GetDocumentTextDetection`e passa l'identificativo del processo (`JobId`) dalla chiamata iniziale a`StartDocumentTextDetection`. `GetDocumentTextDetection`restituisce una matrice di[Block](API_Block.md)oggetti. Ogni pagina del documento è associata`Block`di tipo PAGE. Ogni PAGINA`Block`object è il padre di LINE`Block`oggetti che rappresentano le righe del testo rilevato in una pagina. RIGA`Block`object è un genitore per ogni parola che compone la riga. Le parole sono rappresentate da`Block`oggetti di tipo WORD. Utilizza il parametro MaxResults per limitare il numero di blocchi restituiti. Se ci sono più risultati di quelli specificati in`MaxResults`, il valore di`NextToken`nella risposta operativa contiene un token di impaginazione per ottenere il successivo set di risultati. Per visualizzare la pagina di risultati successiva, chiama`GetDocumentTextDetection`e popolare il campo obbligatorio`NextToken`parametro request con il valore del token restituito dalla chiamata precedente a`GetDocumentTextDetection`. Per ulteriori informazioni, consulta[Rilevamento del testo documento](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html). ## Sintassi della richiesta ``` { "JobId": "string", "MaxResults": number, "NextToken": "string" } ``` ## Parametri della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [JobId](#API_GetDocumentTextDetection_RequestSyntax) ** Identificatore univoco per il processo di rilevamento del testo. La`JobId`viene restituito da`StartDocumentTextDetection`. UN`JobId`il valore è valido solo per 7 giorni. Type: Stringa Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `^[a-zA-Z0-9-_]+$` Campo obbligatorio: Sì ** [MaxResults](#API_GetDocumentTextDetection_RequestSyntax) ** Numero massimo di risultati da restituire per ogni chiamata impaginata. Il valore maggiore che puoi specificare è 1.000. Se si specifica un valore maggiore di 1.000, vengono restituiti al massimo 1.000 risultati. Il valore predefinito è 1,000. Type: Numero intero Intervallo valido: Valore minimo di 1. Campo obbligatorio: No ** [NextToken](#API_GetDocumentTextDetection_RequestSyntax) ** Se la risposta precedente era incompleta (perché ci sono più blocchi da recuperare), Amazon Textract restituisce un token di impaginazione nella risposta. È possibile utilizzare questo token di impaginazione per recuperare il successivo set di blocchi. Type: Stringa Vincoli di lunghezza: Lunghezza minima pari a 1. Lunghezza massima di 255. Modello: `.*\S.*` Campo obbligatorio: No ## Sintassi della risposta ``` { "Blocks": [ { "BlockType": "string", "ColumnIndex": number, "ColumnSpan": number, "Confidence": number, "EntityTypes": [ "string" ], "Geometry": { "BoundingBox": { "Height": number, "Left": number, "Top": number, "Width": number }, "Polygon": [ { "X": number, "Y": number } ] }, "Id": "string", "Page": number, "Relationships": [ { "Ids": [ "string" ], "Type": "string" } ], "RowIndex": number, "RowSpan": number, "SelectionStatus": "string", "Text": "string", "TextType": "string" } ], "DetectDocumentTextModelVersion": "string", "DocumentMetadata": { "Pages": number }, "JobStatus": "string", "NextToken": "string", "StatusMessage": "string", "Warnings": [ { "ErrorCode": "string", "Pages": [ number ] } ] } ``` ## 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. ** [Blocks](#API_GetDocumentTextDetection_ResponseSyntax) ** I risultati dell'operazione di rilevamento del testo. Type: Array di[Block](API_Block.md)oggetti ** [DetectDocumentTextModelVersion](#API_GetDocumentTextDetection_ResponseSyntax) ** Type: Stringa ** [DocumentMetadata](#API_GetDocumentTextDetection_ResponseSyntax) ** Informazioni su un documento elaborato da Amazon Textract.`DocumentMetadata`viene restituito in ogni pagina delle risposte impaginate da un'operazione video di Amazon Textract. Tipo: [DocumentMetadata](API_DocumentMetadata.md) oggetto ** [JobStatus](#API_GetDocumentTextDetection_ResponseSyntax) ** Lo stato corrente del processo di rilevamento del testo. Type: Stringa Valori validi: ` IN_PROGRESS | SUCCEEDED | FAILED | PARTIAL_SUCCESS` ** [NextToken](#API_GetDocumentTextDetection_ResponseSyntax) ** Se la risposta viene troncata, Amazon Textract restituisce questo token. È possibile utilizzare questo token nella richiesta seguente per recuperare il successivo set di risultati del rilevamento del testo. Type: Stringa Vincoli di lunghezza: Lunghezza minima pari a 1. Lunghezza massima di 255. Modello: `.*\S.*` ** [StatusMessage](#API_GetDocumentTextDetection_ResponseSyntax) ** Restituisce se non è stato possibile completare il processo di rilevamento. Contiene una spiegazione per quale errore si è verificato. Type: Stringa ** [Warnings](#API_GetDocumentTextDetection_ResponseSyntax) ** Un elenco di avvisi verificati durante l'operazione di rilevamento del testo per il documento. Type: Array di[Warning](API_Warning.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 ** InternalServerError ** Amazon Textract ha riscontrato un problema del servizio. Riprova la chiamata. Codice di stato HTTP: 500 ** InvalidJobIdException ** È stato passato un identificatore di lavoro non valido[GetDocumentAnalysis](API_GetDocumentAnalysis.md)o a[GetDocumentAnalysis](API_GetDocumentAnalysis.md). Codice di stato HTTP: 400 ** InvalidKMSKeyException ** Indica che non si dispone delle autorizzazioni di decrittografia con la chiave KMS immessa o che la chiave KMS è stata immessa in modo errato. Codice di stato HTTP: 400 ** 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 ## 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/GetDocumentTextDetection) + [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/GetDocumentTextDetection) + [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/GetDocumentTextDetection) + [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/GetDocumentTextDetection) + [AWSSDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/GetDocumentTextDetection) + [SDK AWS per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/GetDocumentTextDetection) + [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/GetDocumentTextDetection) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/GetDocumentTextDetection) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/GetDocumentTextDetection)