CreateSignalingChannel - Amazon Kinesis Video Streams
Minta SintaksParameter Permintaan URIIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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

CreateSignalingChannel

Membuat saluran pensinyalan.

CreateSignalingChanneladalah operasi asinkron.

Minta Sintaks

POST /createSignalingChannel HTTP/1.1
Content-type: application/json

{
   "ChannelName": "string",
   "ChannelType": "string",
   "SingleMasterConfiguration": { 
      "MessageTtlSeconds": number
   },
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ]
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

ChannelName

Nama untuk saluran pensinyalan yang Anda buat. Itu harus unik untuk masing-masing Akun AWS dan Wilayah AWS.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Pola: [a-zA-Z0-9_.-]+

Wajib: Ya

ChannelType

Jenis saluran pensinyalan yang Anda buat. Saat ini, SINGLE_MASTER adalah satu-satunya jenis saluran yang didukung.

Tipe: String

Nilai yang Valid: SINGLE_MASTER | FULL_MESH

Wajib: Tidak

SingleMasterConfiguration

Struktur yang berisi konfigurasi untuk jenis SINGLE_MASTER saluran. Konfigurasi default untuk waktu siaran langsung pesan saluran adalah 60 detik (1 menit).

Tipe: Objek SingleMasterConfiguration

Wajib: Tidak

Tags

Satu set tag (pasangan nilai kunci) yang ingin Anda kaitkan dengan saluran ini.

Tipe: Array objek Tag

Anggota Array: Jumlah minimum 0 item. Jumlah maksimum 50 item.

Diperlukan: Tidak

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "ChannelARN": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

ChannelARN

Nama Sumber Daya Amazon (ARN) dari saluran yang dibuat.

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]+

Kesalahan

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.

AccessDeniedException

Anda tidak memiliki izin yang diperlukan untuk melakukan operasi ini.

Kode Status HTTP: 401

AccountChannelLimitExceededException

Anda telah mencapai batas maksimum saluran pensinyalan aktif untuk ini Akun AWS di wilayah ini.

Kode Status HTTP: 400

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. DescribeMediaStorageConfigurationAPI untuk menentukan saluran aliran yang diberikan dipetakan.

  2. DescribeMappedResourceConfigurationAPI untuk menentukan saluran tempat aliran yang diberikan dipetakan.

  3. DescribeSignalingChannelAPI DescribeStream atau untuk menentukan status sumber daya.

Kode Status HTTP: 400

TagsPerResourceExceededLimitException

Anda telah melampaui batas tag yang dapat Anda kaitkan dengan sumber daya. Aliran video Kinesis dapat mendukung hingga 50 tag.

Kode Status HTTP: 400

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini: