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á. # GetMediaForFragmentList Obtém mídia para uma lista de fragmentos (especificada pelo número do fragmento) dos dados arquivados em um stream de vídeo do Amazon Kinesis. **nota** Você deve primeiro chamar a `GetDataEndpoint` API para obter um endpoint. Em seguida, envie as `GetMediaForFragmentList` solicitações para esse endpoint usando o parâmetro [--endpoint-url](https://docs.aws.amazon.com/cli/latest/reference/). Para ver os limites, consulte as [cotas do Kinesis Video Streams](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). **Importante** Se um erro for gerado após a invocação de uma API de mídia arquivada do Kinesis Video Streams, além do código de status HTTP e do corpo da resposta, ele incluirá as seguintes informações: `x-amz-ErrorType`Cabeçalho HTTP — contém um tipo de erro mais específico, além do que o código de status HTTP fornece. `x-amz-RequestId`Cabeçalho HTTP — se você quiser relatar um problema AWS, a equipe de suporte poderá diagnosticar melhor o problema se receber o ID da solicitação. Tanto o código de status HTTP quanto o ErrorType cabeçalho podem ser utilizados para tomar decisões programáticas sobre se os erros podem ser repetidos e sob quais condições, além de fornecer informações sobre quais ações o programador cliente pode precisar realizar para tentar novamente com sucesso. Para obter mais informações, consulte a seção **Erros** na parte inferior deste tópico, bem como [Erros comuns](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/CommonErrors.html). ## Sintaxe da Solicitação ``` POST /getMediaForFragmentList HTTP/1.1 Content-type: application/json { "Fragments": [ "{{string}}" ], "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. ** [Fragments](#API_reader_GetMediaForFragmentList_RequestSyntax) ** Uma lista dos números de fragmentos para os quais recuperar a mídia. Você recupera esses valores com[ListFragments](API_reader_ListFragments.md). Tipo: matriz de strings Membros da matriz: número mínimo de 1 item. Número máximo de 1000 itens. Restrições de Tamanho: Tamanho mínimo 1. O tamanho máximo é 128. Padrão: `^[0-9]+$` Obrigatório: Sim ** [StreamARN](#API_reader_GetMediaForFragmentList_RequestSyntax) ** O Amazon Resource Name (ARN) do stream do qual recuperar a mídia fragmentada. Especifique esse parâmetro ou o `StreamName` parâmetro. 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_GetMediaForFragmentList_RequestSyntax) ** O nome do fluxo do qual recuperar a mídia fragmentada. Especifique esse parâmetro ou o `StreamARN` parâmetro. 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_GetMediaForFragmentList_ResponseSyntax) ** O tipo de conteúdo da mídia solicitada. 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_GetMediaForFragmentList_ResponseSyntax) ** A carga que o Kinesis Video Streams retorna é uma sequência de partes do stream especificado. Para obter informações sobre os fragmentos, consulte. [PutMedia](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_dataplane_PutMedia.html) Os trechos que o Kinesis Video Streams retorna na chamada também incluem as seguintes tags adicionais de `GetMediaForFragmentList` Matroska (MKV): + AWS\_KINESISVIDEO\_FRAGMENT\_NUMBER - Número do fragmento retornado no pedaço. + AWS\_KINESISVIDEO\_SERVER\_SIDE\_TIMESTAMP - Registro de data e hora do fragmento no lado do servidor. + AWS\_KINESISVIDEO\_PRODUCER\_SIDE\_TIMESTAMP - Registro de data e hora do fragmento do lado do produtor. As seguintes tags serão incluídas se ocorrer uma exceção: + AWS\_KINESISVIDEO\_FRAGMENT\_NUMBER - O número do fragmento que gerou a exceção. + AWS\_KINESISVIDEO\_EXCEPTION\_ERROR\_CODE - O código inteiro do erro. + AWS\_KINESISVIDEO\_EXCEPTION\_MESSAGE - Uma descrição em texto da exceção. ## 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 ** 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 ## 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/GetMediaForFragmentList) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetMediaForFragmentList)