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

GetDataEndpoint

Mendapat titik akhir untuk aliran tertentu untuk membaca atau menulis. Gunakan titik akhir ini dalam aplikasi Anda untuk membaca dari aliran yang ditentukan (menggunakan GetMedia atau GetMediaForFragmentList operasi) atau menulis ke sana (menggunakan PutMedia operasi).

catatan

Titik akhir yang dikembalikan tidak memiliki nama API yang ditambahkan. Klien perlu menambahkan nama API ke titik akhir yang dikembalikan.

Dalam permintaan, tentukan aliran baik oleh StreamName atauStreamARN.

Minta Sintaks

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

{
   "APIName": "string",
   "StreamARN": "string",
   "StreamName": "string"
}

Parameter Permintaan URI

Permintaan tidak menggunakan parameter URI apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam format JSON.

APIName

Nama tindakan API untuk mendapatkan titik akhir.

Jenis: String

Nilai yang Valid: PUT_MEDIA | GET_MEDIA | LIST_FRAGMENTS | GET_MEDIA_FOR_FRAGMENT_LIST | GET_HLS_STREAMING_SESSION_URL | GET_DASH_STREAMING_SESSION_URL | GET_CLIP | GET_IMAGES

Wajib: Ya

StreamARN

Nama Sumber Daya Amazon (ARN) dari aliran yang ingin Anda dapatkan titik akhir. Anda harus menentukan parameter ini atau StreamName dalam permintaan.

Jenis: 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: Tidak

StreamName

Nama aliran yang ingin Anda dapatkan titik akhir. Anda harus menentukan parameter ini atau StreamARN dalam permintaan.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

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

Diperlukan: Tidak

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "DataEndpoint": "string"
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

DataEndpoint

Nilai titik akhir. Untuk membaca data dari aliran atau menulis data ke sana, tentukan titik akhir ini di aplikasi Anda.

Jenis: String

Kesalahan

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

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

NotAuthorizedException

Penelepon tidak berwenang untuk melakukan operasi ini.

Kode Status HTTP: 401

ResourceNotFoundException

Amazon Kinesis Video Streams tidak dapat menemukan aliran yang Anda tentukan.

Kode Status HTTP: 404

Lihat Juga

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