All Products
Search

This Product

    ApsaraVideo Live:DescribeLiveUserStreamMetricData

    Document Center

    ApsaraVideo Live:DescribeLiveUserStreamMetricData

    Last Updated:Jun 22, 2026

    Mengkueri data batch level stream untuk domain streaming tertentu. Beberapa protokol didukung.

    Deskripsi operasi

    Catatan

    Mengkueri koneksi baru untuk protokol HLS tidak didukung. Koneksi bersamaan untuk HLS dihitung berdasarkan permintaan dalam format default. Permintaan dalam format khusus memerlukan konfigurasi dengan mengirimkan tiket. Format default adalah sebagai berikut:

    • Contoh permintaan m3u8: http(s)://example.aliyundoc.com/Appname/ StreamName.m3u8

    • Contoh permintaan ts: http(s)://example.aliyundoc.com/Appname/ StreamName/153xxxxxxxx_137xxxxx.ts.

    Pengaturan

    • Batas kueri tunggal: Maksimum 5000 baris data dapat dikembalikan per kueri.

    • Batas kueri nama domain: Hanya satu nama domain yang didukung. Kesalahan akan dikembalikan jika beberapa nama domain ditentukan.

    • Batas rentang waktu: Rentang waktu kueri maksimum adalah 24 jam.

    • Batas granularitas waktu: Granularitas kueri minimum adalah 1 menit.

    • Batas jangkauan kueri: Jangkauan kueri maksimum adalah 31 hari.

    • Batas frekuensi panggilan: Frekuensi panggilan maksimum per pengguna adalah 10 panggilan per detik.

    • Kombinasi parameter khusus: Ketika DomainName tidak kosong dan baik AppName maupun StreamName diatur ke all, data agregat untuk domain streaming akan dikembalikan.

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

    none

    *All Resource

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    DomainName

    string

    No

    Domain streaming yang akan dikueri.

    Catatan

    Hanya satu nama domain yang didukung. Kesalahan akan dikembalikan jika beberapa nama domain ditentukan. Jika nama domain kosong, data agregat untuk semua domain streaming di bawah pengguna akan dikueri. Jika AppName dan StreamName tidak ditentukan, data level stream untuk semua stream di bawah domain akan dikembalikan.

    test.com
    StartTime

    string

    Yes

    Awal rentang waktu yang akan dikueri. Tentukan waktu dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu harus dalam UTC.

    2015-12-10T20:00:00Z
    EndTime

    string

    Yes

    Akhir rentang waktu yang akan dikueri. Waktu akhir harus lebih lambat dari waktu mulai dan selisihnya tidak boleh melebihi 1 hari. Tentukan waktu dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ. Waktu harus dalam UTC.

    2015-12-10T21:00:00Z
    AppName

    string

    No

    Nama aplikasi. Tentukan nama aplikasi untuk mengkueri data level stream untuk aplikasi yang sesuai. Jika StreamName ditentukan, AppName juga harus ditentukan.

    app
    StreamName

    string

    No

    Nama stream. Jika StreamName ditentukan, data level stream untuk StreamName yang ditentukan di bawah AppName yang ditentukan akan dikembalikan. Jika StreamName ditentukan, AppName juga harus ditentukan.

    test.flv
    Protocol

    string

    No

    Nama protokol stream. Tentukan nama protokol untuk mengkueri data untuk protokol yang sesuai. Protokol yang didukung: flv, hls, rtmp, rts, p2p. Anda dapat mengkueri data untuk beberapa protokol dengan memisahkannya menggunakan koma (,). Data untuk beberapa protokol tidak diagregasi dan dikeluarkan pada level stream.

    Catatan

    Opsi rts mengkueri stream Real-Time Streaming (RTS) menggunakan protokol ARTC.

    • Saat menggunakan rts, Anda mungkin perlu menghitung tambahan stream transcoding xxx_AliRTS-opus. Ini karena saat memutar stream RTS di web, stream transcoding dengan akhiran _AliRTS-opus yang ditambahkan ke nama stream secara otomatis dihasilkan, menghasilkan data stream transcoding. Untuk informasi lebih lanjut, lihat Transcoding otomatis latensi sub-detik RTS.

    flv
    PageNumber

    integer

    Yes

    Nomor halaman.

    1
    PageSize

    integer

    Yes

    Jumlah entri per halaman. Nilai maksimum: 5000.

    10

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons

    DomainName

    string

    Informasi domain streaming.

    test.com
    EndTime

    string

    YYYY-MM-DDThh:mm:ssZ

    2015-12-10T21:00:00Z
    PageSize

    integer

    Jumlah entri per halaman.

    10
    RequestId

    string

    ID permintaan.

    16A96B9A-F203-4EC5-8E43-CB92E68F****
    StartTime

    string

    Awal rentang waktu yang dikueri. Waktu dalam standar ISO 8601 dengan format YYYY-MM-DDThh:mm:ssZ dalam UTC.

    2015-12-10T20:00:00Z
    StreamDetailData

    array<object>

    Data lalu lintas untuk setiap interval waktu.

    object

    Grup data yang dikembalikan.

    AppName

    string

    Nama aplikasi. Nilai ini dikembalikan terlepas dari apakah ditentukan atau tidak.

    app
    Bps

    number

    Total bandwidth per menit untuk stream, dalam bps.

    423304182.66
    Count

    integer

    Total jumlah koneksi bersamaan per menit untuk stream.

    Catatan

    Koneksi bersamaan mengacu pada jumlah koneksi proses klien ke stream yang sama dalam satu unit waktu.

    423304182
    FlvBps

    number

    Bandwidth untuk protokol FLV, dalam bps. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    454
    FlvCount

    integer

    Jumlah koneksi bersamaan untuk protokol FLV. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    32
    FlvTraffic

    number

    Lalu lintas untuk protokol FLV, dalam byte. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    1254
    HlsBps

    number

    Bandwidth untuk protokol HLS, dalam bps. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    4456
    HlsCount

    integer

    Jumlah koneksi bersamaan untuk protokol HLS. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    56
    HlsTraffic

    number

    Lalu lintas untuk protokol HLS, dalam byte. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    568
    NewConns

    integer

    Jumlah koneksi baru per menit untuk stream.

    450
    P2pBps

    number

    Bandwidth untuk protokol P2P, dalam bps. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    6845
    P2pCount

    integer

    Jumlah koneksi bersamaan untuk protokol P2P. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    78
    P2pTraffic

    number

    Lalu lintas untuk protokol P2P, dalam byte. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    4102
    RtmpBps

    number

    Bandwidth untuk protokol RTMP, dalam bps. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    3323
    RtmpCount

    integer

    Jumlah koneksi bersamaan untuk protokol RTMP. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    63
    RtmpTraffic

    number

    Lalu lintas untuk protokol RTMP, dalam byte. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    5568
    RtsBps

    number

    Bandwidth untuk protokol RTS, dalam bps. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    2361
    RtsCount

    integer

    Jumlah koneksi bersamaan untuk protokol RTS. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    89
    RtsTraffic

    number

    Lalu lintas untuk protokol RTS, dalam byte. Bidang ini tidak dikembalikan jika protokol yang ditentukan tidak cocok.

    2322
    StreamName

    string

    Nama stream. Nilai ini dikembalikan terlepas dari apakah ditentukan atau tidak.

    test.flv
    TimeStamp

    string

    Waktu mulai dari potongan waktu. Waktu dalam standar ISO 8601 dengan format yyyy-MM-ddTHH:mm:ssZ dalam UTC+0.

    2015-12-10T20:00:00Z
    Traffic

    number

    Total lalu lintas per menit untuk stream, dalam byte.

    423304182
    TotalCount

    integer

    Total jumlah entri.

    50
    PageNumber

    integer

    Nomor halaman.

    1

    Contoh

    Respons sukses

    JSONformat

    {
  "DomainName": "test.com",
  "EndTime": "2015-12-10T21:00:00Z",
  "PageSize": 10,
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F****",
  "StartTime": "2015-12-10T20:00:00Z",
  "StreamDetailData": [
    {
      "AppName": "app",
      "Bps": 423304182.66,
      "Count": 423304182,
      "FlvBps": 454,
      "FlvCount": 32,
      "FlvTraffic": 1254,
      "HlsBps": 4456,
      "HlsCount": 56,
      "HlsTraffic": 568,
      "NewConns": 450,
      "P2pBps": 6845,
      "P2pCount": 78,
      "P2pTraffic": 4102,
      "RtmpBps": 3323,
      "RtmpCount": 63,
      "RtmpTraffic": 5568,
      "RtsBps": 2361,
      "RtsCount": 89,
      "RtsTraffic": 2322,
      "StreamName": "test.flv",
      "TimeStamp": "2015-12-10T20:00:00Z",
      "Traffic": 423304182
    }
  ],
  "TotalCount": 50,
  "PageNumber": 1
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 Meter.ParamError Param Error:%s,Please Check Again.
    500 Meter.ServerInternalError The Request Processing Has Failed Due To Some Unknown Error.
    500 Meter.DataSourceQueryError Data Source Error:%s,Please Try Again.
    403 Meter.AuthError Authentication Failed,Please Try Again.
    502 Meter.ReadyTsError Get ReadyTs Failed,Please Try Again.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.