

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à.

# Accodamento dei processi
<a name="job-queueing"></a>

Utilizzando l'accodamento dei processi, puoi inviare più richieste del processo di trascrizione di quante ne possano essere elaborate contemporaneamente. Senza l’accodamento dei processi, una volta raggiunta la quota di richieste simultanee consentite, è necessario attendere il completamento di una o più richieste prima di inviarne una nuova.

L'accodamento dei lavori è facoltativo sia per i lavori di trascrizione che per le richieste di lavoro di analisi post-chiamata.

Se abiliti l'accodamento dei lavori, Amazon Transcribe crea una coda che contiene tutte le richieste che superano il limite. Non appena una richiesta viene completata, una nuova richiesta viene estratta dalla coda ed elaborata. Le richieste in coda vengono elaborate in ordine FIFO (first-in-first-out).

Puoi aggiungere fino a 10.000 processi alla coda. Se si supera questo limite, si verificherà un errore `LimitExceededConcurrentJobException`. Per mantenere prestazioni ottimali, utilizza Amazon Transcribe solo fino al 90 percento della quota (un rapporto di larghezza di banda di 0,9) per elaborare i lavori in coda. Tieni presente che si tratta di valori predefiniti che possono essere aumentati su richiesta.

**Suggerimento**  
[È possibile trovare un elenco dei limiti e delle quote predefiniti per Amazon Transcribe le risorse nella Guida generale.AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) Alcune di queste impostazioni predefinite possono essere aumentate su richiesta.

Se abiliti l'accodamento dei processi ma non superi la quota per le richieste simultanee, tutte le richieste vengono elaborate contemporaneamente.

## Abilitazione dell’accodamento dei processi
<a name="job-queueing-how"></a>

È possibile abilitare l'accodamento dei lavori utilizzando **Console di gestione AWS**AWS CLI****, o **AWS SDKs**; vedere quanto segue per alcuni esempi; vedere quanto segue per esempi:

### Console di gestione AWS
<a name="queueing-console-batch"></a>

1. Accedi alla [Console di gestione AWS](https://console.aws.amazon.com/transcribe/).

1. Nel riquadro di navigazione, scegli **Processi di trascrizione**, quindi seleziona **Crea processo** (in alto a destra). Si aprirà la pagina **Specifica i dettagli del processo**.

1. Nella casella **Impostazioni processo**, c'è un pannello di **impostazioni aggiuntive**. Se espandi questo pannello, puoi selezionare la casella **Aggiungi alla coda dei processi** per abilitare l'accodamento dei processi.  
![\[Amazon Transcribe schermata della console: la pagina «specifica i dettagli del lavoro».\]](http://docs.aws.amazon.com/it_it/transcribe/latest/dg/images/jobqueueing.png)

1. Compila tutti i campi che desideri includere nella pagina **Specifica i dettagli del processo**, quindi seleziona **Avanti**. Verrà visualizzata la **pagina Configura processo - *opzionale***.

1. Seleziona **Crea processo** per eseguire il processo di trascrizione. 

### AWS CLI
<a name="queueing-cli"></a>

Questo esempio utilizza il [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando e il `job-execution-settings` parametro con il sottoparametro. `AllowDeferredExecution` Tieni presente che quando si include `AllowDeferredExecution` nella richiesta, si dovrà includere anche `DataAccessRoleArn`.

Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_JobExecutionSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_JobExecutionSettings.html).

```
aws transcribe start-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job \
--media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \
--output-bucket-name amzn-s3-demo-bucket \
--output-key my-output-files/ \
--language-code en-US \
--job-execution-settings AllowDeferredExecution=true,DataAccessRoleArn=arn:aws:iam::111122223333:role/ExampleRole
```

Ecco un altro esempio di utilizzo del [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)comando e un corpo della richiesta che abilita l'accodamento.

```
aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://my-first-queueing-request.json
```

Il file *my-first-queueing-request.json* contiene il seguente corpo della richiesta.

```
{
  "TranscriptionJobName": "my-first-transcription-job",
  "Media": {
        "MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
  },
  "OutputBucketName": "amzn-s3-demo-bucket",
  "OutputKey": "my-output-files/", 
  "LanguageCode": "en-US",
  "JobExecutionSettings": {
        "AllowDeferredExecution": true,
        "DataAccessRoleArn": "arn:aws:iam::111122223333:role/ExampleRole"
  }
}
```

### AWS SDK per Python (Boto3)
<a name="queueing-python-batch"></a>

[Questo esempio utilizza AWS SDK per Python (Boto3) per abilitare l'accodamento dei lavori utilizzando l'`AllowDeferredExecution`argomento per il metodo start\$1transcription\$1job.](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) Tieni presente che quando si include `AllowDeferredExecution` nella richiesta, si dovrà includere anche `DataAccessRoleArn`. Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_JobExecutionSettings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_JobExecutionSettings.html).

Per ulteriori esempi di utilizzo dello scenario e degli esempi tra AWS SDKs servizi, inclusi quelli relativi a specifiche funzionalità, consultate il capitolo. [Esempi di codice per l'utilizzo di Amazon Transcribe AWS SDKs](service_code_examples.md)

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-queueing-request"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
transcribe.start_transcription_job(
    TranscriptionJobName = job_name,
    Media = {
        'MediaFileUri': job_uri
    },
    OutputBucketName = 'amzn-s3-demo-bucket',
    OutputKey = 'my-output-files/', 
    LanguageCode = 'en-US', 
    JobExecutionSettings = {
        'AllowDeferredExecution': True,
        'DataAccessRoleArn': 'arn:aws:iam::111122223333:role/ExampleRole'
   }
)

while True:
    status = transcribe.get_transcription_job(TranscriptionJobName = job_name)
    if status['TranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)
```

È possibile visualizzare lo stato di avanzamento di un lavoro in coda tramite Console di gestione AWS o inviando una richiesta. [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetTranscriptionJob.html) Quando un processo è in coda, lo `Status` è `QUEUED`. Lo stato cambia in `IN_PROGRESS` quando il processo viene avviato, e quindi cambia in `COMPLETED` o `FAILED` al termine dell'elaborazione.