ListFragments - Amazon Kinesis Video Streams
Syntaxe de la requêteURIParamètres de demandeCorps de la requêteSyntaxe de la réponseEléments de réponseErreursconsultez aussi

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

Renvoie une liste d'Fragmentobjets 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 le GetDataEndpoint API pour obtenir un point de terminaison. Envoyez ensuite les ListFragments demandes à ce point de terminaison à l'aide du paramètre --endpoint-url.

Important

Si une erreur se produit après avoir invoqué un API média archivé par Kinesis Video Streams, outre HTTP le code d'état et le corps de la réponse, elle inclut les informations suivantes :

  • x-amz-ErrorTypeHTTPen-tête : contient un type d'erreur plus spécifique en plus de ce que fournit le code d'HTTPétat.

  • x-amz-RequestIdHTTPen-tête : si vous souhaitez signaler un problème à AWS, l'équipe d'assistance peut mieux diagnostiquer le problème si elle reçoit l'identifiant de demande.

Le code d'HTTPétat 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.

Syntaxe de la requête

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"
}

URIParamètres de demande

La demande n'utilise aucun URI paramètre.

Corps de la requête

La demande accepte les données suivantes au JSON format suivant.

FragmentSelector

Décrit la plage d'horodatage et l'origine de l'horodatage de la plage de fragments à renvoyer.

Note

Cela n'est requis que lorsque le NextToken n'est pas transmis dans leAPI.

Type : objet FragmentSelector

Obligatoire : non

MaxResults

Nombre total de fragments à renvoyer. Si le nombre total de fragments disponibles est supérieur à la valeur spécifiée dansmax-results, un ListFragments: 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

Jeton permettant de spécifier où commencer la pagination. Il s'agit du ListFragments: NextToken d'une réponse précédemment tronquée.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 4096.

Modèle : [a-zA-Z0-9+/]+={0,2}

Obligatoire : non

StreamARN

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 : String

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

Nom du flux à partir duquel récupérer une liste de fragments. Spécifiez ce paramètre ou le StreamARN paramètre.

Type : String

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.

Modèle : [a-zA-Z0-9_.-]+

Obligatoire : non

Syntaxe de la réponse

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

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

Les données suivantes sont renvoyées sous JSON forme formatée par le service.

Fragments

Liste des Fragment 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

NextToken

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 : String

Contraintes de longueur : longueur minimum de 1. Longueur maximum de 4096.

Modèle : [a-zA-Z0-9+/]+={0,2}

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

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.

HTTPCode de statut : 400

InvalidArgumentException

Un paramètre spécifié dépasse ses restrictions, n'est pas pris en charge ou ne peut pas être utilisé.

HTTPCode de statut : 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é.

HTTPCode de statut : 401

ResourceNotFoundException

GetImagesgénère cette erreur lorsque Kinesis Video Streams ne trouve pas le flux que vous avez spécifié.

GetHLSStreamingSessionURLet 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.

HTTPCode de statut : 404

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :