Todos os produtos
Search
Central de documentação

Object Storage Service:ListLiveChannel

Última atualização: Sep 24, 2026

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.

  • true: A resposta retornou todos os resultados.

  • false: A resposta não 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:

  • disabled: O LiveChannel está desativado.

  • enabled: O LiveChannel está ativado.

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>