All Products
Search

This Product

    ApsaraVideo Live:DescribeLiveStreamsPublishList

    Document Center

    ApsaraVideo Live:DescribeLiveStreamsPublishList

    Last Updated:Jun 22, 2026

    Mengambil catatan pengambilan aliran historis dari nama domain, aplikasi di bawah nama domain, atau aliran tertentu dalam rentang waktu yang ditentukan.

    Deskripsi operasi

    Anda dapat memanggil operasi ini untuk mengkueri aliran historis dalam 30 hari terakhir. Data yang dikembalikan berisi informasi aliran aktif dalam rentang waktu yang ditentukan. Operasi ini mendukung metode Pengurutan berikut:

    • stream_name_desc: mengurutkan berdasarkan nama aliran langsung secara Pengurutan menurun.

    • stream_name_asc: mengurutkan berdasarkan nama aliran langsung secara Pengurutan menaik.

    • publish_time_desc: mengurutkan waktu pengambilan aliran secara Pengurutan menurun.

    • publish_time_asc: mengurutkan waktu pengambilan aliran secara Pengurutan menaik.

    Batas QPS

    Batas QPS pengguna tunggal untuk operasi ini adalah 3 panggilan per detik. Jika batas ini terlampaui, panggilan API akan dibatasi, yang dapat memengaruhi bisnis Anda. Panggil operasi ini dengan tepat.

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

    get

    *All Resource

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    RegionId

    string

    No

    ID wilayah.

    cn-shanghai
    DomainName

    string

    Yes

    Domain ingest atau domain streaming.

    Catatan

    • Saat Anda menentukan DomainName, pastikan nama domain tersebut adalah nama domain siaran langsung dan pengguna yang memanggil operasi ini memiliki izin untuk mengoperasikan nama domain yang ditentukan.

    example.com
    AppName

    string

    No

    Nama aplikasi tempat aliran berada. Anda dapat melihat AppName pada Tampilan Manajemen Aliran.

    liveApp****
    StreamName

    string

    No

    Nama aliran. Anda dapat melihat NamaStream pada Tampilan Manajemen Aliran.

    liveStream****
    StartTime

    string

    Yes

    Waktu mulai pengambilan aliran.

    format: yyyy-MM-ddTHH:mm:ssZ (UTC).

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

    string

    Yes

    Waktu berakhir. Interval antara EndTime dan StartTime tidak boleh melebihi 30 hari.

    format: yyyy-MM-ddTHH:mm:ssZ (UTC).

    2017-12-22T08:00:00Z
    PageSize

    integer

    No

    Ukuran halaman. Nilai valid: 1 hingga 3000. Nilai default: 2000.

    1500
    PageNumber

    integer

    No

    Nomor halaman. Nilai default: 1.

    1
    StreamType

    string

    No

    Tipe aliran. Nilai valid:

    • Tidak ditentukan: mengkueri aliran mentah.

    • all: mengkueri semua aliran.

    • trans: mengkueri aliran yang telah dikodekan ulang.

    Valid values:

    • all :

      mengkueri semua aliran.

    • raw :

      mengkueri aliran mentah.

    • trans :

      mengkueri aliran yang telah dikodekan ulang.

    all
    QueryType

    string

    No

    Apakah akan menggunakan pencocokan kabur untuk nama aliran. Nilai valid:

    • fuzzy (default): pencocokan kabur.

    • strict: pencocokan tepat.

    Valid values:

    • strict :

      pencocokan tepat.

    • fuzzy :

      pencocokan kabur.

    fuzzy
    OrderBy

    string

    No

    Metode Pengurutan. Nilai valid:

    • stream_name_desc: mengurutkan berdasarkan nama aliran langsung secara Pengurutan menurun.

    • stream_name_asc: mengurutkan berdasarkan nama aliran langsung secara Pengurutan menaik.

    • publish_time_desc: mengurutkan waktu pengambilan aliran secara Pengurutan menurun.

    • publish_time_asc (default): mengurutkan waktu pengambilan aliran secara Pengurutan menaik.

    Valid values:

    • publish_time_asc :

      mengurutkan berdasarkan waktu pengambilan aliran secara Pengurutan menaik.

    • publish_time_desc :

      mengurutkan berdasarkan waktu pengambilan aliran secara Pengurutan menurun.

    • stream_name_asc :

      mengurutkan berdasarkan nama aliran langsung secara Pengurutan menaik.

    • stream_name_desc :

      mengurutkan berdasarkan nama aliran langsung secara Pengurutan menurun.

    publish_time_desc

    Elemen respons

    Element

    Type

    Description

    Example

    object

    TotalPage

    integer

    Jumlah total halaman.

    2
    PageNum

    integer

    Nomor halaman.

    2
    PageSize

    integer

    Ukuran halaman.

    10
    RequestId

    string

    ID permintaan.

    40A4F36D-A7CC-473A-88E7-154F92242566
    TotalNum

    integer

    Jumlah total entri yang sesuai dengan kondisi yang ditentukan.

    11
    PublishInfo

    object

    LiveStreamPublishInfo

    array<object>

    Informasi catatan pengambilan aliran.

    object

    EdgeNodeAddr

    string

    The IP address of the CDN point of presence (POP) to which the stream was ingested.

    10.175.XX.XX
    PublishUrl

    string

    The complete ingest URL.

    rtmp://demo.aliyundoc.com/liveApp****/liveStream****
    StreamName

    string

    The stream name.

    liveStream****
    DomainName

    string

    The ingest or streaming domain.

    example.com
    StopTime

    string

    The time when the stream ingest was stopped. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

    2015-12-02T03:11:19Z
    TranscodeId

    string

    The ID of the transcoding template.

    Catatan

    This parameter is unavailable if the value of the Transcoded parameter is no.

    ld
    PublishDomain

    string

    The ingest domain.

    demo.aliyundoc.com
    AppName

    string

    The name of the application to which the live stream belongs.

    liveApp****
    PublishTime

    string

    The time when the stream ingest was started. The time follows the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time is displayed in UTC.

    2015-12-02T03:05:53Z
    PublishType

    string

    The type of the stream ingest. Valid values:

    • edge: edge ingest.

    • center: live center ingest.

    edge
    Transcoded

    string

    Indicates whether the stream was a transcoded stream.

    yes
    ClientAddr

    string

    The IP address of the client that pushed the live stream.

    10.175.XX.XX
    StreamUrl

    string

    The streaming URL.

    http://example.com/liveApp****/liveStream****.flv
    AliInnerErrorFlags

    string

    The error code that indicates the cause of a stream interruption. The error code is a one-digit or three-digit number.

    002

    Contoh

    Respons sukses

    JSONformat

    {
  "TotalPage": 2,
  "PageNum": 2,
  "PageSize": 10,
  "RequestId": " 40A4F36D-A7CC-473A-88E7-154F92242566",
  "TotalNum": 11,
  "PublishInfo": {
    "LiveStreamPublishInfo": [
      {
        "EdgeNodeAddr": "10.175.XX.XX",
        "PublishUrl": "rtmp://demo.aliyundoc.com/liveApp****/liveStream****",
        "StreamName": "liveStream****",
        "DomainName": "example.com",
        "StopTime": "2015-12-02T03:11:19Z",
        "TranscodeId": "ld",
        "PublishDomain": "demo.aliyundoc.com",
        "AppName": "liveApp****",
        "PublishTime": "2015-12-02T03:05:53Z",
        "PublishType": "edge",
        "Transcoded": "yes",
        "ClientAddr": "10.175.XX.XX",
        "StreamUrl": "http://example.com/liveApp****/liveStream****.flv",
        "AliInnerErrorFlags": "002"
      }
    ]
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 QpsOverLimit Qps is over limit for this domainName.
    400 InvalidStartTime.Malformed Specified parameter StartTime is not valid.
    400 InvalidEndTime.Malformed Specified parameter EndTime is not valid.
    400 InvalidStartTime.ValueNotSupported The specified value of parameter StartTime is not supported. The value specified for the StartTime parameter is invalid.
    400 InvalidEndTime.Mismatch Specified end time does not match the specified start time.
    400 Duration.Exceed Duration between StartTime and EndTime is too long.
    400 LiveServiceNotFound Your account does not open Live service yet Your account has not yet activated ApsaraVideo Live.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.