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

CreateStream

Membuat aliran video Kinesis baru.

Saat Anda membuat streaming baru, Kinesis Video Streams memberinya nomor versi. Saat Anda mengubah metadata streaming, Kinesis Video Streams memperbarui versi.

CreateStreamadalah operasi asinkron.

Untuk informasi tentang cara kerja layanan, lihat Cara Kerjanya.

Anda harus memiliki izin untuk KinesisVideo:CreateStream tindakan tersebut.

Minta Sintaks

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

{
   "DataRetentionInHours": number,
   "DeviceName": "string",
   "KmsKeyId": "string",
   "MediaType": "string",
   "StreamName": "string",
   "Tags": { 
      "string" : "string" 
   }
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

DataRetentionInHours

Jumlah jam yang Anda inginkan untuk menyimpan data dalam aliran. Kinesis Video Streams menyimpan data dalam penyimpanan data yang terkait dengan aliran.

Nilai defaultnya adalah 0, menunjukkan bahwa aliran tidak mempertahankan data. Minimal adalah 1 jam.

Ketika DataRetentionInHours nilainya 0, konsumen masih dapat mengkonsumsi fragmen yang tersisa di buffer host layanan, yang memiliki batas waktu retensi 5 menit dan batas memori retensi 200 MB. Fragmen dihapus dari buffer ketika salah satu batas tercapai.

Tipe: Bilangan Bulat

Rentang yang Valid: Nilai minimum 0.

Wajib: Tidak

DeviceName

Nama perangkat yang menulis ke aliran.

catatan

Dalam implementasi saat ini, Kinesis Video Streams tidak menggunakan nama ini.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

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

Wajib: Tidak

KmsKeyId

ID kunci AWS Key Management Service (AWS KMS) yang ingin Anda gunakan Kinesis Video Streams untuk mengenkripsi data streaming.

Jika tidak ada ID kunci yang ditentukan, default, Kinesis Video-managed key () aws/kinesisvideo digunakan.

Untuk informasi selengkapnya, lihat DescribeKey.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 2048.

Pola: .+

Wajib: Tidak

MediaType

Jenis media dari aliran. Konsumen aliran dapat menggunakan informasi ini saat memproses aliran. Untuk informasi selengkapnya tentang jenis media, lihat Jenis Media. Jika Anda memilih untuk menentukanMediaType, lihat Persyaratan Penamaan untuk pedoman.

Contoh nilai yang valid termasuk "video/h264" and "video/h264,audio/aac”.

Parameter ini opsional; nilai default adalah null (atau kosong di JSON).

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 128.

Pola: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*

Wajib: Tidak

StreamName

Nama untuk aliran yang Anda buat.

Nama aliran adalah pengenal untuk aliran, dan harus unik untuk setiap akun dan wilayah.

Tipe: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

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

Wajib: Ya

Tags

Daftar tag untuk dikaitkan dengan aliran yang ditentukan. Setiap tag adalah pasangan kunci-nilai (nilainya opsional).

Tipe: Peta string ke string

Entri Peta: Jumlah maksimum 50 item.

Batasan Panjang Kunci: Panjang minimum 1. Panjang maksimum 128.

Pola Kunci: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

Batasan Panjang Nilai: Panjang minimum 0. Panjang maksimum 256.

Pola nilai: [\p{L}\p{Z}\p{N}_.:/=+\-@]*

Wajib: Tidak

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "StreamARN": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

StreamARN

Nama Sumber Daya Amazon (ARN) dari aliran.

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.

AccountStreamLimitExceededException

Jumlah aliran yang dibuat untuk akun terlalu tinggi.

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

DeviceStreamLimitExceededException

Tidak diimplementasikan.

Kode Status HTTP: 400

InvalidArgumentException

Nilai untuk parameter input ini tidak valid.

Kode Status HTTP: 400

InvalidDeviceException

Tidak diimplementasikan.

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: