All Products
Search

This Product

    ApsaraVideo Live:UpdateLiveStreamMonitor

    Document Center

    ApsaraVideo Live:UpdateLiveStreamMonitor

    Last Updated:Jun 10, 2026

    Memperbarui konfigurasi sesi pemantauan.

    Deskripsi operasi

    This operation updates the configuration of a monitoring session. If the monitoring session is running, updates to the input source configuration take effect in real time.

    QPS limit

    The queries per second (QPS) limit for a single user is 10. API calls that exceed this limit are throttled. Throttling can affect your business, so we recommend that you plan your calls accordingly.

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

    update

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    ID wilayah.

    cn-shanghai
    MonitorId

    string

    Yes

    ID sesi pemantauan.

    Catatan

    Dapatkan nilai MonitorId dari parameter tanggapan operasi CreateLiveStreamMonitor.

    445409ec-7eaa-461d-8f29-4bec2eb9****
    MonitorName

    string

    No

    Nama sesi pemantauan.

    liveMonitor****
    Domain

    string

    No

    Nama domain output untuk sesi pemantauan.

    demo.aliyundoc.com
    App

    string

    No

    Nama aplikasi untuk aliran output sesi pemantauan. Anda dapat menentukan nama kustom. Jika Anda tidak menentukan parameter ini, monitor digunakan sebagai AppName.

    monitor****
    Stream

    string

    No

    Nama aliran output untuk sesi pemantauan.

    monitorStream****
    OutputTemplate

    string

    No

    Templat output untuk sesi pemantauan. Nilai valid:

    • lp_ld: definisi rendah.

    • lp_sd: definisi standar.

    • lp_hd: definisi tinggi.

    • lp_ud: definisi ultra tinggi.

    lp_ud
    InputList

    string

    Yes

    Daftar aliran input yang akan dipantau. Untuk informasi selengkapnya, lihat tabel InputConfig di bawah.

    InputConfig
    MonitorConfig

    string

    No

    Pengaturan untuk ambang batas peringatan. Nilainya adalah string JSON. Untuk informasi selengkapnya, lihat tabel MonitorConfig di bawah.

    "{\"fpsLowThres\": 0.6,\"brLowThres\": 1.1,\"eofDurationThresSec\": 10}"
    CallbackUrl

    string

    No

    Alamat webhook. HTTP dan HTTPS didukung.

    http://guide.aliyundoc.com/notify
    DingTalkWebHookUrl

    string

    No

    URL webhook chatbot DingTalk. Peringatan pemantauan dikirim ke kelompok DingTalk menggunakan chatbot. Siapkan chatbot lalu masukkan URL webhook-nya, yang harus berupa alamat HTTP atau HTTPS. Untuk informasi selengkapnya, lihat Custom robot access.

    Catatan

    Atur kata kunci kustom chatbot DingTalk menjadi "Alerting". Jika tidak, pesan tidak dapat diterima.

    https://oapi.dingtalk.com/robot/send?access_token=7a7d404056eee1f2fd944ace9bcfc361dc6448583e1d3d3baa****

    InputConfig.

    NamaTipeDeskripsiContoh
    IndexIntegerIndeks. Parameter ini digunakan oleh frontend.1
    LayoutIdIntegerID tata letak. Nilai harus dimulai dari 1.1
    StreamNameStringNama tampilan aliran yang dipantau.monitorStream****
    InputUrlStringURL aliran input.demo.aliyundoc.com
    LayoutConfigLayoutConfigInformasi tata letak.Untuk informasi selengkapnya, lihat tabel LayoutConfig di bawah.
    PlayConfigPlayConfigKonfigurasi pemutaran.Untuk informasi selengkapnya, lihat tabel PlayConfig di bawah.

    LayoutConfig.

    NamaTipeDeskripsiContoh
    FillModeStringMode pengisian. Atur parameter ini ke none untuk frontend.none
    PositionReferStringTitik referensi untuk posisi elemen. Nilai valid: TopLeft, TopRight, BottomLeft, dan BottomRight.TopLeft
    PositionNormalizedFloatPosisi yang dinormalisasi dari area pengisian untuk elemen lapisan. Nilai dalam format [x,y]. Nilai x dan y berkisar dari 0 hingga 1. Misalnya, [0.1, 0.1] menunjukkan offset horizontal 10% dan offset vertikal 10% dari sudut kiri atas.[0.1, 0.1]
    SizeNormalizedFloatUkuran area pengisian untuk elemen lapisan. Nilai dalam format [w,h]. Nilai w dan h berkisar dari 0 hingga 1. Baik lebar maupun tinggi dinormalisasi. Misalnya, [0.2, 0.3] menunjukkan proporsi horizontal 20% dan proporsi vertikal 30%.[0.2, 0.3]

    PlayConfig.

    NamaTipeDeskripsiContoh
    VolumeRateFloatVolume. Nilai berkisar dari 0 hingga 1, akurat hingga dua desimal.0.50

    MonitorConfig.

    NamaTipeDeskripsiContoh
    fpsLowThresFloatAmbang batas peringatan untuk frame rate video. Ambang batas ini adalah koefisien. Nilai harus berada dalam rentang (0.0, 1.0]. Nilai default adalah 0.7. Peringatan dipicu jika frame rate video aliran yang dipantau kurang dari (ambang batas peringatan × frame rate asli aliran langsung).0.7
    brHighThresFloatAmbang batas peringatan untuk bitrate audio dan video. Ambang batas ini adalah koefisien. Nilai harus berada dalam rentang (0.0, 100]. Nilai default adalah 1.0. Peringatan dipicu jika bitrate audio dan video aliran yang dipantau lebih besar dari (ambang batas peringatan × bitrate asli aliran langsung).1.0
    eofDurationThresSecFloatAmbang batas untuk deteksi gangguan aliran, dalam detik. Peringatan dipicu jika aliran yang dipantau terganggu selama durasi yang lebih lama dari ambang batas ini. Nilai harus berada dalam rentang (0, 65535]. Nilai default adalah 0. Setelah aliran terganggu, koneksi tetap aktif. Sistem menentukan bahwa aliran terganggu jika terjadi pengatur waktu habis penerimaan paket selama 5 s. Oleh karena itu, jika Anda mengatur parameter ini ke nilai kurang dari atau sama dengan 5 s, waktu deteksi aktual adalah 5 s. Jika Anda mengatur parameter ini ke nilai lebih besar dari 5 s, waktu deteksi aktual adalah nilai yang Anda atur. 5 s pertama untuk pengatur waktu habis penerimaan paket internal, dan waktu yang tersisa adalah durasi sistem menunggu aliran melanjutkan. Jika aliran melanjutkan sebelum periode pengatur waktu habis berakhir, tidak ada peringatan yang dipicu. Jika Anda mengubah alamat pemantauan sebelum aliran kehabisan pengatur waktu, sistem berhenti mendeteksi pengatur waktu habis dan tidak memicu peringatan untuk aliran sebelumnya.10

    Elemen respons

    Element

    Type

    Description

    Example

    object

    RequestId

    string

    The request ID.

    5c6a2a0d-f228-4a64-af62-20e91b9676b3

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "5c6a2a0d-f228-4a64-af62-20e91b9676b3"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 InvalidUserId.Malformed %s, please check userId.
    400 InvalidParameter.Malformed There are invalid parameters: %s.
    400 MissingParameter %s.
    400 InvalidMonitorId.Malformed %s, please check and try again later.
    401 IllegalOperation %s, please check and try again later.
    500 InternalError %s, please try again later.
    404 InvalidDomainName.NotFound %s, please check and try again later.
    404 StreamMonitorNotExist %s, please check and try again later.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.