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.

# ListFragments
<a name="API_reader_ListFragments"></a>

Devuelve una lista de [Fragment](API_reader_Fragment.md) objetos del flujo y el rango de marcas de tiempo especificados dentro de los datos archivados.

Al final, enumerar los fragmentos es coherente. Esto significa que, aunque el productor reciba un acuse de recibo de que un fragmento se conserva, es posible que el resultado no se devuelva inmediatamente al solicitarlo. `ListFragments` Sin embargo, los resultados suelen estar disponibles en menos de un segundo.

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

**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_ListFragments_RequestSyntax"></a>

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

{
   "FragmentSelector": { 
      "FragmentSelectorType": "{{string}}",
      "TimestampRange": { 
         "EndTimestamp": {{number}},
         "StartTimestamp": {{number}}
      }
   },
   "MaxResults": {{number}},
   "NextToken": "{{string}}",
   "StreamARN": "{{string}}",
   "StreamName": "{{string}}"
}
```

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

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

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

La solicitud acepta los siguientes datos en formato JSON.

 ** [FragmentSelector](#API_reader_ListFragments_RequestSyntax) **   <a name="KinesisVideo-reader_ListFragments-request-FragmentSelector"></a>
Describe el rango de marcas de tiempo y el origen de las marcas de tiempo del rango de fragmentos que se van a devolver.  
Esto solo es necesario cuando `NextToken` no se incluye en la API.
Tipo: objeto [FragmentSelector](API_reader_FragmentSelector.md)  
Obligatorio: no

 ** [MaxResults](#API_reader_ListFragments_RequestSyntax) **   <a name="KinesisVideo-reader_ListFragments-request-MaxResults"></a>
El número total de fragmentos que se van a devolver. Si el número total de fragmentos disponibles es superior al valor especificado en`max-results`, NextToken se proporciona un [ListFragments:](#KinesisVideo-reader_ListFragments-response-NextToken) en el resultado, que puede utilizar para reanudar la paginación.  
El valor predeterminado es 100.  
Tipo: largo  
Rango válido: valor mínimo de 1. Valor máximo de 1000.  
Obligatorio: no

 ** [NextToken](#API_reader_ListFragments_RequestSyntax) **   <a name="KinesisVideo-reader_ListFragments-request-NextToken"></a>
Un token destinado a especificar dónde iniciar la paginación. Este es el [ListFragments: NextToken](#KinesisVideo-reader_ListFragments-response-NextToken) de una respuesta previamente truncada.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 4096 caracteres.  
Patrón: `[a-zA-Z0-9+/]+={0,2}`   
Obligatorio: no

 ** [StreamARN](#API_reader_ListFragments_RequestSyntax) **   <a name="KinesisVideo-reader_ListFragments-request-StreamARN"></a>
El nombre del recurso de Amazon (ARN) de la transmisión desde la que se va a recuperar una lista de fragmentos. 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_ListFragments_RequestSyntax) **   <a name="KinesisVideo-reader_ListFragments-request-StreamName"></a>
El nombre de la secuencia desde la que se va a recuperar una lista de fragmentos. 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_ListFragments_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "Fragments": [ 
      { 
         "FragmentLengthInMilliseconds": number,
         "FragmentNumber": "string",
         "FragmentSizeInBytes": number,
         "ProducerTimestamp": number,
         "ServerTimestamp": number
      }
   ],
   "NextToken": "string"
}
```

## Elementos de respuesta
<a name="API_reader_ListFragments_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.

 ** [Fragments](#API_reader_ListFragments_ResponseSyntax) **   <a name="KinesisVideo-reader_ListFragments-response-Fragments"></a>
Una lista de [Fragment](API_reader_Fragment.md) objetos archivados de la secuencia que cumplen los criterios del selector. Los resultados no están en un orden específico, ni siquiera en todas las páginas.  
Si no hay fragmentos en la secuencia que cumplan los criterios de selección, se devuelve una lista vacía.  
Tipo: matriz de objetos [Fragment](API_reader_Fragment.md)

 ** [NextToken](#API_reader_ListFragments_ResponseSyntax) **   <a name="KinesisVideo-reader_ListFragments-response-NextToken"></a>
Si la lista devuelta está truncada, la operación devuelve este token para usarlo en la siguiente página de resultados. Este valor se produce `null` cuando no hay más resultados que devolver.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 4096 caracteres.  
Patrón: `[a-zA-Z0-9+/]+={0,2}` 

## Errores
<a name="API_reader_ListFragments_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_ListFragments_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/ListFragments) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/ListFragments)