Tous les produits
Search
Centre de documentation

Object Storage Service:ListLiveChannel

Dernière mise à jour :Aug 18, 2026

Répertorie les LiveChannels d’un bucket. Filtrez les résultats par préfixe et utilisez la pagination avec les paramètres marker et max-keys.

Syntaxe de la requête

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

Éléments de la requête

Element

Type

Required

Description

marker

String

No

Nom du LiveChannel à partir duquel commence la liste. Les LiveChannels classés alphabétiquement après cette valeur sont renvoyés.

max-keys

String

No

Nombre maximal de LiveChannels à renvoyer.

Valeurs valides : 1 à 1000

Valeur par défaut : 100

prefix

String

No

Préfixe que doivent contenir les noms des LiveChannels renvoyés. Si ce paramètre est spécifié, la réponse inclut le préfixe.

Pour les en-têtes de requête courants dans les requêtes ListLiveChannel, tels que Host et Date, consultez la section En-têtes de requête courants.

Éléments de la réponse

Element

Type

Description

ListLiveChannelResult

Container

Conteneur pour la réponse ListLiveChannel.

Nœuds enfants : Prefix, Marker, MaxKeys, IsTruncated, NextMarker et LiveChannel

Nœuds parents : aucun

Prefix

String

Préfixe contenu dans les noms des LiveChannels renvoyés.

Nœuds enfants : aucun

Nœud parent : ListLiveChannelResult

Marker

String

Nom du LiveChannel à partir duquel la liste a commencé.

Nœuds enfants : aucun

Nœud parent : ListLiveChannelResult

MaxKeys

String

Nombre maximal de LiveChannels dans la réponse.

Nœuds enfants : aucun

Nœud parent : ListLiveChannelResult

IsTruncated

String

Indique si tous les résultats ont été renvoyés.

  • true : Tous les résultats sont renvoyés.

  • false : Tous les résultats ne sont pas renvoyés.

Nœuds enfants : aucun

Nœud parent : ListLiveChannelResult

NextMarker

String

Si tous les résultats ne sont pas renvoyés, cette valeur indique le marqueur pour la requête suivante.

Nœuds enfants : aucun

Nœud parent : ListLiveChannelResult

LiveChannel

Container

Conteneur pour chaque LiveChannel renvoyé.

Nœuds enfants : Name, Description, Status, LastModified, PublishUrls et PlayUrls

Nœud parent : ListLiveChannelResult

Name

String

Nom du LiveChannel.

Nœuds enfants : aucun

Nœud parent : LiveChannel

Description

String

Description du LiveChannel.

Nœuds enfants : aucun

Nœud parent : LiveChannel

Status

Enumerated string

État du LiveChannel.

Nœuds enfants : aucun

Nœud parent : LiveChannel

Valeurs valides :

  • disabled : Le LiveChannel est désactivé.

  • enabled : Le LiveChannel est activé.

LastModified

String

Dernière modification de la configuration du LiveChannel.

Format : ISO 8601.

Nœuds enfants : aucun

Nœud parent : LiveChannel

PublishUrls

Container

Conteneur pour l’URL d’ingestion de flux du LiveChannel.

Nœud enfant : Url

Nœud parent : LiveChannel

Url

String

URL d’ingestion de flux du LiveChannel.

Nœuds enfants : aucun

Nœud parent : PublishUrls

PlayUrls

Container

Conteneur pour l’URL de lecture de flux du LiveChannel.

Nœud enfant : Url

Nœud parent : LiveChannel

Url

String

URL de lecture de flux du LiveChannel.

Nœuds enfants : aucun

Nœud parent : PlayUrls

Pour les en-têtes de réponse courants tels que ETag et x-oss-request-id dans les réponses ListLiveChannel, consultez la section En-têtes de réponse courants.

Exemples

Exemple de requête

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

Exemple de réponse

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>