GetDataEndpoint - Amazon Kinesis Video Streams
Sintaxe da SolicitaçãoParâmetros da solicitação de URICorpo 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á.

GetDataEndpoint

Obtém um endpoint para um fluxo especificado para leitura ou gravação. Use esse endpoint em seu aplicativo para ler o fluxo especificado (usando as GetMediaForFragmentList operações GetMedia ou) ou gravar nele (usando a PutMedia operação).

nota

O endpoint retornado não tem o nome da API anexado. O cliente precisa adicionar o nome da API ao endpoint retornado.

Na solicitação, especifique o fluxo por StreamName ouStreamARN.

Sintaxe da Solicitação

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

{
   "APIName": "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.

APIName

O nome da ação da API para a qual obter um endpoint.

Tipo: string

Valores Válidos: PUT_MEDIA | GET_MEDIA | LIST_FRAGMENTS | GET_MEDIA_FOR_FRAGMENT_LIST | GET_HLS_STREAMING_SESSION_URL | GET_DASH_STREAMING_SESSION_URL | GET_CLIP | GET_IMAGES

Obrigatório: sim

StreamARN

O Amazon Resource Name (ARN) do stream para o qual você deseja obter o endpoint. Você deve especificar esse parâmetro ou um StreamName na solicitação.

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 stream para o qual você deseja obter o endpoint. Você deve especificar esse parâmetro ou um StreamARN na solicitação.

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: application/json

{
   "DataEndpoint": "string"
}

Elementos de Resposta

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

DataEndpoint

O valor do endpoint. Para ler dados do stream ou gravar dados nele, especifique esse endpoint em seu aplicativo.

Tipo: string

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 o limite permitido de chamadas de clientes. Tente fazer a ligação mais tarde.

Código de status HTTP: 400

InvalidArgumentException

O valor desse parâmetro de entrada é inválido.

Código de status HTTP: 400

NotAuthorizedException

O chamador não está autorizado a realizar essa operação.

Código de status HTTP: 401

ResourceNotFoundException

O Amazon Kinesis Video Streams não consegue encontrar o stream que você especificou.

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: