Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Menyediakan titik akhir untuk saluran pensinyalan yang ditentukan untuk mengirim dan menerima pesan. API ini menggunakan parameter `SingleMasterChannelEndpointConfiguration` input, yang terdiri dari `Protocols` dan `Role` properti.

 `Protocols`digunakan untuk menentukan mekanisme komunikasi. Misalnya, jika Anda menetapkan `WSS` sebagai protokol, API ini menghasilkan titik akhir websocket yang aman. Jika Anda menentukan `HTTPS` sebagai protokol, API ini menghasilkan titik akhir HTTPS. Jika Anda menentukan `WEBRTC` sebagai protokol, tetapi saluran pensinyalan tidak dikonfigurasi untuk konsumsi, Anda akan menerima kesalahan. `InvalidArgumentException`

 `Role`menentukan izin pesan. `MASTER`Peran menghasilkan API ini menghasilkan titik akhir yang dapat digunakan klien untuk berkomunikasi dengan pemirsa mana pun di saluran. `VIEWER`Peran menghasilkan API ini menghasilkan titik akhir yang dapat digunakan klien untuk berkomunikasi hanya dengan `MASTER` file. 

## Minta Sintaks
<a name="API_GetSignalingChannelEndpoint_RequestSyntax"></a>

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

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

## Parameter Permintaan URI
<a name="API_GetSignalingChannelEndpoint_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_GetSignalingChannelEndpoint_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [ChannelARN](#API_GetSignalingChannelEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-request-ChannelARN"></a>
Nama Sumber Daya Amazon (ARN) dari saluran pensinyalan yang ingin Anda dapatkan titik akhir.  
Tipe: String  
Batasan Panjang: Panjang minimum 1. Panjang maksimum 1024.  
Pola: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+`   
Wajib: Ya

 ** [SingleMasterChannelEndpointConfiguration](#API_GetSignalingChannelEndpoint_RequestSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-request-SingleMasterChannelEndpointConfiguration"></a>
Struktur yang berisi konfigurasi titik akhir untuk jenis `SINGLE_MASTER` saluran.  
Tipe: Objek [SingleMasterChannelEndpointConfiguration](API_SingleMasterChannelEndpointConfiguration.md)  
Wajib: Tidak

## Sintaksis Respons
<a name="API_GetSignalingChannelEndpoint_ResponseSyntax"></a>

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

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

## Elemen Respons
<a name="API_GetSignalingChannelEndpoint_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [ResourceEndpointList](#API_GetSignalingChannelEndpoint_ResponseSyntax) **   <a name="KinesisVideo-GetSignalingChannelEndpoint-response-ResourceEndpointList"></a>
Daftar titik akhir untuk saluran pensinyalan yang ditentukan.  
Tipe: Array objek [ResourceEndpointListItem](API_ResourceEndpointListItem.md)

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

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Anda tidak memiliki izin yang diperlukan untuk melakukan operasi ini.  
Kode Status HTTP: 401

 ** ClientLimitExceededException **   
Kinesis Video Streams telah membatasi permintaan karena Anda telah melampaui batas panggilan klien yang diizinkan. Coba buat panggilan nanti.  
Kode Status HTTP: 400

 ** InvalidArgumentException **   
Nilai untuk parameter input ini tidak valid.  
Kode Status HTTP: 400

 ** ResourceInUseException **   
Ketika input `StreamARN` atau `ChannelARN` in sudah `CLOUD_STORAGE_MODE` dipetakan ke sumber Kinesis Video Stream yang berbeda, atau jika `StreamARN` input `ChannelARN` yang disediakan atau tidak dalam status Aktif, coba salah satu dari berikut ini:   

1. `DescribeMediaStorageConfiguration`API untuk menentukan saluran aliran yang diberikan dipetakan. 

1. `DescribeMappedResourceConfiguration`API untuk menentukan saluran tempat aliran yang diberikan dipetakan. 

1. `DescribeSignalingChannel`API `DescribeStream` atau untuk menentukan status sumber daya. 
Kode Status HTTP: 400

 ** ResourceNotFoundException **   
Amazon Kinesis Video Streams tidak dapat menemukan aliran yang Anda tentukan.  
Kode Status HTTP: 404

## Lihat Juga
<a name="API_GetSignalingChannelEndpoint_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah 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 untuk V3 JavaScript ](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 for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/GetSignalingChannelEndpoint) 
+  [AWS SDK untuk 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)