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
<a name="API_CreateSignalingChannel"></a>

Crea un canal de señalización. 

 `CreateSignalingChannel` es una operación asíncrona.

## Sintaxis de la solicitud
<a name="API_CreateSignalingChannel_RequestSyntax"></a>

```
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
<a name="API_CreateSignalingChannel_RequestParameters"></a>

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

## Cuerpo de la solicitud
<a name="API_CreateSignalingChannel_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [ChannelName](#API_CreateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-CreateSignalingChannel-request-ChannelName"></a>
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: cadena  
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](#API_CreateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-CreateSignalingChannel-request-ChannelType"></a>
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](#API_CreateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-CreateSignalingChannel-request-SingleMasterConfiguration"></a>
Estructura que contiene la configuración del tipo `SINGLE_MASTER` de canal. La configuración predeterminada para el tiempo de vida del mensaje del canal es de 60 segundos (1 minuto).  
Tipo: objeto [SingleMasterConfiguration](API_SingleMasterConfiguration.md)  
Obligatorio: no

 ** [Tags](#API_CreateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-CreateSignalingChannel-request-Tags"></a>
Un conjunto de etiquetas (pares clave-valor) que quieres asociar a este canal.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
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
<a name="API_CreateSignalingChannel_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "ChannelARN": "string"
}
```

## Elementos de respuesta
<a name="API_CreateSignalingChannel_ResponseElements"></a>

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

El servicio devuelve los datos siguientes en formato JSON.

 ** [ChannelARN](#API_CreateSignalingChannel_ResponseSyntax) **   <a name="KinesisVideo-CreateSignalingChannel-response-ChannelARN"></a>
El nombre de recurso de Amazon (ARN) del canal creado.  
Tipo: cadena  
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
<a name="API_CreateSignalingChannel_Errors"></a>

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** 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é se ha asignado el canal de transmisión en cuestión. 

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

1. La `DescribeStream` o la `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
<a name="API_CreateSignalingChannel_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/CreateSignalingChannel)