Query Data Transcoding Langsung dengan DescribeLiveDomainStreamTranscodeData - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Mengkueri data penggunaan Transkoding untuk sebuah Nama domain.

Deskripsi operasi

Anda dapat menggunakan operasi ini untuk mengkueri data lebar pita jaringan untuk setiap interval waktu.
Kueri Batch Nama domain didukung. Pisahkan beberapa Nama domain dengan koma (,).
Anda dapat mengkueri data dari 90 hari terakhir.
Granularitas waktu data adalah jam atau hari.
Untuk tingkat penagihan yang sesuai dengan jenis Transkoding dan resolusi Transkoding yang berbeda, lihat deskripsi tingkat penagihan untuk spesifikasi instans yang berbeda di Penagihan Transkoding aliran langsung.

Batas QPS

Batas QPS per pengguna tunggal untuk operasi ini adalah 20 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi (throttled), yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan tepat.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

live:DescribeLiveDomainStreamTranscodeData

get

*Semua sumber daya.

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
DomainName	string	No	Domain streaming Streamer yang akan dikueri. Anda dapat mengkueri satu Nama domain atau beberapa Nama domain sekaligus. Pisahkan beberapa Nama domain dengan koma (,). Jika parameter ini dibiarkan kosong, data gabungan dari semua Nama domain siaran langsung akan dikembalikan secara default. Saat menentukan DomainName, pastikan bahwa Nama domain yang ditentukan adalah Nama domain siaran langsung dan bahwa pengguna yang memanggil operasi ini memiliki izin untuk beroperasi pada Nama domain yang ditentukan.	example.com
StartTime	string	Yes	Awal Rentang Waktu yang akan dikueri. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ UTC. Granularitas waktu data minimum adalah 1 jam. Jika parameter ini dibiarkan kosong, data dari 24 jam terakhir akan dibaca secara default.	2017-12-10T20:00:00Z
EndTime	string	Yes	Akhir Rentang Waktu yang akan dikueri. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ UTC.	2017-12-10T22:00:00Z
Precision	string	No	Presisi waktu kueri. Nilai valid: min (default): dalam menit. sec: dalam detik. Valid values: sec : dalam detik. min : dalam menit.	min
Interval	string	No	Granularitas waktu kueri. Unit: detik. Nilai valid: 3600: per jam. 86400: per hari. Catatan Jika parameter ini dibiarkan kosong, granularitas default adalah per jam. Valid values: 3600 : per jam. 86400 : per hari.	3600
Split	string	No	Kunci pengelompokan. Nilai valid: domain: Nama domain. Jika parameter Split (kunci pengelompokan) diatur ke domain, parameter respons Domain akan berlaku. region: wilayah Pusat Siaran Langsung. Jika parameter Split (kunci pengelompokan) diatur ke region, parameter respons Region akan berlaku. transcode_type: jenis Transkoding. Jika parameter Split (kunci pengelompokan) diatur ke transcode_type, parameter respons TanscodeType akan berlaku. resolution: resolusi. Jika parameter Split (kunci pengelompokan) diatur ke resolution, parameter respons Resolution akan berlaku. fps: laju frame. Jika parameter Split (kunci pengelompokan) diatur ke fps, parameter respons Fps akan berlaku. Anda dapat menentukan satu atau lebih nilai. Pisahkan beberapa nilai dengan koma (,). Nilai default: `domain,region,transcode_type,resolution,fps`, yang berarti semua kunci pengelompokan diterapkan.	domain

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	3C6CCEC4-6B88-4D4A-93E4-D47B******
TranscodeDataList	object
TranscodeData	array<object>	Data lebar pita jaringan untuk setiap interval waktu.
	object
TanscodeType	string	Jenis transkoding. Nilai valid: Catatan Parameter respons ini hanya berlaku jika parameter permintaan Split diatur ke transcode_type. H264NBHD: Transkoding H.264 Narrowband HD™. H265NBHD: Transkoding H.265 Narrowband HD™. AUDIO: Transkoding audio.	H264STD
Domain	string	Domain aliran Streamer. Catatan Parameter respons ini hanya berlaku jika parameter permintaan Split diatur ke domain.	example.com
Region	string	Wilayah tempat nama domain berada. Nilai valid: Catatan Parameter respons ini hanya berlaku jika parameter permintaan Split diatur ke region. cn-beijing: Beijing. cn-shanghai: Shanghai. cn-qingdao: Qingdao. cn-shenzhen: Shenzhen. ap-northeast-1: Jepang. ap-southeast-1: Singapura. ap-southeast-5: Indonesia. eu-central-1: Jerman.	cn-beijing
Duration	integer	Durasi. Unit: menit.	2000
TimeStamp	string	Awal interval waktu. Waktu dalam format yyyy-MM-ddTHH:mm:ssZ UTC.	2017-12-10T20:00:00Z
Fps	string	Laju frame. Catatan Parameter respons ini hanya berlaku jika parameter permintaan Split diatur ke fps.	normal
Resolution	string	Resolusi. Nilai valid: Catatan Parameter respons ini hanya berlaku jika parameter permintaan Split diatur ke resolution. 2K 4K LD: definisi rendah. SD: definisi standar. HD: definisi tinggi. def: audio.	HD

Contoh

Respons sukses

JSONformat

{
  "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B******",
  "TranscodeDataList": {
    "TranscodeData": [
      {
        "TanscodeType": "H264STD",
        "Domain": "example.com",
        "Region": "cn-beijing",
        "Duration": 2000,
        "TimeStamp": "2017-12-10T20:00:00Z",
        "Fps": "normal",
        "Resolution": "HD"
      }
    ]
  }
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidStartTime.Malformed	Specified StartTime is malformed.
400	InvalidEndTime.Malformed	Specified EndTime is malformed.
400	InvalidParamPrecision	The parameter Precision is invalid, please check StartTime and EndTime or Precision.	Parameter Precision tidak valid. Periksa parameter StartTime, EndTime, atau Precision.
400	InvalidEndTime.Mismatch	Specified end time does not math the specified start time.	Waktu akhir tidak cocok dengan waktu mulai. Verifikasi bahwa waktu konsisten.
400	InvalidTimeSpan	The time span exceeds the limit.	Rentang pengatur waktu melebihi batas. Lihat dokumentasi API untuk mengonfigurasi rentang pengatur waktu kueri yang valid.
400	InvalidStartTime.ValueNotSupported	The specified value of parameter StartTime is not supported.	Parameter StartTime yang ditentukan tidak didukung.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.