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

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
   }
}

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.

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. Esse parâmetro e as mensagens do canal time-to-live são necessários para canais com o tipo de SINGLE_MASTER canal.

Tipo: objeto SingleMasterConfiguration

Obrigatório: Não

Sintaxe da Resposta

HTTP/1.1 200

Elementos de Resposta

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

Erros

Para obter informações sobre os erros comuns retornados pelas ações, consulte Erros comuns.

AccessDeniedException

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

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

HTTPCódigo de status: 400

InvalidArgumentException

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

HTTPCódigo de status: 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. O DescribeMediaStorageConfiguration API para determinar para qual fluxo determinado canal está mapeado.

  2. O DescribeMappedResourceConfiguration API para determinar o canal para o qual o fluxo fornecido é mapeado.

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

HTTPCódigo de status: 400

ResourceNotFoundException

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

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

HTTPCódigo de status: 400

Consulte também

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