Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Stellt einen Endpunkt für den angegebenen Signalkanal zum Senden und Empfangen von Nachrichten bereit. Diese API verwendet den `SingleMasterChannelEndpointConfiguration` Eingabeparameter, der aus den `Role` Eigenschaften `Protocols` und besteht.

 `Protocols`wird verwendet, um den Kommunikationsmechanismus zu bestimmen. Wenn Sie beispielsweise `WSS` als Protokoll angeben, erzeugt diese API einen sicheren Websocket-Endpunkt. Wenn Sie `HTTPS` als Protokoll angeben, generiert diese API einen HTTPS-Endpunkt. Wenn Sie `WEBRTC` als Protokoll angeben, der Signalkanal jedoch nicht für die Aufnahme konfiguriert ist, erhalten Sie den Fehler. `InvalidArgumentException`

 `Role`bestimmt die Messaging-Berechtigungen. Eine `MASTER` Rolle führt dazu, dass diese API einen Endpunkt generiert, über den ein Client mit allen Zuschauern auf dem Kanal kommunizieren kann. Eine `VIEWER` Rolle führt dazu, dass diese API einen Endpunkt generiert, über den ein Client nur mit einem kommunizieren kann`MASTER`. 

## Anforderungssyntax
<a name="API_GetSignalingChannelEndpoint_RequestSyntax"></a>

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

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

## URI-Anfrageparameter
<a name="API_GetSignalingChannelEndpoint_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_GetSignalingChannelEndpoint_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [ChannelARN](#API_GetSignalingChannelEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-request-ChannelARN"></a>
Der Amazon-Ressourcenname (ARN) des Signalisierungskanals, für den Sie einen Endpunkt abrufen möchten.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen.  
Pattern: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`   
Erforderlich: Ja

 ** [SingleMasterChannelEndpointConfiguration](#API_GetSignalingChannelEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-request-SingleMasterChannelEndpointConfiguration"></a>
Eine Struktur, die die Endpunktkonfiguration für den `SINGLE_MASTER` Kanaltyp enthält.  
Typ: [SingleMasterChannelEndpointConfiguration](API_SingleMasterChannelEndpointConfiguration.md) Objekt  
Erforderlich: Nein

## Antwortsyntax
<a name="API_GetSignalingChannelEndpoint_ResponseSyntax"></a>

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

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

## Antwortelemente
<a name="API_GetSignalingChannelEndpoint_ResponseElements"></a>

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

 ** [ResourceEndpointList](#API_GetSignalingChannelEndpoint_ResponseSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-response-ResourceEndpointList"></a>
Eine Liste von Endpunkten für den angegebenen Signalkanal.  
Typ: Array von [ResourceEndpointListItem](API_ResourceEndpointListItem.md)-Objekten

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehlertypen](CommonErrors.md).

 ** AccessDeniedException **   
Sie verfügen nicht über die erforderlichen Berechtigungen, um diesen Vorgang auszuführen.  
HTTP-Statuscode: 401

 ** ClientLimitExceededException **   
Kinesis Video Streams hat die Anfrage gedrosselt, weil Sie das Limit der erlaubten Client-Aufrufe überschritten haben. Versuchen Sie später, den Anruf zu tätigen.  
HTTP-Statuscode: 400

 ** InvalidArgumentException **   
Der Wert für diesen Eingabeparameter ist ungültig.  
HTTP-Statuscode: 400

 ** ResourceInUseException **   
Wenn der Eingang `StreamARN` oder `ChannelARN` Eingang bereits einer anderen Kinesis Video Stream-Ressource zugeordnet `CLOUD_STORAGE_MODE` ist oder wenn sich der angegebene Eingang `StreamARN` oder Eingang nicht im Status Aktiv `ChannelARN` befindet, versuchen Sie es mit einer der folgenden Methoden:   

1. Die `DescribeMediaStorageConfiguration` API, um zu ermitteln, welchem Stream der angegebene Kanal zugeordnet ist. 

1. Die `DescribeMappedResourceConfiguration` API zur Bestimmung des Kanals, dem der angegebene Stream zugeordnet ist. 

1. Die `DescribeStream` oder `DescribeSignalingChannel` API zur Bestimmung des Status der Ressource. 
HTTP-Statuscode: 400

 ** ResourceNotFoundException **   
Amazon Kinesis Video Streams kann den von Ihnen angegebenen Stream nicht finden.  
HTTP-Statuscode: 404

## Weitere Informationen finden Sie unter:
<a name="API_GetSignalingChannelEndpoint_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im AWS SDKs Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint)