As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # GetClip Faz o download de um MP4 arquivo (clipe) contendo a mídia arquivada sob demanda do stream de vídeo especificado durante o intervalo de tempo especificado. Os parâmetros StreamArn StreamName e StreamArn são opcionais, mas você deve especificar o StreamName ou o StreamArn ao invocar essa operação de API. **nota** Você deve primeiro chamar a `GetDataEndpoint` API para obter um endpoint. Em seguida, envie as `GetClip` solicitações para esse endpoint usando o parâmetro [--endpoint-url](https://docs.aws.amazon.com/cli/latest/reference/). Um stream de vídeo do Amazon Kinesis tem os seguintes requisitos para fornecer dados por meio de: MP4 + [Requisitos de faixa de reprodução de vídeo](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html). + A retenção de dados deve ser maior que 0. + A trilha de vídeo de cada fragmento deve conter dados privados de codec na Advanced Video Coding (AVC – Codificação de vídeo avançada) para H.264, e HEVC para formato H.265. Para obter mais informações, consulte a especificação [MPEG-4](https://www.iso.org/standard/55980.html) 14496-15. ISO/IEC Para obter informações sobre a adaptação de dados de streaming para um formato específico, consulte [Sinalizadores de adaptação do NAL](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html). + [A faixa de áudio (se presente) de cada fragmento deve conter dados privados do codec no formato AAC ([especificação AAC ISO/IEC 13818-7](https://www.iso.org/standard/43345.html)) ou no formato MS Wave.](https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html) Você pode monitorar a quantidade de dados enviados monitorando a CloudWatch métrica da `GetClip.OutgoingBytes` Amazon. Para obter informações sobre como usar o Kinesis Video Streams CloudWatch para monitorar o Kinesis Video Streams[, consulte Monitoramento do Kinesis Video](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html) Streams. [Para obter informações sobre preços, consulte Preços e preços do [Amazon Kinesis Video](https://aws.amazon.com/kinesis/video-streams/pricing/) Streams AWS .](https://aws.amazon.com/pricing/) Aplicam-se taxas de saída AWS de dados. **Importante** Os dados privados do codec (CPD) contidos em cada fragmento contêm informações de inicialização específicas do codec, como taxa de quadros, resolução e perfil de codificação, que são necessárias para decodificar adequadamente o fragmento. Não há suporte para alterações de CPD entre os fragmentos de destino do clipe resultante. O CPD deve permanecer consistente na mídia consultada, caso contrário, um erro será retornado. **Importante** Não há suporte para alterações na faixa. As faixas devem permanecer consistentes em toda a mídia consultada. Um erro será retornado se os fragmentos no stream mudarem de ter apenas vídeo para ter áudio e vídeo, ou se uma faixa de áudio AAC for alterada para uma faixa de áudio A-Law. ## Sintaxe da Solicitação ``` POST /getClip HTTP/1.1 Content-type: application/json { "ClipFragmentSelector": { "FragmentSelectorType": "string", "TimestampRange": { "EndTimestamp": number, "StartTimestamp": number } }, "StreamARN": "string", "StreamName": "string" } ``` ## Parâmetros da solicitação de URI A solicitação não usa nenhum parâmetro de URI. ## Corpo da Solicitação A solicitação aceita os dados a seguir no formato JSON. ** [ClipFragmentSelector](#API_reader_GetClip_RequestSyntax) ** O intervalo de tempo do clipe solicitado e a origem dos carimbos de data/hora. Tipo: objeto [ClipFragmentSelector](API_reader_ClipFragmentSelector.md) Obrigatório: Sim ** [StreamARN](#API_reader_GetClip_RequestSyntax) ** O Amazon Resource Name (ARN) do stream para o qual recuperar o clipe de mídia. Você deve especificar o StreamName ou o StreamArn. Tipo: string Restrições de tamanho: tamanho mínimo 1. O comprimento máximo é 1.024. Padrão: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` Obrigatório: não ** [StreamName](#API_reader_GetClip_RequestSyntax) ** O nome do stream para o qual recuperar o clipe de mídia. Você deve especificar o StreamName ou o StreamArn. Tipo: string Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 256. Padrão: `[a-zA-Z0-9_.-]+` Obrigatório: Não ## Sintaxe da resposta ``` HTTP/1.1 200 Content-Type: ContentType Payload ``` ## Elementos de resposta Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200. A resposta retorna os cabeçalhos HTTP a seguir. ** [ContentType](#API_reader_GetClip_ResponseSyntax) ** O tipo de conteúdo da mídia no clipe solicitado. Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128. Padrão: `^[a-zA-Z0-9_\.\-]+$` A resposta retorna as informações a seguir como corpo HTTP. ** [Payload](#API_reader_GetClip_ResponseSyntax) ** MP4 Arquivo tradicional que contém o clipe de mídia do stream de vídeo especificado. A saída conterá os primeiros 100 MB ou os primeiros 200 fragmentos do timestamp de início especificado. Para obter mais informações, consulte Cotas do [Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). ## Erros Para informações sobre os erros comuns retornados pelas ações, consulte [Tipos de erro comuns](CommonErrors.md). ** ClientLimitExceededException ** O Kinesis Video Streams limitou a solicitação porque você excedeu um limite. Tente fazer a ligação mais tarde. Para obter informações sobre limites, consulte Cotas do [Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). Código de status HTTP: 400 ** InvalidArgumentException ** Um parâmetro especificado excede suas restrições, não é suportado ou não pode ser usado. Código de status HTTP: 400 ** InvalidCodecPrivateDataException ** Os dados privados do codec em pelo menos uma das faixas do stream de vídeo não são válidos para essa operação. Código de status HTTP: 400 ** InvalidMediaFrameException ** Um ou mais quadros no clipe solicitado não puderam ser analisados com base no codec especificado. Código de status HTTP: 400 ** MissingCodecPrivateDataException ** Nenhum dado privado do codec foi encontrado em pelo menos uma das faixas do stream de vídeo. Código de status HTTP: 400 ** NoDataRetentionException ** `GetImages`foi solicitado para um fluxo que não retém dados (ou seja, tem um `DataRetentionInHours` de 0). Código de status HTTP: 400 ** NotAuthorizedException ** Código de status: 403, O chamador não está autorizado a realizar uma operação no stream fornecido ou o token expirou. Código de status HTTP: 401 ** ResourceNotFoundException ** `GetImages`gerará esse erro quando o Kinesis Video Streams não conseguir encontrar o stream que você especificou. `GetHLSStreamingSessionURL`e `GetDASHStreamingSessionURL` gere esse erro se uma sessão com um `PlaybackMode` de `ON_DEMAND` ou `LIVE_REPLAY` for solicitada para um fluxo que não tem fragmentos dentro do intervalo de tempo solicitado, ou se uma sessão com um `PlaybackMode` of `LIVE` for solicitada para um fluxo que não tem fragmentos nos últimos 30 segundos. Código de status HTTP: 404 ** UnsupportedStreamMediaTypeException ** O tipo da mídia (por exemplo, vídeo h.264 ou h.265 ou áudio AAC ou G.711) não pôde ser determinado pelo codec IDs das faixas no primeiro fragmento de uma sessão de reprodução. O ID do codec para a faixa 1 deve ser `V_MPEG/ISO/AVC` e, opcionalmente, o ID do codec para a faixa 2 deve ser. `A_AAC` Código de Status HTTP: 400 ## Consulte também Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte: + [AWS Interface de linha de comando 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)