UpdateStream - 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á.

UpdateStream

Atualiza os metadados do stream, como o nome do dispositivo e o tipo de mídia.

Você deve fornecer o nome do stream ou o Amazon Resource Name (ARN) do stream.

Para garantir que você tenha a versão mais recente do stream antes de atualizá-lo, você pode especificar a versão do stream. O Kinesis Video Streams atribui uma versão a cada stream. Quando você atualiza um stream, o Kinesis Video Streams atribui um novo número de versão. Para obter a versão mais recente do stream, use a DescribeStream API.

UpdateStreamé uma operação assíncrona e leva tempo para ser concluída.

Sintaxe da Solicitação

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

{
   "CurrentVersion": "string",
   "DeviceName": "string",
   "MediaType": "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.

CurrentVersion

A versão do stream cujos metadados você deseja atualizar.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

Padrão: [a-zA-Z0-9]+

Exigido: Sim

DeviceName

O nome do dispositivo que está gravando no stream.

nota

Na implementação atual, o Kinesis Video Streams não usa esse nome.

Tipo: string

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

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

Obrigatório: não

MediaType

O tipo de mídia do stream. Use MediaType para especificar o tipo de conteúdo que o stream contém para os consumidores do stream. Para obter mais informações sobre os tipos de mídia, consulte Tipos de mídia. Se você optar por especificar oMediaType, consulte Requisitos de nomenclatura.

Para reproduzir vídeo no console, você deve especificar o tipo de vídeo correto. Por exemplo, se o vídeo no stream for H.264, especifique como o. video/h264 MediaType

Tipo: string

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

Padrão: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*

Obrigatório: não

StreamARN

O ARN do stream cujos metadados você deseja atualizar.

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 cujos metadados você deseja atualizar.

O nome do stream é um identificador do stream e deve ser exclusivo para cada conta e região.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 256.

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

Obrigatório: Não

Sintaxe da Resposta

HTTP/1.1 200

Elementos de Resposta

Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 200 com um corpo HTTP vazio.

Erros

Para obter informações sobre os erros comuns a todas as 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

ResourceInUseException

Quando a entrada StreamARN ou ChannelARN a entrada já estiverem mapeadas para um recurso diferente do Kinesis Video Stream, ou se a StreamARN entrada ChannelARN fornecida não estiver no status Ativo, tente uma das seguintes opções: CLOUD_STORAGE_MODE

  1. A DescribeMediaStorageConfiguration API para determinar para onde o stream determinado canal é mapeado.

  2. A DescribeMappedResourceConfiguration API para determinar o canal para o qual o determinado fluxo é mapeado.

  3. A DescribeSignalingChannel API DescribeStream ou para determinar o status do recurso.

Código de Status HTTP: 400

ResourceNotFoundException

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

Código de Status HTTP: 404

VersionMismatchException

A versão do stream que você especificou não é a versão mais recente. Para obter a versão mais recente, use a DescribeStreamAPI.

Código de Status HTTP: 400

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: