

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# CreateSignalingChannel
<a name="API_CreateSignalingChannel"></a>

Crea un canale di segnalazione. 

 `CreateSignalingChannel` è un'operazione asincrona.

## Sintassi della richiesta
<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"
      }
   ]
}
```

## Parametri della richiesta URI:
<a name="API_CreateSignalingChannel_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_CreateSignalingChannel_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [ChannelName](#API_CreateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-CreateSignalingChannel-request-ChannelName"></a>
Un nome per il canale di segnalazione che stai creando. Deve essere unico per ogni mano Account AWS . Regione AWS  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.  
Modello: `[a-zA-Z0-9_.-]+`   
Obbligatorio: sì

 ** [ChannelType](#API_CreateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-CreateSignalingChannel-request-ChannelType"></a>
Un tipo di canale di segnalazione che stai creando. Attualmente, `SINGLE_MASTER` è l'unico tipo di canale supportato.   
Tipo: String  
Valori validi: `SINGLE_MASTER | FULL_MESH`   
Campo obbligatorio: no

 ** [SingleMasterConfiguration](#API_CreateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-CreateSignalingChannel-request-SingleMasterConfiguration"></a>
Una struttura contenente la configurazione per il tipo di `SINGLE_MASTER` canale. La configurazione predefinita per la durata della trasmissione del messaggio sul canale è di 60 secondi (1 minuto).  
Tipo: oggetto [SingleMasterConfiguration](API_SingleMasterConfiguration.md)  
Obbligatorio: no

 ** [Tags](#API_CreateSignalingChannel_RequestSyntax) **   <a name="KinesisVideo-CreateSignalingChannel-request-Tags"></a>
Un insieme di tag (coppie chiave-valore) da associare a questo canale.  
Tipo: matrice di oggetti [Tag](API_Tag.md)  
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 50 item.  
Obbligatorio: no

## Sintassi della risposta
<a name="API_CreateSignalingChannel_ResponseSyntax"></a>

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

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

## Elementi di risposta
<a name="API_CreateSignalingChannel_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [ChannelARN](#API_CreateSignalingChannel_ResponseSyntax) **   <a name="KinesisVideo-CreateSignalingChannel-response-ChannelARN"></a>
L'Amazon Resource Name (ARN) del canale creato.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.  
Modello: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` 

## Errori
<a name="API_CreateSignalingChannel_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** AccessDeniedException **   
Non disponi delle autorizzazioni necessarie per eseguire questa operazione.  
Codice di stato HTTP: 401

 ** AccountChannelLimitExceededException **   
Hai raggiunto il limite massimo di canali di segnalazione attivi per questo scopo Account AWS in questa regione.  
Codice di stato HTTP: 400

 ** ClientLimitExceededException **   
Kinesis Video Streams ha limitato la richiesta perché è stato superato il limite di chiamate client consentite. Prova a effettuare la chiamata più tardi.  
Codice di stato HTTP: 400

 ** InvalidArgumentException **   
Il valore di questo parametro di input non è valido.  
Codice di stato HTTP: 400

 ** ResourceInUseException **   
Quando l'ingresso `StreamARN` o `ChannelARN` l'ingresso `CLOUD_STORAGE_MODE` sono già mappati su un'altra risorsa Kinesis Video Stream, o se l'`StreamARN`ingresso fornito `ChannelARN` o non è nello stato Attivo, prova una delle seguenti soluzioni:   

1. L'`DescribeMediaStorageConfiguration`API per determinare a cosa è mappato lo stream di un determinato canale. 

1. L'`DescribeMappedResourceConfiguration`API per determinare il canale su cui è mappato lo stream specificato. 

1. L'`DescribeStream`o l'`DescribeSignalingChannel`API per determinare lo stato della risorsa. 
Codice di stato HTTP: 400

 ** TagsPerResourceExceededLimitException **   
Hai superato il limite di tag che puoi associare alla risorsa. Uno stream video Kinesis può supportare fino a 50 tag.   
Codice di stato HTTP: 400

## Vedi anche
<a name="API_CreateSignalingChannel_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/CreateSignalingChannel) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/CreateSignalingChannel) 