全部产品
Search
文档中心

Object Storage Service:ListLiveChannel

更新时间:Jun 26, 2025

Menampilkan LiveChannel yang ditentukan.

Sintaks permintaan

GET /?live HTTP/1.1
Date: Tanggal GMT
Host: NamaBucket.oss-cn-hangzhou.aliyuncs.com
Authorization: NilaiTandaTangan

Elemen permintaan

Elemen

Tipe

Diperlukan

Deskripsi

marker

String

Tidak

Nama LiveChannel setelah mana operasi daftar dimulai. LiveChannel yang namanya secara alfabetis setelah nilai parameter marker akan dikembalikan.

max-keys

String

Tidak

Jumlah maksimum LiveChannel yang dapat dikembalikan dalam operasi.

Nilai valid: 1 hingga 1.000

Nilai default: 100

prefix

String

Tidak

Awalan yang harus terkandung dalam nama LiveChannel yang ingin Anda kembalikan. Jika Anda menentukan awalan dalam permintaan, awalan tersebut akan disertakan dalam respons.

Untuk informasi lebih lanjut tentang header permintaan umum seperti Host dan Date dalam permintaan ListLiveChannel, lihat Header Permintaan Umum.

Elemen respons

Elemen

Tipe

Deskripsi

ListLiveChannelResult

Kontainer

Kontainer yang menyimpan hasil dari permintaan ListLiveChannel.

Node anak: Prefix, Marker, MaxKeys, IsTruncated, NextMarker, dan LiveChannel

Node induk: tidak ada

Prefix

String

Awalan yang terkandung dalam nama LiveChannel yang dikembalikan.

Node anak: tidak ada

Node induk: ListLiveChannelResult

Marker

String

Nama LiveChannel setelah mana operasi ListLiveChannel dimulai.

Node anak: tidak ada

Node induk: ListLiveChannelResult

MaxKeys

String

Jumlah maksimum LiveChannel yang dikembalikan dalam respons.

Node anak: tidak ada

Node induk: ListLiveChannelResult

IsTruncated

String

Menunjukkan apakah semua hasil telah dikembalikan.

  • true: Semua hasil telah dikembalikan.

  • false: Tidak semua hasil telah dikembalikan.

Node anak: tidak ada

Node induk: ListLiveChannelResult

NextMarker

String

Jika tidak semua hasil dikembalikan, parameter NextMarker disertakan dalam respons untuk menunjukkan nilai Marker dari permintaan berikutnya.

Node anak: tidak ada

Node induk: ListLiveChannelResult

LiveChannel

Kontainer

Kontainer yang menyimpan informasi tentang setiap LiveChannel yang dikembalikan.

Node anak: Name, Description, Status, LastModified, PublishUrls, dan PlayUrls

Node induk: ListLiveChannelResult

Name

String

Nama LiveChannel.

Node anak: tidak ada

Node induk: LiveChannel

Description

String

Deskripsi LiveChannel.

Node anak: tidak ada

Node induk: LiveChannel

Status

String terenumerasi

Status LiveChannel.

Node anak: tidak ada

Node induk: LiveChannel

Nilai valid:

  • disabled: LiveChannel dinonaktifkan.

  • enabled: LiveChannel diaktifkan.

LastModified

String

Waktu terakhir konfigurasi LiveChannel dimodifikasi.

Standar: ISO 8601.

Node anak: tidak ada

Node induk: LiveChannel

PublishUrls

Kontainer

Kontainer yang menyimpan URL yang digunakan untuk mengirim aliran ke LiveChannel.

Node anak: Url

Node induk: LiveChannel

Url

String

URL yang digunakan untuk mengirim aliran ke LiveChannel.

Node anak: tidak ada

Node induk: PublishUrls

PlayUrls

Kontainer

Kontainer yang menyimpan URL yang digunakan untuk memainkan aliran yang dikirim ke LiveChannel.

Node anak: Url

Node induk: LiveChannel

Url

String

URL yang digunakan untuk memainkan aliran yang dikirim ke LiveChannel.

Node anak: tidak ada

Node induk: PlayUrls

Untuk informasi lebih lanjut tentang header respons umum seperti ETag dan x-oss-request-id dalam respons terhadap permintaan ListLiveChannel, lihat Header Respons Umum.

Contoh

Contoh Permintaan

GET /?live&max-keys=1 HTTP/1.1
Date: Thu, 25 Aug 2016 07:50:09 GMT
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Contoh Respons

HTTP/1.1 200
content-length: 656
server: AliyunOSS
connection: close
x-oss-request-id: 57BEA331B92475920B00****
date: Thu, 25 Aug 2016 07:50:09 GMT
content-type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<ListLiveChannelResult>
  <Prefix></Prefix>
  <Marker></Marker>
  <MaxKeys>1</MaxKeys>
  <IsTruncated>true</IsTruncated>
  <NextMarker>channel-0</NextMarker>
  <LiveChannel>
    <Name>channel-0</Name>
    <Description></Description>
    <Status>disabled</Status>
    <LastModified>2016-07-30T01:54:21.000Z</LastModified>
    <PublishUrls>
      <Url>rtmp://test-bucket.oss-cn-hangzhou.aliyuncs.com/live/channel-0</Url>
    </PublishUrls>
    <PlayUrls>
      <Url>http://test-bucket.oss-cn-hangzhou.aliyuncs.com/channel-0/playlist.m3u8</Url>
    </PlayUrls>
  </LiveChannel>
</ListLiveChannelResult>