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.

# GetMediaForFragmentList
<a name="API_reader_GetMediaForFragmentList"></a>

Obtiene el contenido multimedia de una lista de fragmentos (especificada por el número de fragmento) de los datos archivados en una transmisión de vídeo de Amazon Kinesis.

**nota**  
Primero debe llamar a la `GetDataEndpoint` API para obtener un punto de enlace. A continuación, envíe las `GetMediaForFragmentList` solicitudes a este punto final mediante el parámetro [--endpoint-url](https://docs.aws.amazon.com/cli/latest/reference/). 

Para conocer los límites, consulte las cuotas de [Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html).

**importante**  
Si se produce un error después de invocar una API de contenido multimedia archivado de Kinesis Video Streams, además del código de estado HTTP y el cuerpo de la respuesta, se incluye la siguiente información:   
 `x-amz-ErrorType`Encabezado HTTP: contiene un tipo de error más específico además del que proporciona el código de estado HTTP. 
 `x-amz-RequestId`Encabezado HTTP: si quieres informar de un problema AWS, el equipo de soporte puede diagnosticar mejor el problema si se le proporciona el identificador de la solicitud.
Tanto el código de estado HTTP como el ErrorType encabezado se pueden utilizar para tomar decisiones programáticas sobre si los errores se pueden volver a cometer y en qué condiciones, así como para proporcionar información sobre las medidas que el programador del cliente podría tener que tomar para volver a intentarlo correctamente.  
[Para obtener más información, consulte la sección de **errores** al final de este tema, así como la sección Errores comunes.](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html) 

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

```
POST /getMediaForFragmentList HTTP/1.1
Content-type: application/json

{
   "Fragments": [ "{{string}}" ],
   "StreamARN": "{{string}}",
   "StreamName": "{{string}}"
}
```

## Parámetros de solicitud del URI
<a name="API_reader_GetMediaForFragmentList_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_reader_GetMediaForFragmentList_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [Fragments](#API_reader_GetMediaForFragmentList_RequestSyntax) **   <a name="KinesisVideo-reader_GetMediaForFragmentList-request-Fragments"></a>
Una lista del número de fragmentos para recuperar el contenido multimedia. Estos valores se recuperan con[ListFragments](API_reader_ListFragments.md).  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 1000 elementos.  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.  
Patrón: `^[0-9]+$`   
Obligatorio: sí

 ** [StreamARN](#API_reader_GetMediaForFragmentList_RequestSyntax) **   <a name="KinesisVideo-reader_GetMediaForFragmentList-request-StreamARN"></a>
El nombre del recurso de Amazon (ARN) de la transmisión desde la que se van a recuperar los fragmentos multimedia. Especifique este parámetro o el `StreamName` parámetro.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.  
Patrón: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`   
Obligatorio: no

 ** [StreamName](#API_reader_GetMediaForFragmentList_RequestSyntax) **   <a name="KinesisVideo-reader_GetMediaForFragmentList-request-StreamName"></a>
El nombre de la secuencia desde la que se van a recuperar los fragmentos multimedia. Especifique este parámetro o el `StreamARN` parámetro.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.  
Patrón: `[a-zA-Z0-9_.-]+`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_reader_GetMediaForFragmentList_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-Type: {{ContentType}}

{{Payload}}
```

## Elementos de respuesta
<a name="API_reader_GetMediaForFragmentList_ResponseElements"></a>

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

La respuesta devuelve los siguientes encabezados HTTP.

 ** [ContentType](#API_reader_GetMediaForFragmentList_ResponseSyntax) **   <a name="KinesisVideo-reader_GetMediaForFragmentList-response-ContentType"></a>
El tipo de contenido del medio solicitado.  
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.  
Patrón: `^[a-zA-Z0-9_\.\-]+$` 

La respuesta devuelve lo siguiente como el cuerpo HTTP.

 ** [Payload](#API_reader_GetMediaForFragmentList_ResponseSyntax) **   <a name="KinesisVideo-reader_GetMediaForFragmentList-response-Payload"></a>
La carga útil que devuelve Kinesis Video Streams es una secuencia de fragmentos de la transmisión especificada. Para obtener información sobre los fragmentos, consulte. [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) Los fragmentos que Kinesis Video Streams devuelve en `GetMediaForFragmentList` la convocatoria también incluyen las siguientes etiquetas Matroska (MKV) adicionales:   
+ AWS\_KINESISVIDEO\_FRAGMENT\_NUMBER - Número de fragmento devuelto en el fragmento.
+ AWS\_KINESISVIDEO\_SERVER\_SIDE\_TIMESTAMP - Marca de tiempo del fragmento en el servidor.
+ AWS\_KINESISVIDEO\_PRODUCER\_SIDE\_TIMESTAMP - Marca de tiempo del fragmento por parte del productor.
Si se produce una excepción, se incluirán las siguientes etiquetas:  
+ AWS\_KINESISVIDEO\_FRAGMENT\_NUMBER - El número del fragmento que generó la excepción. 
+ AWS\_KINESISVIDEO\_EXCEPTION\_ERROR\_CODE - El código entero del error. 
+ AWS\_KINESISVIDEO\_EXCEPTION\_MESSAGE - Una descripción textual de la excepción. 

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

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

 ** ClientLimitExceededException **   
Kinesis Video Streams ha limitado la solicitud porque ha superado un límite. Intente realizar la llamada más tarde. Para obtener información sobre los límites, consulte Cuotas de [Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html).  
Código de estado HTTP: 400

 ** InvalidArgumentException **   
Un parámetro específico supera sus restricciones, no se admite o no se puede usar.  
Código de estado HTTP: 400

 ** NotAuthorizedException **   
Código de estado: 403. La persona que llama no está autorizada a realizar ninguna operación en la transmisión en cuestión o el token ha caducado.  
Código de estado HTTP: 401

 ** ResourceNotFoundException **   
 `GetImages`mostrará este error cuando Kinesis Video Streams no encuentre la transmisión que ha especificado.  
 `GetHLSStreamingSessionURL`y `GetDASHStreamingSessionURL` arroja este error si una sesión con un `PlaybackMode` de `ON_DEMAND` o `LIVE_REPLAY` se solicita una transmisión que no tiene fragmentos en el intervalo de tiempo solicitado, o si `LIVE` se solicita una sesión con un `PlaybackMode` de o para una transmisión que no tiene fragmentos en los últimos 30 segundos.  
Código de estado HTTP: 404

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

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) 
+  [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList)