Tüm Ürünler
Search
Belge Merkezi

Object Storage Service:ListLiveChannel

Son Güncelleme:Oct 01, 2026

Bir paket içindeki LiveChannel'ları listeler. Sonuçları ön ek ile filtreleyebilir, marker ve max-keys parametrelerini kullanarak sayfalandırabilirsiniz.

İstek sözdizimi

GET /?live HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

İstek öğeleri

Öğe

Tür

Gerekli

Açıklama

marker

String

Hayır

Listelemeye başlanacak LiveChannel adı. Bu değerden sonra alfabetik olarak gelen LiveChannel'lar döndürülür.

max-keys

String

Hayır

Döndürülecek maksimum LiveChannel sayısı.

Geçerli değerler: 1 ile 1000 arasında

Varsayılan değer: 100

prefix

String

Hayır

Döndürülen LiveChannel adlarının içermesi gereken ön ek. Belirtilirse yanıt bu ön eki içerir.

ListLiveChannel isteklerinde Host ve Date gibi ortak istek üstbilgileri için bkz. Ortak istek üstbilgileri.

Yanıt öğeleri

Öğe

Tür

Açıklama

ListLiveChannelResult

Container

ListLiveChannel yanıtı için kapsayıcı.

Alt düğümler: Prefix, Marker, MaxKeys, IsTruncated, NextMarker ve LiveChannel

Üst düğümler: yok

Prefix

String

Döndürülen LiveChannel adlarının içerdiği ön ek.

Alt düğümler: yok

Üst düğümler: ListLiveChannelResult

Marker

String

Listelemenin başladığı LiveChannel adı.

Alt düğümler: yok

Üst düğümler: ListLiveChannelResult

MaxKeys

String

Yanıtta yer alan maksimum LiveChannel sayısı.

Alt düğümler: yok

Üst düğümler: ListLiveChannelResult

IsTruncated

String

Tüm sonuçların döndürülüp döndürülmediğini belirtir.

  • true: Tüm sonuçlar döndürülür.

  • false: Tüm sonuçlar döndürülmez.

Alt düğümler: yok

Üst düğümler: ListLiveChannelResult

NextMarker

String

Tüm sonuçlar döndürülmezse bu değer, sonraki istek için işaretleyiciyi belirtir.

Alt düğümler: yok

Üst düğümler: ListLiveChannelResult

LiveChannel

Container

Döndürülen her bir LiveChannel için kapsayıcı.

Alt düğümler: Name, Description, Status, LastModified, PublishUrls ve PlayUrls

Üst düğümler: ListLiveChannelResult

Name

String

LiveChannel adı.

Alt düğümler: yok

Üst düğümler: LiveChannel

Description

String

LiveChannel açıklaması.

Alt düğümler: yok

Üst düğümler: LiveChannel

Status

Enumerated string

LiveChannel durumu.

Alt düğümler: yok

Üst düğümler: LiveChannel

Geçerli değerler:

  • disabled: LiveChannel devre dışı bırakılmıştır.

  • enabled: LiveChannel etkinleştirilmiştir.

LastModified

String

LiveChannel yapılandırmasının en son değiştirildiği tarih.

Biçim: ISO 8601.

Alt düğümler: yok

Üst düğümler: LiveChannel

PublishUrls

Container

LiveChannel akış yükleme URL'si için kapsayıcı.

Alt düğümler: Url

Üst düğümler: LiveChannel

Url

String

LiveChannel akış yükleme URL'si.

Alt düğümler: yok

Üst düğümler: PublishUrls

PlayUrls

Container

LiveChannel akış oynatma URL'si için kapsayıcı.

Alt düğümler: Url

Üst düğümler: LiveChannel

Url

String

LiveChannel akış oynatma URL'si.

Alt düğümler: yok

Üst düğümler: PlayUrls

ListLiveChannel yanıtlarında ETag ve x-oss-request-id gibi ortak yanıt üstbilgileri için bkz. Ortak yanıt üstbilgileri.

Örnekler

Örnek istek

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

Örnek yanıt

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>