Referensi API DescribeLiveDomainRecordUsageData - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Mengkueri jumlah stream perekaman konkuren dan penggunaan konversi format kontainer untuk ApsaraVideo Live.

Deskripsi operasi

Mengumpulkan statistik stream perekaman konkuren harian dan data pengambilan sampel pada interval pengatur waktu yang berbeda. Anda dapat menggunakan operasi ini untuk mengkueri jumlah puncak stream perekaman konkuren harian atau bulanan.
Stream pergeseran waktu tidak dihitung sebagai stream perekaman.
Mendukung kueri tingkat domain dan kueri domain batch. Pisahkan beberapa nama domain dengan koma (,).
Granularitas data: 1 menit. Rentang kueri maksimum: 24 jam. Retensi data maksimum: 60 hari.
Granularitas data: 1 jam. Rentang kueri maksimum: 31 hari. Retensi data maksimum: 180 hari.
Granularitas data: 1 hari. Rentang kueri maksimum: 90 hari. Retensi data maksimum: 366 hari.

Batas QPS

Batas QPS pengguna tunggal untuk operasi ini adalah 10 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi, yang dapat memengaruhi bisnis Anda. Gunakan operasi ini secara wajar.

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:DescribeLiveDomainRecordUsageData

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
DomainName	string	No	Nama domain streaming yang akan dikueri. Mendukung kueri domain tunggal atau batch. Pisahkan beberapa nama domain dengan koma (,). Jika parameter ini dikosongkan, data gabungan dari semua nama domain streaming langsung akan dikembalikan secara default. Saat Anda menentukan DomainName, pastikan nama domain yang ditentukan adalah nama domain streaming langsung dan pemanggil memiliki izin yang diperlukan pada nama domain tersebut.	example.com
StartTime	string	No	Waktu mulai. Tentukan pengatur waktu dalam format yyyy-MM-ddTHH:mm:ssZ UTC. Granularitas data minimum adalah 5 menit. Jika parameter ini tidak ditentukan, data 24 jam terakhir akan dikembalikan secara default. Catatan Waktu mulai dapat diatur ke titik pengatur waktu dalam 90 hari terakhir dari pengatur waktu saat ini, dengan akurasi hingga detik.	2021-05-10T20:00:00Z
EndTime	string	No	Waktu akhir. Tentukan pengatur waktu dalam format yyyy-MM-ddTHH:mm:ssZ UTC. Persyaratan: Waktu akhir harus lebih lambat daripada waktu mulai (StartTime). Rentang pengatur waktu maksimum antara waktu akhir dan waktu mulai adalah 31 hari. Permintaan yang melebihi 31 hari akan gagal dan mengembalikan error.	2021-05-10T21:00:00Z
Region	string	No	Wilayah. Nilai valid: cn-beijing: Beijing. cn-shanghai: Shanghai. cn-shenzhen: Shenzhen. cn-qingdao: Qingdao. ap-southeast-1: Singapura. eu-central-1: Jerman. ap-northeast-1: Tokyo. ap-southeast-5: Jakarta.	cn-shanghai
SplitBy	string	No	Kunci pengelompokan. Nilai valid: domain: mengelompokkan hasil kueri berdasarkan nama domain. record_fmt: mengelompokkan hasil kueri berdasarkan tipe perekaman. Catatan Anda dapat menentukan satu atau lebih nilai. Pisahkan beberapa nilai dengan koma (,). Nilai default: `domain,record_fmt`. Jika parameter ini diatur ke kosong atau `null`, hasil tidak akan dikelompokkan berdasarkan kunci sebelumnya.	domain,record_fmt
Interval	string	No	Granularitas waktu data yang dikueri. Unit: seconds. Nilai valid: Catatan Jika parameter ini tidak ditentukan atau nilai yang tidak didukung ditentukan, granularitas waktu default adalah 300 detik untuk rentang kueri dalam 31 hari dan 86400 detik untuk rentang kueri lebih dari 31 hari.	300

Elemen respons

Element	Type	Description	Example
	object
EndTime	string	Waktu akhir. Format: yyyy-MM-ddTHH:mm:ssZ (UTC).	2021-05-10T21:00:00Z
StartTime	string	Waktu mulai. Format: yyyy-MM-ddTHH:mm:ssZ (UTC).	2021-05-10T20:00:00Z
RequestId	string	ID permintaan.	4B460F8B-993C-4F48-B98A-910811DEBFEB
RecordUsageData	object
DataModule	array<object>	Data penggunaan perekaman untuk setiap interval pengatur waktu.
	object
Type	string	The recording file format. This parameter is returned only if the SplitBy parameter in the request includes `record_fmt`.	MP4
Domain	string	The streaming domain name. This parameter is returned only if the SplitBy parameter in the request includes `domain`.	example.com
Region	string	The region.	cn-shanghai
TimeStamp	string	The start of the time interval.	2021-05-10T20:00:00Z
Duration	integer	The total recording duration. Unit: seconds.	3560
Count	integer	The peak number of concurrent recordings.	1

Contoh

Respons sukses

JSONformat

{
  "EndTime": "2021-05-10T21:00:00Z",
  "StartTime": "2021-05-10T20:00:00Z",
  "RequestId": "4B460F8B-993C-4F48-B98A-910811DEBFEB",
  "RecordUsageData": {
    "DataModule": [
      {
        "Type": "MP4",
        "Domain": "example.com",
        "Region": "cn-shanghai",
        "TimeStamp": "2021-05-10T20:00:00Z",
        "Duration": 3560,
        "Count": 1
      }
    ]
  }
}

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	InvalidTime.Malformed	Specified StartTime or EndTime is malformed.
400	InvalidEndTime.Mismatch	Specified end time does not math the specified start time.	The end time does not match the start time. Make sure that the start and end times match.
400	InvalidTimeSpan	The time span exceeds the limit.	The time span exceeds the limit. Please refer to the API documentation to specify a reasonable time span.
400	InvalidRecordFmt.NotSupported	The RecordFmt parameter is not supported.
400	InvalidStartTime.ValueNotSupported	The specified value of parameter StartTime is not supported.	The value specified for the StartTime parameter is invalid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.