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. # GetClip Descarga un MP4 archivo (clip) que contiene el contenido multimedia archivado bajo demanda de la transmisión de vídeo especificada durante el intervalo de tiempo especificado. StreamName Tanto el parámetro StreamArn como el de StreamArn son opcionales, pero debes especificar el StreamArn StreamName o el StreamArn al invocar esta operación de API. **nota** Primero debes llamar a la `GetDataEndpoint` API para obtener un punto final. A continuación, envíe las `GetClip` solicitudes a este punto final mediante el parámetro [--endpoint-url](https://docs.aws.amazon.com/cli/latest/reference/). Una transmisión de vídeo de Amazon Kinesis tiene los siguientes requisitos para proporcionar datos a través de: MP4 + [Requisitos de pista de reproducción de vídeo](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html). + La retención de datos debe ser mayor o igual que 0. + La pista de vídeo de cada fragmento debe contener los datos privados del códec en la codificación de vídeo avanzada (AVC) para el formato H.264 y en HEVC para el formato H.265. Para obtener más información, consulte la [especificación ISO/IEC MPEG-4 14496-15](https://www.iso.org/standard/55980.html). Si desea obtener más información sobre cómo adaptar datos de transmisiones a un determinado formato, consulte [Referencia de marcas de adaptación de capa de abstracción de red (NAL)](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html). + [La pista de audio (si está presente) de cada fragmento debe contener datos privados del códec en formato AAC ([especificación AAC ISO/IEC 13818-7) o en formato MS](https://www.iso.org/standard/43345.html) Wave.](https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html) Puedes monitorizar la cantidad de datos salientes supervisando la CloudWatch métrica de `GetClip.OutgoingBytes` Amazon. Para obtener información sobre cómo CloudWatch monitorizar Kinesis Video Streams, [consulte Supervisión de Kinesis](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html) Video Streams. Para obtener información sobre precios, consulte Precios [AWS y](https://aws.amazon.com/pricing/) precios de [Amazon Kinesis Video Streams](https://aws.amazon.com/kinesis/video-streams/pricing/). Se aplican cargos por AWS los datos salientes. **importante** Los datos privados del códec (CPD) contenidos en cada fragmento contienen información de inicialización específica del códec, como la velocidad de fotogramas, la resolución y el perfil de codificación, que son necesarios para decodificar correctamente el fragmento. No se admiten cambios de CPD entre los fragmentos de destino del clip resultante. El CPD debe ser coherente en todos los medios consultados; de lo contrario, se devolverá un error. **importante** No se admiten los cambios de seguimiento. Las pistas deben permanecer consistentes en todo el contenido multimedia consultado. Se devuelve un error si los fragmentos de la transmisión pasan de tener solo vídeo a tener audio y vídeo, o si se cambia una pista de audio AAC por una pista de audio A-Law. ## Sintaxis de la solicitud ``` POST /getClip HTTP/1.1 Content-type: application/json { "ClipFragmentSelector": { "FragmentSelectorType": "string", "TimestampRange": { "EndTimestamp": number, "StartTimestamp": number } }, "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. ** [ClipFragmentSelector](#API_reader_GetClip_RequestSyntax) ** El intervalo de tiempo del clip solicitado y el origen de las marcas de tiempo. Tipo: objeto [ClipFragmentSelector](API_reader_ClipFragmentSelector.md) Obligatorio: sí ** [StreamARN](#API_reader_GetClip_RequestSyntax) ** El nombre del recurso de Amazon (ARN) de la transmisión de la que se va a recuperar el clip multimedia. Debe especificar el StreamARN StreamName o el StreamARN. 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](#API_reader_GetClip_RequestSyntax) ** El nombre de la transmisión de la que se va a recuperar el clip multimedia. Debe especificar el StreamArn StreamName o el StreamArn. 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](#API_reader_GetClip_ResponseSyntax) ** El tipo de contenido del contenido multimedia del clip 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 el cuerpo HTTP. ** [Payload](#API_reader_GetClip_ResponseSyntax) ** MP4 Archivo tradicional que contiene el clip multimedia de la secuencia de vídeo especificada. La salida contendrá los primeros 100 MB o los primeros 200 fragmentos de la marca de tiempo de inicio especificada. Para obtener más información, consulte Cuotas de [Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). ## Errores Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md). ** 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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). 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 ** InvalidCodecPrivateDataException ** Los datos privados del códec de al menos una de las pistas de la transmisión de vídeo no son válidos para esta operación. Código de estado HTTP: 400 ** InvalidMediaFrameException ** No se pudieron analizar uno o más fotogramas del clip solicitado en función del códec especificado. Código de estado HTTP: 400 ** MissingCodecPrivateDataException ** No se encontró ningún dato privado del códec en al menos una de las pistas de la transmisión de vídeo. Código de estado HTTP: 400 ** NoDataRetentionException ** `GetImages`se solicitó para una transmisión que no retiene datos (es decir, tiene un `DataRetentionInHours` 0). 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 ** `GetImages`mostrará este error cuando Kinesis Video Streams no encuentre la transmisión que ha especificado. `GetHLSStreamingSessionURL`y `GetDASHStreamingSessionURL` arroja este error si una sesión con un `PlaybackMode` de `ON_DEMAND` o `LIVE_REPLAY` se solicita una transmisión que no tiene fragmentos en el intervalo de tiempo solicitado, o si `LIVE` se solicita una sesión con un `PlaybackMode` de o para una transmisión que no tiene fragmentos en los últimos 30 segundos. Código de estado HTTP: 404 ** UnsupportedStreamMediaTypeException ** El tipo de contenido multimedia (por ejemplo, vídeo h.264 o h.265 o audio AAC o G.711) no se pudo determinar a partir del códec de las pistas del primer fragmento IDs de una sesión de reproducción. El ID de códec de la pista 1 debería ser `V_MPEG/ISO/AVC` y, opcionalmente, el ID de códec de la pista 2 debería ser. `A_AAC` Código de estado HTTP: 400 ## Véase también Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetClip)