GetMediaForFragmentList - Amazon Kinesis Video Streams
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe 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.

GetMediaForFragmentList

Obtient le contenu multimédia d'une liste de fragments (spécifiée par numéro de fragment) à partir des données archivées d'un flux vidéo Amazon Kinesis.

Note

Vous devez d'abord appeler l'GetDataEndpointAPI pour obtenir un point de terminaison. Envoyez ensuite les GetMediaForFragmentList demandes à ce point de terminaison à l'aide du paramètre --endpoint-url.

Pour connaître les limites, consultez la section Limites de Kinesis Video Streams.

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-ErrorTypeEn-tête HTTP : contient un type d'erreur plus spécifique en plus de ce que fournit le code d'état HTTP.

  • x-amz-RequestIdEn-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.

Syntaxe de la demande

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

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

Paramètres de demande URI

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

Corps de la demande

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

Fragments

Liste du nombre de fragments pour lesquels vous souhaitez récupérer le contenu multimédia. Vous pouvez récupérer ces valeurs avecListFragments.

Type : tableau de chaînes

Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 1 000 éléments.

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

Modèle : ^[0-9]+$

Obligatoire : oui

StreamARN

Nom de ressource Amazon (ARN) du flux à partir duquel récupérer le fragment multimédia. 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

Nom du flux à partir duquel récupérer le fragment multimédia. 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

HTTP/1.1 200
Content-Type: ContentType

Payload

Eléments de réponse

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

La réponse renvoie les en-têtes HTTP suivants.

ContentType

Type de contenu du média demandé.

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

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

La réponse renvoie ce qui suit en tant que corps HTTP.

Payload

La charge utile renvoyée par Kinesis Video Streams est une séquence de segments provenant du flux spécifié. Pour plus d'informations sur les segments, consultez PutMedia. Les segments renvoyés par Kinesis Video Streams lors de GetMediaForFragmentList l'appel incluent également les balises Matroska (MKV) supplémentaires suivantes :

  • AWS_KINESISVIDEO_FRAGMENT_NUMBER - Numéro de fragment renvoyé dans le fragment.

  • AWS_KINESISVIDEO_SERVER_SIDE_TIMESTAMP - Horodatage du fragment côté serveur.

  • AWS_KINESISVIDEO_PRODUCER_SIDE_TIMESTAMP - Horodatage du fragment côté producteur.

Les balises suivantes seront incluses en cas d'exception :

  • AWS_KINESISVIDEO_FRAGMENT_NUMBER - Numéro du fragment qui a généré l'exception.

  • AWS_KINESISVIDEO_EXCEPTION_ERROR_CODE - Le code entier de l'erreur.

  • AWS_KINESISVIDEO_EXCEPTION_MESSAGE - Description textuelle de l'exception.

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 Kinesis Video Streams Limits.

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

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.

Code d’état HTTP : 404

consultez aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :