Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Renvoie une liste d'[Fragment](API_reader_Fragment.md)objets du flux et de la plage d'horodatage spécifiés dans les données archivées.

La liste des fragments est finalement cohérente. Cela signifie que même si le producteur reçoit un accusé de réception indiquant qu'un fragment est persistant, le résultat risque de ne pas être renvoyé immédiatement à la suite d'une demande adressée à. `ListFragments` Cependant, les résultats sont généralement disponibles en moins d'une seconde.

**Note**  
Vous devez d'abord appeler l'`GetDataEndpoint`API pour obtenir un point de terminaison. Envoyez ensuite les `ListFragments` demandes à ce point de terminaison à l'aide du paramètre [--endpoint-url](https://docs.aws.amazon.com/cli/latest/reference/). 

**Important**  
Si une erreur est générée après avoir appelé une API multimédia archivée Kinesis Video Streams, outre le code d'état HTTP et le corps de la réponse, elle inclut les informations suivantes :   
 `x-amz-ErrorType`En-tête HTTP : contient un type d'erreur plus spécifique en plus de ce que fournit le code d'état HTTP. 
 `x-amz-RequestId`En-tête HTTP : si vous souhaitez signaler un problème à AWS, l'équipe d'assistance pourra mieux diagnostiquer le problème si vous lui donnez l'ID de demande.
Le code d'état HTTP et l' ErrorType en-tête peuvent être utilisés pour prendre des décisions programmatiques quant à savoir si les erreurs peuvent être réessayées et dans quelles conditions, ainsi que pour fournir des informations sur les actions que le programmeur client devra peut-être entreprendre pour réessayer avec succès.  
Pour plus d'informations, consultez la section **Erreurs** au bas de cette rubrique, ainsi que [les erreurs courantes](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html). 

## Syntaxe de la demande
<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}}"
}
```

## Paramètres de demande URI
<a name="API_reader_ListFragments_RequestParameters"></a>

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_reader_ListFragments_RequestBody"></a>

Cette demande accepte les données suivantes au format JSON.

 ** [FragmentSelector](#API_reader_ListFragments_RequestSyntax) **   <a name="KinesisVideo-reader_ListFragments-request-FragmentSelector"></a>
Décrit la plage d'horodatage et l'origine de l'horodatage de la plage de fragments à renvoyer.  
Cela n'est requis que lorsque le `NextToken` n'est pas transmis dans l'API.
Type : objet [FragmentSelector](API_reader_FragmentSelector.md)  
Obligatoire : non

 ** [MaxResults](#API_reader_ListFragments_RequestSyntax) **   <a name="KinesisVideo-reader_ListFragments-request-MaxResults"></a>
Nombre total de fragments à renvoyer. Si le nombre total de fragments disponibles est supérieur à la valeur spécifiée dans`max-results`, un [ListFragments: NextToken](#KinesisVideo-reader_ListFragments-response-NextToken) est fourni dans la sortie que vous pouvez utiliser pour reprendre la pagination.  
La valeur par défaut est 100.  
Type : Long  
Plage valide : valeur minimum de 1. La valeur maximale est 1 000.  
Obligatoire : non

 ** [NextToken](#API_reader_ListFragments_RequestSyntax) **   <a name="KinesisVideo-reader_ListFragments-request-NextToken"></a>
Jeton permettant de spécifier où commencer la pagination. Il s'agit du [ListFragments: NextToken](#KinesisVideo-reader_ListFragments-response-NextToken) d'une réponse précédemment tronquée.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 4096.  
Modèle : `[a-zA-Z0-9+/]+={0,2}`   
Obligatoire : non

 ** [StreamARN](#API_reader_ListFragments_RequestSyntax) **   <a name="KinesisVideo-reader_ListFragments-request-StreamARN"></a>
Le nom de ressource Amazon (ARN) du flux à partir duquel récupérer une liste de fragments. Spécifiez ce paramètre ou le `StreamName` paramètre.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.  
Modèle : `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`   
Obligatoire : non

 ** [StreamName](#API_reader_ListFragments_RequestSyntax) **   <a name="KinesisVideo-reader_ListFragments-request-StreamName"></a>
Nom du flux à partir duquel récupérer une liste de fragments. Spécifiez ce paramètre ou le `StreamARN` paramètre.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.  
Modèle : `[a-zA-Z0-9_.-]+`   
Obligatoire : non

## Syntaxe de la réponse
<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"
}
```

## Eléments de réponse
<a name="API_reader_ListFragments_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [Fragments](#API_reader_ListFragments_ResponseSyntax) **   <a name="KinesisVideo-reader_ListFragments-response-Fragments"></a>
Liste des [Fragment](API_reader_Fragment.md) objets archivés du flux qui répondent aux critères de sélection. Les résultats ne sont pas présentés dans un ordre précis, même sur plusieurs pages.  
Si aucun fragment du flux ne répond aux critères de sélection, une liste vide est renvoyée.  
Type : tableau d’objets [Fragment](API_reader_Fragment.md)

 ** [NextToken](#API_reader_ListFragments_ResponseSyntax) **   <a name="KinesisVideo-reader_ListFragments-response-NextToken"></a>
Si la liste renvoyée est tronquée, l'opération renvoie ce jeton à utiliser pour récupérer la page de résultats suivante. Cette valeur est indiquée `null` lorsqu'il n'y a plus de résultats à renvoyer.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 4096.  
Modèle : `[a-zA-Z0-9+/]+={0,2}` 

## Erreurs
<a name="API_reader_ListFragments_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** ClientLimitExceededException **   
Kinesis Video Streams a limité la demande car vous avez dépassé une limite. Essayez de passer l'appel plus tard. Pour plus d'informations sur les limites, consultez la section [Quotas Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html).  
Code d’état HTTP : 400

 ** InvalidArgumentException **   
Un paramètre spécifié dépasse ses restrictions, n'est pas pris en charge ou ne peut pas être utilisé.  
Code d’état HTTP : 400

 ** NotAuthorizedException **   
Code d'état : 403, l'appelant n'est pas autorisé à effectuer une opération sur le flux donné, ou le jeton a expiré.  
Code d'état HTTP : 401

 ** ResourceNotFoundException **   
 `GetImages`génère cette erreur lorsque Kinesis Video Streams ne trouve pas le flux que vous avez spécifié.  
 `GetHLSStreamingSessionURL`et `GetDASHStreamingSessionURL` génère cette erreur si une session avec un `PlaybackMode` de `ON_DEMAND` ou `LIVE_REPLAY` est demandée pour un flux qui ne contient aucun fragment dans la plage de temps demandée, ou si une session avec un `PlaybackMode` of `LIVE` est demandée pour un flux qui ne contient aucun fragment au cours des 30 dernières secondes.  
Code d’état HTTP :404

## Voir aussi
<a name="API_reader_ListFragments_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK pour C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/ListFragments) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/ListFragments)