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 a la 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 Límites de Kinesis Video Streams.
importante
Si se produce un error después de invocar una API de contenido multimedia archivado 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 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"
}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 recuperar el contenido multimedia. 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. La longitud máxima es 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 HTTP 200.
La respuesta devuelve los siguientes encabezados HTTP.
- ContentType
-
El tipo de contenido del medio solicitado.
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128.
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
GetMediaForFragmentListla convocatoria también incluyen las siguientes etiquetas Matroska (MKV) 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 del lado del productor.
Si se produce una excepción, se incluirán las siguientes etiquetas:
-
AWS_KINESISVIDEO_FRAGMENT_NUMBER: 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 Límites de Kinesis Video Streams.
Código de estado HTTP: 400
- InvalidArgumentException
-
Un parámetro específico supera sus restricciones, no se admite o no se puede usar.
Código de estado HTTP: 400
- NotAuthorizedException
-
Código de estado: 403. La persona que llama no está autorizada a realizar ninguna operación en la transmisión en cuestión o el token ha caducado.
Código de estado HTTP: 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.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:
