Lista os LiveChannels em um bucket. Filtre os resultados por prefixo e pagine com marker e max-keys.
Sintaxe da requisição
GET /?live HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
Elementos da requisição
|
Elemento |
Tipo |
Obrigatório |
Descrição |
|
marker |
String |
Não |
Nome do LiveChannel a partir do qual a listagem começa. A resposta retorna os LiveChannels subsequentes a esse valor em ordem alfabética. |
|
max-keys |
String |
Não |
Número máximo de LiveChannels retornados. Valores válidos: 1 a 1000 Valor padrão: 100 |
|
prefix |
String |
Não |
Prefixo obrigatório nos nomes dos LiveChannels retornados. Se especificado, a resposta inclui o prefixo. |
Para consultar os cabeçalhos de requisição comuns em chamadas do ListLiveChannel, como Host e Date, consulte Cabeçalhos comuns de requisição.
Elementos da resposta
|
Elemento |
Tipo |
Descrição |
|
ListLiveChannelResult |
Contêiner |
Contêiner da resposta do ListLiveChannel. Nós filhos: Prefix, Marker, MaxKeys, IsTruncated, NextMarker e LiveChannel Nós pais: nenhum |
|
Prefix |
String |
Prefixo contido nos nomes dos LiveChannels retornados. Nós filhos: nenhum Nós pais: ListLiveChannelResult |
|
Marker |
String |
Nome do LiveChannel a partir do qual a listagem começou. Nós filhos: nenhum Nós pais: ListLiveChannelResult |
|
MaxKeys |
String |
Número máximo de LiveChannels na resposta. Nós filhos: nenhum Nós pais: ListLiveChannelResult |
|
IsTruncated |
String |
Indica se a resposta retornou todos os resultados.
Nós filhos: nenhum Nós pais: ListLiveChannelResult |
|
NextMarker |
String |
Se a resposta não retornar todos os resultados, este valor indica o marker para a próxima requisição. Nós filhos: nenhum Nós pais: ListLiveChannelResult |
|
LiveChannel |
Contêiner |
Contêiner de cada LiveChannel retornado. Nós filhos: Name, Description, Status, LastModified, PublishUrls e PlayUrls Nós pais: ListLiveChannelResult |
|
Name |
String |
Nome do LiveChannel. Nós filhos: nenhum Nós pais: LiveChannel |
|
Description |
String |
Descrição do LiveChannel. Nós filhos: nenhum Nós pais: LiveChannel |
|
Status |
String enumerada |
Status do LiveChannel. Nós filhos: nenhum Nós pais: LiveChannel Valores válidos:
|
|
LastModified |
String |
Data e hora da última modificação na configuração do LiveChannel. Formato: ISO 8601. Nós filhos: nenhum Nós pais: LiveChannel |
|
PublishUrls |
Contêiner |
Contêiner da URL de ingestão de stream do LiveChannel. Nós filhos: Url Nós pais: LiveChannel |
|
Url |
String |
URL de ingestão de stream do LiveChannel. Nós filhos: nenhum Nós pais: PublishUrls |
|
PlayUrls |
Contêiner |
Contêiner da URL de reprodução de stream do LiveChannel. Nós filhos: Url Nós pais: LiveChannel |
|
Url |
String |
URL de reprodução de stream do LiveChannel. Nós filhos: nenhum Nós pais: PlayUrls |
Para consultar os cabeçalhos de resposta comuns, como ETag e x-oss-request-id, nas respostas do ListLiveChannel, consulte Cabeçalhos comuns de resposta.
Exemplos
Exemplo de requisição
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
Exemplo de resposta
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>