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

CreateSignalingChannel

Cria um canal de sinalização.

CreateSignalingChannel é uma operação de natureza assíncrona.

Sintaxe da Solicitação

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

{
   "ChannelName": "string",
   "ChannelType": "string",
   "SingleMasterConfiguration": { 
      "MessageTtlSeconds": number
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "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.

ChannelName

Um nome para o canal de sinalização que você está criando. Deve ser exclusivo para cada Conta da AWS Região da AWS e.

Tipo: string

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

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

Exigido: Sim

ChannelType

Um tipo do canal de sinalização que você está criando. Atualmente, o único tipo de canal com suporte é SINGLE_MASTER.

Tipo: strings

Valores Válidos: SINGLE_MASTER | FULL_MESH

Obrigatório: não

SingleMasterConfiguration

Uma estrutura contendo a configuração para o tipo de SINGLE_MASTER canal.

Tipo: objeto SingleMasterConfiguration

Obrigatório: Não

Tags

Um conjunto de tags (pares de valores-chave) que você deseja associar a esse canal.

Tipo: matriz de objetos Tag

Membros da Matriz: número mínimo de 0 itens. Número máximo de 50 itens.

Obrigatório: Não

Sintaxe da Resposta

HTTP/1.1 200
Content-type: application/json

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

ChannelARN

O Amazon Resource Name (ARN) do canal criado.

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]+

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

AccountChannelLimitExceededException

Você atingiu o limite máximo de canais de sinalização ativos para isso Conta da AWS nesta região.

Código de Status HTTP: 400

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

TagsPerResourceExceededLimitException

Você excedeu o limite de tags que você pode associar ao recurso. Um stream de vídeo do Kinesis pode suportar até 50 tags.

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: