As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Fornece uma lista de trabalhos de transcrição que correspondem aos critérios especificados. Se não houver critérios especificados, todas as tarefas de transcrição serão retornadas.

Para obter informações detalhadas sobre uma tarefa de transcrição específica, use a[GetTranscriptionJob](API_GetTranscriptionJob.md) operação.

## Sintaxe da solicitação
<a name="API_ListTranscriptionJobs_RequestSyntax"></a>

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

## Parâmetros de solicitação
<a name="API_ListTranscriptionJobs_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [JobNameContains](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-JobNameContains"></a>
Retorna somente os trabalhos de transcrição que contêm a string especificada. A pesquisa não diferencia maiúsculas de minúsculas.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.  
Padrão: `^[0-9a-zA-Z._-]+`   
Obrigatório: não

 ** [MaxResults](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-MaxResults"></a>
O número máximo de trabalhos de transcrição a serem retornados em cada página de resultados. Se houver menos resultados do que o valor especificado, somente os resultados reais serão retornados. Se você não especificar um valor, será usado um padrão de 5.  
Tipo: inteiro  
Faixa válida: valor mínimo de 1. Valor máximo de 100.  
Obrigatório: não

 ** [NextToken](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-NextToken"></a>
Se sua`ListTranscriptionJobs` solicitação retornar mais resultados do que os que podem ser exibidos,`NextToken` será exibida na resposta com uma string associada. Para obter a próxima página de resultados, copie essa string e repita sua solicitação, inclusive`NextToken` com o valor da string copiada. Repita conforme necessário para ver todos os resultados.  
Tipo: String  
Restrições de tamanho: tamanho máximo de 8192.  
Padrão: `.+`   
Obrigatório: não

 ** [Status](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-Status"></a>
Retorna somente trabalhos de transcrição com o status especificado. Os trabalhos são ordenados por data de criação, com o trabalho mais novo primeiro. Se você não incluir`Status`, todos os trabalhos de transcrição serão devolvidos.  
Tipo: String  
Valores válidos:` QUEUED | IN_PROGRESS | FAILED | COMPLETED`   
Obrigatório: não

## Sintaxe da resposta
<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"
      }
   ]
}
```

## Elementos de resposta
<a name="API_ListTranscriptionJobs_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.

Os seguintes dados são retornados no formato JSON pelo serviço.

 ** [NextToken](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-NextToken"></a>
Se`NextToken` estiver presente em sua resposta, isso indica que nem todos os resultados são exibidos. Para ver o próximo conjunto de resultados, copie a string associada ao`NextToken` parâmetro na saída de resultados e execute sua solicitação novamente, inclusive`NextToken` com o valor da string copiada. Repita conforme necessário para ver todos os resultados.  
Tipo: String  
Restrições de tamanho: tamanho máximo de 8192.  
Padrão: `.+` 

 ** [Status](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-Status"></a>
Lista todos os trabalhos de transcrição que têm o status especificado em sua solicitação. Os trabalhos são ordenados por data de criação, com o trabalho mais novo primeiro.  
Tipo: String  
Valores válidos:` QUEUED | IN_PROGRESS | FAILED | COMPLETED` 

 ** [TranscriptionJobSummaries](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-TranscriptionJobSummaries"></a>
Fornece um resumo das informações sobre cada resultado.  
Tipo: matriz de objetos [TranscriptionJobSummary](API_TranscriptionJobSummary.md)

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

Para obter informações sobre os erros comuns a todas as ações, consulte[Erros comuns](CommonErrors.md).

 ** BadRequestException **   
Sua solicitação não passou em um ou mais testes de validação. Isso pode ocorrer quando a entidade que você está tentando excluir não existe ou está em um estado não terminal (como`IN PROGRESS`). Consulte o campo da mensagem de exceção para obter mais informações.  
Código de status HTTP: 400

 ** InternalFailureException **   
Ocorreu um erro interno. Verifique a mensagem de erro, corrija o problema e tente fazer sua solicitação novamente.  
Código de status HTTP: 500

 ** LimitExceededException **   
Você enviou muitas solicitações ou seu arquivo de entrada é muito longo. Aguarde antes de tentar novamente sua solicitação ou use um arquivo menor e tente fazer sua solicitação novamente.  
Código de status HTTP: 400

## Consulte também
<a name="API_ListTranscriptionJobs_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/ListTranscriptionJobs)