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

UpdateSignalingChannel

Atualiza o canal de sinalização existente. Essa é uma operação assíncrona e leva tempo para ser concluída.

Se o MessageTtlSeconds valor for atualizado (aumentado ou reduzido), ele só se aplicará às novas mensagens enviadas por esse canal após a atualização. As mensagens existentes ainda expiraram de acordo com o MessageTtlSeconds valor anterior.

Sintaxe da Solicitação

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

{
   "ChannelARN": "string",
   "CurrentVersion": "string",
   "SingleMasterConfiguration": { 
      "MessageTtlSeconds": number
   }
}

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.

ChannelARN

O Amazon Resource Name (ARN) do canal de sinalização que 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]+

Exigido: Sim

CurrentVersion

A versão atual do canal de sinalização que 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

SingleMasterConfiguration

A estrutura que contém a configuração do SINGLE_MASTER tipo de canal de sinalização que você deseja atualizar.

Tipo: objeto SingleMasterConfiguration

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.

AccessDeniedException

Você não tem as permissões necessárias para realizar essa operação.

Código de status HTTP: 401

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

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 qual 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: