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.

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

Proporciona un punto final para que el canal de señalización especificado envíe y reciba mensajes. Esta API usa el parámetro `SingleMasterChannelEndpointConfiguration` de entrada, que consta de las `Role` propiedades `Protocols` y.

 `Protocols`se utiliza para determinar el mecanismo de comunicación. Por ejemplo, si lo especificas `WSS` como protocolo, esta API genera un punto final websocket seguro. Si lo especificas `HTTPS` como protocolo, esta API genera un punto final HTTPS. Si lo especificas `WEBRTC` como protocolo, pero el canal de señalización no está configurado para la ingesta, recibirás el error`InvalidArgumentException`.

 `Role`determina los permisos de mensajería. Una `MASTER` función hace que esta API genere un punto final que un cliente puede usar para comunicarse con cualquiera de los espectadores del canal. Un `VIEWER` rol hace que esta API genere un punto final que un cliente puede usar para comunicarse solo con un`MASTER`. 

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

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

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

## Parámetros de solicitud del URI
<a name="API_GetSignalingChannelEndpoint_RequestParameters"></a>

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

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

La solicitud acepta los siguientes datos en formato JSON.

 ** [ChannelARN](#API_GetSignalingChannelEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-request-ChannelARN"></a>
El nombre de recurso de Amazon (ARN) del canal de señalización para el que desea obtener un punto final.  
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]+`   
Obligatorio: sí

 ** [SingleMasterChannelEndpointConfiguration](#API_GetSignalingChannelEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-request-SingleMasterChannelEndpointConfiguration"></a>
Una estructura que contiene la configuración del punto final para el tipo de `SINGLE_MASTER` canal.  
Tipo: objeto [SingleMasterChannelEndpointConfiguration](API_SingleMasterChannelEndpointConfiguration.md)  
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_GetSignalingChannelEndpoint_ResponseSyntax"></a>

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

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

## Elementos de respuesta
<a name="API_GetSignalingChannelEndpoint_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.

 ** [ResourceEndpointList](#API_GetSignalingChannelEndpoint_ResponseSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-response-ResourceEndpointList"></a>
Una lista de puntos finales del canal de señalización especificado.  
Tipo: matriz de objetos [ResourceEndpointListItem](API_ResourceEndpointListItem.md)

## Errores
<a name="API_GetSignalingChannelEndpoint_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

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

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

1. La `DescribeStream` o `DescribeSignalingChannel` API para determinar el estado del recurso. 
Código de estado HTTP: 400

 ** ResourceNotFoundException **   
Amazon Kinesis Video Streams no encuentra la transmisión que ha especificado.  
Código de estado HTTP: 404

## Véase también
<a name="API_GetSignalingChannelEndpoint_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/GetSignalingChannelEndpoint) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint)