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

# GetSignalingChannelEndpoint
<a name="API_GetSignalingChannelEndpoint"></a>

Fornisce un endpoint per il canale di segnalazione specificato per inviare e ricevere messaggi. Questa API utilizza il parametro `SingleMasterChannelEndpointConfiguration` di input, che consiste nelle proprietà `Protocols` e`Role`.

 `Protocols`viene utilizzato per determinare il meccanismo di comunicazione. Ad esempio, se si specifica `WSS` come protocollo, questa API produce un endpoint websocket sicuro. Se si specifica `HTTPS` come protocollo, questa API genera un endpoint HTTPS. Se lo specifichi `WEBRTC` come protocollo, ma il canale di segnalazione non è configurato per l'ingestione, riceverai l'errore. `InvalidArgumentException`

 `Role`determina le autorizzazioni di messaggistica. Un `MASTER` ruolo fa sì che questa API generi un endpoint che un client può utilizzare per comunicare con qualsiasi spettatore del canale. Un `VIEWER` ruolo fa sì che questa API generi un endpoint che un client può utilizzare per comunicare solo con un. `MASTER` 

## Sintassi della richiesta
<a name="API_GetSignalingChannelEndpoint_RequestSyntax"></a>

```
POST /getSignalingChannelEndpoint HTTP/1.1
Content-type: application/json

{
   "ChannelARN": "{{string}}",
   "SingleMasterChannelEndpointConfiguration": { 
      "Protocols": [ "{{string}}" ],
      "Role": "{{string}}"
   }
}
```

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

La richiesta non utilizza parametri URI.

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

La richiesta accetta i seguenti dati in formato JSON.

 ** [ChannelARN](#API_GetSignalingChannelEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-request-ChannelARN"></a>
L'Amazon Resource Name (ARN) del canale di segnalazione per il quale desideri ottenere un endpoint.  
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]+`   
Obbligatorio: sì

 ** [SingleMasterChannelEndpointConfiguration](#API_GetSignalingChannelEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-request-SingleMasterChannelEndpointConfiguration"></a>
Una struttura contenente la configurazione dell'endpoint per il tipo di canale. `SINGLE_MASTER`  
Tipo: oggetto [SingleMasterChannelEndpointConfiguration](API_SingleMasterChannelEndpointConfiguration.md)  
Obbligatorio: no

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

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

{
   "ResourceEndpointList": [ 
      { 
         "Protocol": "string",
         "ResourceEndpoint": "string"
      }
   ]
}
```

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

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

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

 ** [ResourceEndpointList](#API_GetSignalingChannelEndpoint_ResponseSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-response-ResourceEndpointList"></a>
Un elenco di endpoint per il canale di segnalazione specificato.  
Tipo: matrice di oggetti [ResourceEndpointListItem](API_ResourceEndpointListItem.md)

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

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

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

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

 ** ResourceNotFoundException **   
Amazon Kinesis Video Streams non riesce a trovare lo stream specificato.  
Codice di stato HTTP: 404

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

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