GetMediaForFragmentList - Amazon Kinesis Video Streams
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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

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

nota

Primero debe llamar a laGetDataEndpoint API para obtener un punto final. A continuación, envíe lasGetMediaForFragmentList solicitudes a este punto final mediante el parámetro --endpoint-url.

Para conocer los límites, consulte los límites de Kinesis Video Streams.

importante

Si se produce un error después de invocar una API multimedia archivada 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-ErrorTypeEncabezado HTTP: contiene un tipo de error más específico, además del que proporciona el código de estado HTTP.

  • x-amz-RequestIdEncabezado HTTP: si quieres informar de un problemaAWS, 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 corregir y en qué condiciones, así como para proporcionar información sobre las acciones que el programador del cliente podría necesitar tomar para volver a intentarlo correctamente.

Para obtener más información, consulte la sección Errores al final de este tema, así como los errores comunes.

Sintaxis de la solicitud

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

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

Parámetros de solicitud del URI

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

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

Fragments

Una lista del número de fragmentos para los que se van a recuperar los archivos multimedia. Estos valores se recuperan conListFragments.

Tipo: matriz de cadenas

Miembros de la matriz: número mínimo de 1 elemento. Número máximo de 1000 elementos.

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128 caracteres.

Patrón: ^[0-9]+$

Obligatorio: sí

StreamARN

El nombre de recurso de Amazon (ARN) de la transmisión desde la que se leerá el fragmento multimedia. Especifique este parámetro o elStreamName 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

El nombre de la transmisión desde la que se van a recuperar los fragmentos multimedia. Especifique este parámetro o elStreamARN 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

HTTP/1.1 200
Content-Type: ContentType

Payload

Elementos de respuesta

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

La respuesta devuelve los siguientes encabezados HTTP.

ContentType

El tipo de contenido de los medios solicitados.

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128 caracteres.

Patrón: ^[a-zA-Z0-9_\.\-]+$

La respuesta devuelve lo siguiente como el cuerpo HTTP.

Payload

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. Los fragmentos que Kinesis Video Streams devuelve en laGetMediaForFragmentList llamada también incluyen las siguientes etiquetas Matroska (MKV) adicionales:

  • AWS_KINESISVIDEO_FRAGMENT_NUMBER: el número de fragmento devuelto en el bloque.

  • AWS_KINESISVIDEO_SERVER_SIDE_TIMESTAMP: marca de tiempo del fragmento en el lado del servidor.

  • AWS_KINESISVIDEO_PRODUCER_SIDE_TIMESTAMP: marca de tiempo del fragmento en el lado 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

  • AWS_KINESISVIDEO_EXCEPTION_MESSAGE: descripción textual de la excepción

Errores

Para obtener información sobre los errores comunes a todas las acciones, consulteErrores comunes.

ClientLimitExceededException

Kinesis Video Streams ha limitado la solicitud porque ha superado un límite. Intenta hacer la llamada más tarde. Para obtener información acerca de los límites, consulte los límites de Kinesis Video Streams.

Código de estado HTTP: 400

InvalidArgumentException

Un parámetro especificado supera sus restricciones, no se admite o no se puede utilizar.

Código de estado HTTP: 400

NotAuthorizedException

Código de estado: 403, la persona que llama no está autorizada a realizar una operación en la transmisión dada o el token ha caducado.

Código de estado HTTP: 401

ResourceNotFoundException

GetImagesgenerará este error cuando Kinesis Video Streams no pueda encontrar la transmisión que especificó.

GetHLSStreamingSessionURLyGetDASHStreamingSessionURL genera este error siLIVE_REPLAY se solicita una sesión con unPlaybackMode deON_DEMAND o para una transmisión que no tiene fragmentos dentro del intervalo de tiempo solicitado, o siLIVE se solicita una sesión con unPlaybackMode de para una transmisión que no tiene fragmentos en los últimos 30 segundos.

Código de estado HTTP: 404

Véase también

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: