Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Proporciona una lista de trabajos de transcripción que coinciden con los criterios especificados. Si no se especifican criterios, se devuelven todos los trabajos de transcripción.

Para obtener información detallada sobre un trabajo de transcripción específico, utilice la[GetTranscriptionJob](API_GetTranscriptionJob.md) operación.

## Sintaxis de la solicitud
<a name="API_ListTranscriptionJobs_RequestSyntax"></a>

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

## Parámetros de solicitud
<a name="API_ListTranscriptionJobs_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [JobNameContains](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-JobNameContains"></a>
Devuelve solo los trabajos de transcripción que contienen la cadena especificada. La búsqueda no distingue entre mayúsculas y minúsculas.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres.  
Patrón: `^[0-9a-zA-Z._-]+`   
Obligatorio: no

 ** [MaxResults](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-MaxResults"></a>
El número máximo de trabajos de transcripción que se devolverán en cada página de resultados. Si hay menos resultados que el valor especificado, solo se devuelven los resultados reales. Si no especifica un valor, se utiliza un valor predeterminado de 5.  
Tipo: entero  
Rango válido: valor mínimo de 1. Valor máximo de 100.  
Obligatorio: no

 ** [NextToken](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-NextToken"></a>
Si su`ListTranscriptionJobs` solicitud arroja más resultados de los que se pueden mostrar,`NextToken` se muestra en la respuesta con una cadena asociada. Para obtener la siguiente página de resultados, copie esta cadena y repita la solicitud, incluso`NextToken` con el valor de la cadena copiada. Repita el procedimiento según sea necesario para ver todos los resultados.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 8192 caracteres.  
Patrón: `.+`   
Obligatorio: no

 ** [Status](#API_ListTranscriptionJobs_RequestSyntax) **   <a name="transcribe-ListTranscriptionJobs-request-Status"></a>
Devuelve solo trabajos de transcripción con el estado especificado. Los trabajos se ordenan por fecha de creación, con el trabajo más nuevo primero. Si no incluye`Status`, se devolverán todos los trabajos de transcripción.  
Tipo: cadena  
Valores válidos:` QUEUED | IN_PROGRESS | FAILED | COMPLETED`   
Obligatorio: no

## Sintaxis de la respuesta
<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 respuesta
<a name="API_ListTranscriptionJobs_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [NextToken](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-NextToken"></a>
Si`NextToken` está presente en su respuesta, indica que no se muestran todos los resultados. Para ver el siguiente conjunto de resultados, copie la cadena asociada al`NextToken` parámetro en la salida de resultados y, a continuación, vuelva a ejecutar la solicitud, incluso`NextToken` con el valor de la cadena copiada. Repita el procedimiento según sea necesario para ver todos los resultados.  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 8192 caracteres.  
Patrón: `.+` 

 ** [Status](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-Status"></a>
Muestra todos los trabajos de transcripción que tienen el estado especificado en su solicitud. Los trabajos se ordenan por fecha de creación, con el trabajo más nuevo primero.  
Tipo: cadena  
Valores válidos:` QUEUED | IN_PROGRESS | FAILED | COMPLETED` 

 ** [TranscriptionJobSummaries](#API_ListTranscriptionJobs_ResponseSyntax) **   <a name="transcribe-ListTranscriptionJobs-response-TranscriptionJobSummaries"></a>
Proporciona un resumen de la información sobre cada resultado.  
Tipo: Matriz de objetos [TranscriptionJobSummary](API_TranscriptionJobSummary.md)

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

Para obtener información sobre los errores comunes a todas las acciones, consulte[Errores comunes](CommonErrors.md).

 ** BadRequestException **   
Tu solicitud no pasó una o más pruebas de validación. Esto puede ocurrir cuando la entidad que intentas eliminar no existe o si no está en un estado terminal (por ejemplo`IN PROGRESS`). Para obtener más información, consulte el campo del mensaje de excepciones.  
Código de estado HTTP: 400

 ** InternalFailureException **   
Se produjo un error interno. Compruebe el mensaje de error, corrija el problema e inténtelo de nuevo.  
Código de estado HTTP: 500

 ** LimitExceededException **   
Has enviado demasiadas solicitudes o el archivo de entrada es demasiado largo. Espera antes de volver a intentar la solicitud o usa un archivo más pequeño y vuelve a intentarlo.  
Código de estado HTTP: 400

## Véase también
<a name="API_ListTranscriptionJobs_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [AWS SDK para 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) 
+  [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/ListTranscriptionJobs) 
+  [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/ListTranscriptionJobs)