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 el número de fragmento) de los datos archivados en una transmisión de vídeo de Amazon Kinesis.
nota
Primero debe llamar al GetDataEndpoint API para obtener un punto de enlace. A continuación, envíe las GetMediaForFragmentList solicitudes a este punto final mediante el parámetro --endpoint-url.
Para conocer los límites, consulte las cuotas de Kinesis Video Streams.
importante
Si se produce un error después de invocar un API medio archivado de Kinesis Video Streams, además del código de estado y HTTP el cuerpo de la respuesta, se incluye la siguiente información:
-
x-amz-ErrorTypeHTTPencabezado: contiene un tipo de error más específico además del que proporciona el código de HTTP estado. -
x-amz-RequestIdHTTPencabezado: si desea informar de un problema AWS, el equipo de soporte puede diagnosticar mejor el problema si se le proporciona el identificador de solicitud.
Tanto el código de HTTP estado 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.
Sintaxis de la solicitud
POST /getMediaForFragmentList HTTP/1.1
Content-type: application/json
{
"Fragments": [ "string" ],
"StreamARN": "string",
"StreamName": "string"
}URIParámetros de solicitud
La solicitud no utiliza ningún URI parámetro.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en JSON formato.
- Fragments
-
Una lista del número de fragmentos de los que se van a recuperar los medios. Puede recuperar estos valores conListFragments.
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 1000 elementos.
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
^[0-9]+$Obligatorio: sí
- StreamARN
-
El nombre del recurso de Amazon (ARN) de la transmisión desde la que se van a recuperar los fragmentos multimedia. Especifique este parámetro o el
StreamNamepará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 secuencia desde la que se van a recuperar los fragmentos multimedia. Especifique este parámetro o el
StreamARNpará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
PayloadElementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.
La respuesta devuelve los siguientes HTTP encabezados.
- ContentType
-
El tipo de contenido del medio solicitado.
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
^[a-zA-Z0-9_\.\-]+$
La respuesta devuelve lo siguiente como HTTP cuerpo.
- 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
GetMediaForFragmentListla convocatoria también incluyen las siguientes etiquetas MKV Matroska () adicionales:-
AWS_ _ KINESISVIDEO FRAGMENT _ NUMBER - Número de fragmento devuelto en el fragmento.
-
AWS_ _ KINESISVIDEO _ SERVER SIDE _ TIMESTAMP - Marca de tiempo del fragmento en el servidor.
-
AWS_ _ _ KINESISVIDEO PRODUCER SIDE _ TIMESTAMP - Marca de tiempo del fragmento por parte 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 error.
-
AWS_ KINESISVIDEO _ EXCEPTION _MESSAGE: descripción textual de la excepción.
-
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- 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.
HTTPCódigo de estado: 400
- InvalidArgumentException
-
Un parámetro específico supera sus restricciones, no se admite o no se puede usar.
HTTPCódigo de estado: 400
- NotAuthorizedException
-
Código de estado: 403, la persona que llama no está autorizada a realizar ninguna operación en la transmisión determinada o el token ha caducado.
HTTPCódigo de estado: 401
- ResourceNotFoundException
-
GetImagesmostrará este error cuando Kinesis Video Streams no encuentre la transmisión que ha especificado.GetHLSStreamingSessionURLyGetDASHStreamingSessionURLarroja este error si una sesión con unPlaybackModedeON_DEMANDoLIVE_REPLAYse solicita una transmisión que no tiene fragmentos en el intervalo de tiempo solicitado, o siLIVEse solicita una sesión con unPlaybackModede o para una transmisión que no tiene fragmentos en los últimos 30 segundos.HTTPCódigo de estado: 404
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
