DescribeLiveDomainStreamTranscodeData - ApsaraVideo Live

Deskripsi operasi

Operasi ini mengkueri data penggunaan Transkoding dalam interval waktu tertentu.
Anda dapat mengkueri data untuk beberapa Nama domain dalam satu panggilan dengan memisahkan Nama domain menggunakan koma (,).
Anda dapat mengkueri data hingga 90 hari terakhir.
Data tersedia dengan granularitas waktu per jam atau per hari.
Untuk informasi selengkapnya mengenai tier penagihan berdasarkan jenis dan resolusi Transkoding, lihat penagihan Transkoding siaran langsung.

Batas QPS

Batas permintaan per detik (QPS) untuk operasi ini adalah 20 per pengguna. Jika jumlah panggilan per detik melebihi batas tersebut, Pembatasan kecepatan akan dipicu dan dapat memengaruhi bisnis Anda. Kami menyarankan agar Anda merencanakan panggilan secara sesuai.

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

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID Wilayah.	cn-shanghai
DomainName	string	No	Nama domain streaming yang akan dikueri. Anda dapat mengkueri satu Nama domain atau multiple Nama domain. Untuk mengkueri multiple Nama domain, pisahkan dengan koma (,). Jika Anda tidak mengisi parameter ini, data gabungan untuk semua domain siaran langsung akan dikembalikan. Jika Anda menentukan parameter ini, pastikan bahwa Nama domain tersebut merupakan domain siaran langsung dan Anda memiliki izin yang diperlukan untuk mengoperasikannya.	example.com
StartTime	string	Yes	Awal rentang waktu yang akan dikueri. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC. Granularitas waktu minimum adalah 1 jam. Jika Anda tidak menentukan parameter ini, data dari 24 jam terakhir akan dikueri.	2017-12-10T20:00:00Z
EndTime	string	Yes	Akhir rentang waktu yang akan dikueri. Tentukan waktu dalam format yyyy-MM-ddTHH:mm:ssZ. Waktu harus dalam UTC.	2017-12-10T22:00:00Z
Precision	string	No	Presisi waktu kueri. Nilai yang valid: min (default): Data dikembalikan per menit. sec: Data dikembalikan per detik.	min
Interval	string	No	Granularitas waktu kueri. Satuan: detik. Nilai yang valid: 3600: per jam. 86400: per hari. Catatan Jika Anda tidak menentukan parameter ini, data dikembalikan per jam secara default.	3600
Split	string	No	Kunci untuk mengelompokkan data. Nilai yang valid: domain: Nama domain. Jika Anda mengatur parameter Split ke domain, parameter Domain akan dikembalikan. region: Wilayah Pusat Siaran Langsung. Jika Anda mengatur parameter Split ke region, parameter Region akan dikembalikan. transcode_type: jenis Transkoding. Jika Anda mengatur parameter Split ke transcode_type, parameter TanscodeType akan dikembalikan. resolution: resolusi. Jika Anda mengatur parameter Split ke resolution, parameter Resolution akan dikembalikan. fps: laju frame. Jika Anda mengatur parameter Split ke fps, parameter Fps akan dikembalikan. Anda dapat menentukan satu atau beberapa kunci. Pisahkan beberapa kunci dengan koma (,). Nilai default adalah `domain,region,transcode_type,resolution,fps`, yang mengelompokkan data berdasarkan semua kunci.	domain

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	3C6CCEC4-6B88-4D4A-93E4-D47B******
TranscodeDataList	object
TranscodeData	array<object>	Data Transkoding untuk setiap interval waktu.
	object
TanscodeType	string	Jenis Transkoding. Nilai yang valid: Catatan Parameter ini hanya dikembalikan jika Anda mengatur parameter Split ke transcode_type. H264NBHD: Transkoding Narrowband HD H.264. H265NBHD: Transkoding Narrowband HD H.265. AUDIO: Transkoding audio.	H264STD
Domain	string	Nama domain streaming. Catatan Parameter ini hanya dikembalikan jika Anda mengatur parameter Split ke domain.	example.com
Region	string	Wilayah tempat Nama domain berada. Nilai yang valid: Catatan Parameter ini hanya dikembalikan jika Anda mengatur parameter Split 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. Satuan: menit.	2000
TimeStamp	string	Waktu mulai irisan waktu.	2017-12-10T20:00:00Z
Fps	string	Laju frame. Catatan Parameter ini hanya dikembalikan jika Anda mengatur parameter Split ke fps.	normal
Resolution	string	Resolusi. Nilai yang valid: Catatan Parameter ini hanya dikembalikan jika Anda mengatur parameter Split ke resolution. 2K 4K LD: definisi rendah. SD: definisi standar. HD: definisi tinggi. def: audio.	HD

## Kode kesalahan khusus | Kode kesalahan | Pesan kesalahan | Kode status HTTP | Deskripsi | | ---------- | ------------- | ---------------- | ----------- | | Throttling | Permintaan ditolak karena Pembatasan permintaan. | 503 | Laju permintaan melebihi batas. | | InvalidDomain.NotFound | Domain yang diberikan bukan milik Anda. | 404 | Nama domain yang ditentukan tidak ada atau bukan milik Akun Alibaba Cloud Anda. |

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
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.
400	InvalidEndTime.Mismatch	Specified end time does not math the specified start time.
400	InvalidTimeSpan	The time span exceeds the limit.
400	InvalidStartTime.ValueNotSupported	The specified value of parameter StartTime is not supported.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.