All Products
Search

This Product

    ApsaraVideo Live:DescribeLiveRtcRecordUsageData

    Document Center

    ApsaraVideo Live:DescribeLiveRtcRecordUsageData

    Last Updated:Jul 15, 2026

    Mengkueri penggunaan rekaman cloud ApsaraVideo Real-time Communication.

    Deskripsi operasi

    • Mengkueri durasi rekaman untuk setiap spesifikasi rekaman cloud secara harian.

    • Mendukung kueri pada granularitas aplikasi ApsaraVideo Real-time Communication.

    Batas QPS

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

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

    none

    *Semua sumber daya.

    *

    		 None None

    Sintaks permintaan

    GET  HTTP/1.1

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    StartTime

    string

    Yes

    Waktu mulai pengatur waktu untuk kueri. Format: yyyy-MM-ddTHH:mm:ssZ (waktu UTC).

    2017-12-21T08:00:00Z
    EndTime

    string

    Yes

    Waktu akhir pengatur waktu untuk kueri. Granularitas kueri harus ≥ 5 menit dan ≤ 31 hari. Format: yyyy-MM-ddTHH:mm:ssZ (waktu UTC).

    2022-10-10T21:00:00Z
    AppId

    string

    Yes

    ID aplikasi ApsaraVideo Real-time Communication. Anda dapat melihat ID di Tampilan manajemen aplikasi ApsaraVideo Real-time Communication. Navigasi ke ApsaraVideo Live > Live+ > Real-time Communication > Application Management untuk melihat ID aplikasi Anda.

    intl7f92-a5a8*************7ce4eb44a6
    RecordMode

    string

    Yes

    Mode rekaman. Nilai valid:

    • 0: mode rekaman single-stream.

    • 1: mode rekaman stream mixing.

    0
    Interval

    string

    No

    Granularitas pengatur waktu untuk data kueri. Unit: detik. Nilai valid:

    • 3600 (default).

    3600

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema respons.

    RequestId

    string

    ID permintaan.

    16A96B9A-F2*************B92E68F4CD8
    RecordMode

    string

    Mode rekaman. Nilai valid:

    • 0: mode rekaman single-stream.

    • 1: mode rekaman stream mixing.

    0
    AppId

    string

    ID aplikasi ApsaraVideo Real-time Communication yang dikueri.

    7fd341b3-c6fa-43e1-96b8-7295a1dd****
    TotalSummaryDuration

    number

    Durasi ringkasan total. Unit: detik.

    150
    AudioSummaryDuration

    number

    Durasi ringkasan audio saja. Unit: detik.

    20
    V480SummaryDuration

    number

    Durasi ringkasan video pada resolusi 480p atau lebih rendah. Unit: detik.

    30
    V720SummaryDuration

    number

    Durasi ringkasan video pada resolusi 720p atau lebih rendah. Unit: detik.

    40
    V1080SummaryDuration

    number

    Durasi ringkasan video di atas 720p (termasuk 1080p). Unit: detik.

    10
    Data

    array<object>

    Informasi statistik penggunaan.

    object

    Informasi statistik penggunaan.

    Timestamp

    string

    Stempel waktu titik data. Format: yyyy-MM-ddTHH:mm:ssZ (waktu UTC).

    2022-10-10T20:00:00Z
    TotalDuration

    number

    Durasi total. Unit: detik.

    150
    AudioDuration

    number

    Durasi audio saja. Unit: detik.

    20
    V480Duration

    number

    Durasi video pada resolusi 480p atau lebih rendah. Unit: detik.

    30
    V720Duration

    number

    Durasi video pada resolusi 720p atau lebih rendah. Unit: detik.

    40
    V1080Duration

    number

    Durasi video di atas 720p. Unit: detik.

    10

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "16A96B9A-F2*************B92E68F4CD8",
  "RecordMode": "0",
  "AppId": "7fd341b3-c6fa-43e1-96b8-7295a1dd****",
  "TotalSummaryDuration": 150,
  "AudioSummaryDuration": 20,
  "V480SummaryDuration": 30,
  "V720SummaryDuration": 40,
  "V1080SummaryDuration": 10,
  "Data": [
    {
      "Timestamp": "2022-10-10T20:00:00Z",
      "TotalDuration": 150,
      "AudioDuration": 20,
      "V480Duration": 30,
      "V720Duration": 40,
      "V1080Duration": 10
    }
  ]
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidStartTime.ValueNotSupported The specified value of parameter StartTime is not supported. Parameter StartTime yang ditentukan tidak didukung.
    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 InvalidRecordModeParameter RecordMode parameter error. Parameter RecordMode tidak valid.
    400 InvalidAppIdParameter AppId parameter error. Parameter AppId tidak valid.
    400 InvalidTimeSpan The time span exceeds the limit. Rentang pengatur waktu melebihi batas. Lihat dokumentasi API untuk mengonfigurasi rentang pengatur waktu kueri yang valid.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.