GetMediaForFragmentList - Amazon Kinesis Video Streams
Sintaxe da SolicitaçãoURIParâmetros de solicitaçãoCorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

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 ligar GetDataEndpoint API para o para obter um endpoint. Em seguida, envie as GetMediaForFragmentList solicitações para esse endpoint usando o parâmetro --endpoint-url.

Para ver os limites, consulte as cotas do Kinesis Video Streams.

Importante

Se um erro for gerado após invocar uma API mídia arquivada do Kinesis Video Streams, além do código de status e HTTP do corpo da resposta, ele incluirá as seguintes informações:

  • x-amz-ErrorTypeHTTPcabeçalho — contém um tipo de erro mais específico, além do que o código de HTTP status fornece.

  • x-amz-RequestIdHTTPcabeçalho — 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 HTTP status 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.

Sintaxe da Solicitação

POST /getMediaForFragmentList HTTP/1.1
Content-type: application/json

{
   "Fragments": [ "string" ],
   "StreamARN": "string",
   "StreamName": "string"
}

URIParâmetros de solicitação

A solicitação não usa nenhum URI parâmetro.

Corpo da Solicitação

A solicitação aceita os seguintes dados no JSON formato.

Fragments

Uma lista dos números de fragmentos para os quais recuperar a mídia. Você recupera esses valores comListFragments.

Tipo: matriz de strings

Membros da matriz: número mínimo de 1 item. Número máximo de 1000 itens.

Restrições de comprimento: tamanho mínimo de 1. O tamanho máximo é 128.

Padrão: ^[0-9]+$

Exigido: Sim

StreamARN

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. Tamanho máximo de 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

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 de 200.

A resposta retorna os seguintes HTTP cabeçalhos.

ContentType

O tipo de conteúdo da mídia solicitada.

Restrições de comprimento: tamanho mínimo de 1. O tamanho máximo é 128.

Padrão: ^[a-zA-Z0-9_\.\-]+$

A resposta retorna o seguinte como HTTP corpo.

Payload

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 Os trechos que o Kinesis Video Streams retorna na chamada também incluem GetMediaForFragmentList as seguintes tags Matroska () adicionais: MKV

  • AWS_ KINESISVIDEO _ FRAGMENT _ NUMBER - Número do fragmento retornado no pedaço.

  • AWS_ _ KINESISVIDEO _ SERVER SIDE _ TIMESTAMP - Carimbo de data/hora do fragmento no lado do servidor.

  • AWS_ _ KINESISVIDEO _ PRODUCER SIDE _ TIMESTAMP - Registro de data e hora do fragmento no 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 obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.

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.

HTTPCódigo de status: 400

InvalidArgumentException

Um parâmetro especificado excede suas restrições, não é suportado ou não pode ser usado.

HTTPCódigo de status: 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.

HTTPCódigo de status: 401

ResourceNotFoundException

GetImagesgerará esse erro quando o Kinesis Video Streams não conseguir encontrar o stream que você especificou.

GetHLSStreamingSessionURLe 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.

HTTPCódigo de status: 404

Consulte também

Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte: