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à. # StartDocumentTextDetection Avvia il rilevamento asincrono di testo in un documento. Amazon Textract è in grado di rilevare le righe di testo e le parole che costituiscono una riga di testo. `StartDocumentTextDetection`può analizzare il testo nei documenti in formato JPEG, PNG, TIFF e PDF. I documenti vengono archiviati in un bucket Amazon S3. Utilizza[DocumentLocation](API_DocumentLocation.md)per specificare il nome del file e del bucket. `StartTextDetection`restituisce un identificatore di lavoro (`JobId`) utilizzato per ottenere i risultati dell'operazione. Al termine del rilevamento del testo, Amazon Textract pubblica uno stato di completamento nell'argomento Amazon Simple Notification Service (Amazon SNS) specificato in`NotificationChannel`. 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](API_GetDocumentTextDetection.md)e passa l'identificativo del processo (`JobId`) dalla chiamata iniziale a`StartDocumentTextDetection`. Per ulteriori informazioni, consulta[Rilevamento del testo](https://docs.aws.amazon.com/textract/latest/dg/how-it-works-detecting.html). ## Sintassi della richiesta ``` { "ClientRequestToken": "string", "DocumentLocation": { "S3Object": { "Bucket": "string", "Name": "string", "Version": "string" } }, "JobTag": "string", "KMSKeyId": "string", "NotificationChannel": { "RoleArn": "string", "SNSTopicArn": "string" }, "OutputConfig": { "S3Bucket": "string", "S3Prefix": "string" } } ``` ## Parametri della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [ClientRequestToken](#API_StartDocumentTextDetection_RequestSyntax) ** Il token idempotente utilizzato per identificare la richiesta iniziale. Se usi lo stesso token con più`StartDocumentTextDetection`richieste, le stesse`JobId`viene restituito. Utilizza`ClientRequestToken`per evitare che lo stesso lavoro venga avviato accidentalmente più di una volta. Per ulteriori informazioni, consulta[Chiamata di Amazon Textract Asynchronous Operations](https://docs.aws.amazon.com/textract/latest/dg/api-async.html). Type: Stringa Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `^[a-zA-Z0-9-_]+$` Campo obbligatorio No ** [DocumentLocation](#API_StartDocumentTextDetection_RequestSyntax) ** La posizione del documento da elaborare. Tipo: [DocumentLocation](API_DocumentLocation.md) oggetto Campo obbligatorio Sì ** [JobTag](#API_StartDocumentTextDetection_RequestSyntax) ** Identificativo specificato incluso nella notifica di completamento pubblicata sull'argomento Amazon SNS. Ad esempio, è possibile utilizzare`JobTag`per identificare il tipo di documento a cui corrisponde la notifica di completamento (ad esempio un modulo fiscale o una ricevuta). Type: Stringa Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `[a-zA-Z0-9_.\-:]+` Campo obbligatorio No ** [KMSKeyId](#API_StartDocumentTextDetection_RequestSyntax) ** La chiave KMS utilizzata per crittografare i risultati dell'inferenza. Può essere in formato Key ID o Key Alias. Quando viene fornita una chiave KMS, la chiave KMS viene utilizzata per la crittografia lato server degli oggetti nel bucket cliente. Quando questo parametro non è abilitato, il risultato sarà crittografato lato server, utilizzando SSE-S3. Type: Stringa Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri. Modello: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$` Campo obbligatorio No ** [NotificationChannel](#API_StartDocumentTextDetection_RequestSyntax) ** Argomento Amazon SNS su cui desideri che Amazon Textract pubblichi lo stato di completamento dell'operazione. Tipo: [NotificationChannel](API_NotificationChannel.md) oggetto Campo obbligatorio No ** [OutputConfig](#API_StartDocumentTextDetection_RequestSyntax) ** Imposta se l'output andrà a un bucket definito dal cliente. Per impostazione predefinita, Amazon Textract salverà i risultati internamente per accedere con l'operazione GetDocumentTextDetection. Tipo: [OutputConfig](API_OutputConfig.md) oggetto Campo obbligatorio No ## Sintassi della risposta ``` { "JobId": "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. ** [JobId](#API_StartDocumentTextDetection_ResponseSyntax) ** Identificatore del processo di rilevamento del testo per il documento. Utilizza`JobId`per identificare il processo in una successiva chiamata a`GetDocumentTextDetection`. 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-_]+$` ## 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 ** IdempotentParameterMismatchException ** UN`ClientRequestToken`Il parametro di input è stato riutilizzato con un'operazione, ma almeno uno degli altri parametri di input è diverso dalla precedente chiamata all'operazione. Codice di stato HTTP: 400 ** InternalServerError ** Amazon Textract ha riscontrato un problema del servizio. Riprova la chiamata. Codice di stato HTTP: 500 ** 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 di 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.[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 ** LimitExceededException ** Un limite del servizio Amazon Textract è stato superato. Ad esempio, se si avvia troppi processi asincroni contemporaneamente, chiamate per avviare le operazioni (`StartDocumentTextDetection`, ad esempio) sollevano un'LimitExceededException (codice di stato HTTP: 400) finché il numero di processi simultanei in esecuzione è inferiore al service limit Amazon Textract. Codice di stato HTTP: 400 ** ProvisionedThroughputExceededException ** Il numero di richieste ha superato il limite di throughput. Se desideri 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/StartDocumentTextDetection) + [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/textract-2018-06-27/StartDocumentTextDetection) + [SDK AWS per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/textract-2018-06-27/StartDocumentTextDetection) + [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/textract-2018-06-27/StartDocumentTextDetection) + [AWSSDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/textract-2018-06-27/StartDocumentTextDetection) + [SDK AWS per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/textract-2018-06-27/StartDocumentTextDetection) + [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/textract-2018-06-27/StartDocumentTextDetection) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/textract-2018-06-27/StartDocumentTextDetection)