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