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

# ListTranscriptionJobs
<a name="API_ListTranscriptionJobs"></a>

Fornisce un elenco di processi di trascrizione che corrispondono ai criteri specificati. Se nessun criterio è specificato, vengono restituiti tutti i processi di trascrizione.

Per ottenere informazioni dettagliate su uno specifico processo di trascrizione utilizza l'[GetTranscriptionJob](API_GetTranscriptionJob.md)operazione.

## Sintassi della richiesta
<a name="API_ListTranscriptionJobs_RequestSyntax"></a>

```
{
   "JobNameContains": "{{string}}",
   "MaxResults": {{number}},
   "NextToken": "{{string}}",
   "Status": "{{string}}"
}
```

## Parametri della richiesta
<a name="API_ListTranscriptionJobs_RequestParameters"></a>

Per informazioni sui parametri comuni a tutte le azioni, vedere [Parametri comuni](CommonParameters.md).

La richiesta accetta i seguenti dati in formato JSON.

 ** [JobNameContains](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-JobNameContains"></a>
Restituisce solo i lavori di trascrizione che contengono la stringa specificata. La ricerca non fa distinzione tra maiuscole e minuscole.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 200.  
Modello: `^[0-9a-zA-Z._-]+`   
Required: No

 ** [MaxResults](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-MaxResults"></a>
Il numero massimo di lavori di trascrizione da restituire in ogni pagina di risultati. Se il numero di risultati è inferiore al valore specificato, vengono restituiti solo i risultati effettivi. Se non specifichi un valore, viene utilizzato un valore predefinito di 5.  
Tipo: integer  
Intervallo valido: valore minimo di 1. valore massimo pari a 100.  
Required: No

 ** [NextToken](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-NextToken"></a>
Se la tua`ListTranscriptionJobs` richiesta restituisce più risultati di quelli che possono essere visualizzati,`NextToken` viene visualizzato nella risposta con una stringa associata. Per visualizzare la pagina successiva dei risultati, copia questa stringa e ripeti la richiesta, incluso`NextToken` il valore della stringa copiata. Ripeti se necessario per visualizzare tutti i risultati.  
Tipo: String  
Limitazioni della lunghezza: lunghezza massima di 8192.  
Modello: `.+`   
Required: No

 ** [Status](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-Status"></a>
Restituisce solo processi di trascrizione con lo stato specificato. I lavori vengono ordinati in base alla data di creazione, con il lavoro più recente per primo. Se non lo includi`Status`, vengono restituiti tutti i lavori di trascrizione.  
Tipo: String  
Valori validi: ` QUEUED | IN_PROGRESS | FAILED | COMPLETED`   
Required: No

## Sintassi della risposta
<a name="API_ListTranscriptionJobs_ResponseSyntax"></a>

```
{
   "NextToken": "string",
   "Status": "string",
   "TranscriptionJobSummaries": [ 
      { 
         "CompletionTime": number,
         "ContentRedaction": { 
            "PiiEntityTypes": [ "string" ],
            "RedactionOutput": "string",
            "RedactionType": "string"
         },
         "CreationTime": number,
         "FailureReason": "string",
         "IdentifiedLanguageScore": number,
         "IdentifyLanguage": boolean,
         "IdentifyMultipleLanguages": boolean,
         "LanguageCode": "string",
         "LanguageCodes": [ 
            { 
               "DurationInSeconds": number,
               "LanguageCode": "string"
            }
         ],
         "ModelSettings": { 
            "LanguageModelName": "string"
         },
         "OutputLocationType": "string",
         "StartTime": number,
         "TranscriptionJobName": "string",
         "TranscriptionJobStatus": "string"
      }
   ]
}
```

## Elementi di risposta
<a name="API_ListTranscriptionJobs_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [NextToken](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-NextToken"></a>
Se`NextToken` è presente nella tua risposta, indica che non tutti i risultati vengono visualizzati. Per visualizzare il set successivo di risultati, copia la stringa associata al`NextToken` parametro nell'output dei risultati, quindi esegui nuovamente la richiesta includendo`NextToken` il valore della stringa copiata. Ripeti se necessario per visualizzare tutti i risultati.  
Tipo: String  
Limitazioni della lunghezza: lunghezza massima di 8192.  
Pattern: `.+` 

 ** [Status](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-Status"></a>
Elenca tutti i lavori di trascrizione che hanno lo stato specificato nella richiesta. I lavori vengono ordinati in base alla data di creazione, con il lavoro più recente per primo.  
Tipo: String  
Valori validi: ` QUEUED | IN_PROGRESS | FAILED | COMPLETED` 

 ** [TranscriptionJobSummaries](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-TranscriptionJobSummaries"></a>
Fornisce un riepilogo delle informazioni su ciascun risultato.  
Tipo: matrice di oggetti [TranscriptionJobSummary](API_TranscriptionJobSummary.md)

## Errori
<a name="API_ListTranscriptionJobs_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** BadRequestException **   
La tua richiesta non ha superato uno o più test di convalida. Ciò può verificarsi quando l'entità che stai cercando di eliminare non esiste o se si trova in uno stato non terminale (ad esempio`IN PROGRESS`). Per ulteriori informazioni, consulta il campo del messaggio di eccezione.  
Codice di stato HTTP: 400

 ** InternalFailureException **   
Si è verificato un errore interno. Controlla il messaggio di errore, correggi il problema e riprova la richiesta.  
Codice di stato HTTP: 500

 ** LimitExceededException **   
Hai inviato troppe richieste o il file di input è troppo lungo. Attendi prima di riprovare la richiesta oppure utilizza un file più piccolo e riprova la richiesta.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_ListTranscriptionJobs_SeeAlso"></a>

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/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [SDK AWS per .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [SDK AWS per C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [SDK AWS per Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWSSDK per JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [SDK AWS per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [SDK AWS per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/ListTranscriptionJobs)