Todos los productos
Search
Centro de documentos

Object Storage Service:GetLiveChannelStat

Última actualización: Sep 07, 2026

Consulta el estado de ingesta de flujo de un LiveChannel específico.

Sintaxis de la solicitud

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

Encabezados de la solicitud

DescribeRegions utiliza únicamente los encabezados de solicitud comunes. Para obtener más información, consulte Common request headers.

Elementos de la respuesta

Elemento

Tipo

Descripción

LiveChannelStat

Contenedor

Contenedor que almacena los resultados que devuelve la solicitud GetLiveChannelStat.

Nodos secundarios: Status, ConnectedTime, Video y Audio

Nodos primarios: ninguno

Status

Cadena enumerada

Estado actual de ingesta de flujo del LiveChannel.

Nodos secundarios: ninguno

Nodos primarios: LiveChannelStat

Valores válidos: Disabled, Live y Idle

ConnnectedTime

Cadena

Si Status se establece en Live, este elemento indica la hora a la que el cliente actual comienza a ingerir flujos. El valor del elemento tiene formato ISO 8601.

Nodos secundarios: ninguno

Nodos primarios: LiveChannelStat

RemoteAddr

Cadena

Si Status se establece en Live, este elemento indica la dirección IP del cliente actual que ingiere flujos.

Nodos secundarios: ninguno

Nodos primarios: LiveChannelStat

Video

Contenedor

Contenedor que almacena la información del flujo de video cuando Status se establece en Live.

Nota

Los contenedores de video y audio solo se devuelven si Status se establece en Live. Sin embargo, no siempre se devuelven ambos contenedores bajo esta condición. Por ejemplo, si el cliente se conectó al LiveChannel pero no se envía ningún flujo de audio ni de video, estos dos contenedores no se devuelven.

Nodos secundarios: Width, Height, FrameRate, Bandwidth y Codec

Nodos primarios: LiveChannelStat

Width

Cadena

Ancho del flujo de video actual.

Unidad: píxeles.

Nodos secundarios: ninguno

Nodos primarios: Video

Height

Cadena

Alto del flujo de video actual.

Unidad: píxeles.

Nodos secundarios: ninguno

Nodos primarios: Video

FrameRate

Cadena

Velocidad de fotogramas del flujo de video actual.

Nodos secundarios: ninguno

Nodos primarios: Video

Bandwidth

Cadena

Tasa de bits del flujo de video actual.

Unidad: bit/s.

Nodos secundarios: ninguno

Nodos primarios: Video

Codec

Cadena enumerada

Formato de codificación del flujo de video actual.

Nodos secundarios: ninguno

Nodos primarios: Video

Audio

Contenedor

Contenedor que almacena la información del flujo de audio cuando Status se establece en Live.

Nota

Los contenedores de video y audio solo se devuelven si Status se establece en Live. Sin embargo, no siempre se devuelven ambos contenedores bajo esta condición. Por ejemplo, si el cliente se conectó al LiveChannel pero no se envía ningún flujo de audio ni de video, estos dos contenedores no se devuelven.

Nodos secundarios: SampleRate, Bandwidth y Codec

Nodos primarios: LiveChannelStat

SampleRate

Cadena

Frecuencia de muestreo del flujo de audio actual.

Nodos secundarios: ninguno

Nodos primarios: Audio

Bandwidth

Cadena

Tasa de bits del flujo de audio actual.

Nota

Bandwidth indica la tasa de bits promedio del flujo de audio o de video durante el periodo reciente. Cuando el LiveChannel cambia al estado Live, el valor devuelto de Bandwidth puede ser 0.

Unidad: bit/s.

Nodos secundarios: ninguno

Nodos primarios: Audio

Codec

Cadena enumerada

Formato de codificación del flujo de audio actual.

Nodos secundarios: ninguno

Nodos primarios: Audio

Ejemplos

  • Ejemplo de solicitud 1

    GET /test-channel?live&comp=stat HTTP/1.1
    Date: Thu, 25 Aug 2016 06:22:01 GMT
    Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Ejemplo de respuesta 1

    HTTP/1.1 200
    content-length: 100
    server: AliyunOSS
    connection: close
    x-oss-request-id: 57BE8E89B92475920B002164
    date: Thu, 25 Aug 2016 06:22:01 GMT
    content-type: application/xml
    <?xml version="1.0" encoding="UTF-8"?>
    <LiveChannelStat>
      <Status>Idle</Status>
    </LiveChannelStat>
  • Ejemplo de solicitud 2

    GET /test-channel?live&comp=stat HTTP/1.1
    Date: Thu, 25 Aug 2016 06:25:26 GMT
    Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    Ejemplo de respuesta 2

    HTTP/1.1 200
    content-length: 469
    server: AliyunOSS
    connection: close
    x-oss-request-id: 57BE8F56B92475920B002187
    date: Thu, 25 Aug 2016 06:25:26 GMT
    content-type: application/xml
    <?xml version="1.0" encoding="UTF-8"?>
    <LiveChannelStat>
      <Status>Live</Status>
      <ConnectedTime>2016-08-25T06:25:15.000Z</ConnectedTime>
      <RemoteAddr>10.1.2.3:47745</RemoteAddr>
      <Video>
        <Width>1280</Width>
        <Height>536</Height>
        <FrameRate>24</FrameRate>
        <Bandwidth>0</Bandwidth>
        <Codec>H264</Codec>
      </Video>
      <Audio>
        <Bandwidth>0</Bandwidth>
        <SampleRate>44100</SampleRate>
        <Codec>ADPCM</Codec>
      </Audio>
    </LiveChannelStat>