CreateSignalingChannel - Amazon Kinesis Video Streams
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

CreateSignalingChannel

Crea un canal de señalización.

CreateSignalingChannel es una operación asíncrona.

Sintaxis de la solicitud

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

{
   "ChannelName": "string",
   "ChannelType": "string",
   "SingleMasterConfiguration": { 
      "MessageTtlSeconds": number
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

ChannelName

Un nombre para el canal de señalización que está creando. Debe ser único para cada uno Cuenta de AWS y Región de AWS.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.

Patrón: [a-zA-Z0-9_.-]+

Obligatorio: sí

ChannelType

Un tipo de canal de señalización que está creando. Actualmente, SINGLE_MASTER es el único tipo de canal admitido.

Tipo: cadena

Valores válidos: SINGLE_MASTER | FULL_MESH

Obligatorio: no

SingleMasterConfiguration

Estructura que contiene la configuración del tipo SINGLE_MASTER de canal.

Tipo: objeto SingleMasterConfiguration

Obligatorio: no

Tags

Un conjunto de etiquetas (pares clave-valor) que desea asociar a este canal.

Tipo: matriz de objetos Tag

Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.

Obligatorio: no

Sintaxis de la respuesta

HTTP/1.1 200
Content-type: application/json

{
   "ChannelARN": "string"
}

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

ChannelARN

El nombre de recurso de Amazon (ARN) del canal creado.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.

Patrón: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

AccessDeniedException

No tiene los permisos necesarios para realizar esta operación.

Código de estado HTTP: 401

AccountChannelLimitExceededException

Ha alcanzado el límite máximo de canales de señalización activos para ello Cuenta de AWS en esta región.

Código de estado HTTP: 400

ClientLimitExceededException

Kinesis Video Streams ha limitado la solicitud porque ha superado el límite de llamadas de clientes permitidas. Intente realizar la llamada más tarde.

Código de estado HTTP: 400

InvalidArgumentException

El valor de este parámetro de entrada no es válido.

Código de estado HTTP: 400

ResourceInUseException

Si la entrada StreamARN o ChannelARN entrada ya CLOUD_STORAGE_MODE está mapeada a otro recurso de Kinesis Video Stream, o si la StreamARN entrada ChannelARN proporcionada no está en estado Activo, pruebe una de las siguientes opciones:

  1. La DescribeMediaStorageConfiguration API para determinar a qué está asignado el canal de transmisión en cuestión.

  2. La DescribeMappedResourceConfiguration API para determinar el canal al que está mapeada la transmisión determinada.

  3. La DescribeStream o DescribeSignalingChannel API para determinar el estado del recurso.

Código de estado HTTP: 400

TagsPerResourceExceededLimitException

Ha superado el límite de etiquetas que puede asociar al recurso. Una transmisión de vídeo de Kinesis puede admitir hasta 50 etiquetas.

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulte lo siguiente: