Todos os produtos
Search
Central de documentação

:ListLiveRecordVideo

Última atualização: Jun 27, 2026

Consulta vídeos de transmissão ao vivo gravados para VOD.

Nota

É possível consultar no máximo 5.000 vídeos com base na condição de filtro especificada.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

ParameterTypeRequiredExampleDescription
ActionStringYesListLiveRecordVideo

A operação a ser executada. Defina o valor como ListLiveRecordVideo.

StreamNameStringNolive-test

Nome do stream ao vivo gravado.

DomainNameStringNoexample.com

Nome de domínio do stream ao vivo gravado.

AppNameStringNotestApp

Nome do aplicativo usado para gravar o stream ao vivo.

PageNoIntegerNo1

Número da página a ser retornada. Valor padrão: 1.

PageSizeIntegerNo10

Quantidade de entradas a serem retornadas em cada página. Valor máximo: 100. Valor padrão: 10.

SortByStringNoCreationTime:Desc

Regra de ordenação dos resultados. Valores válidos:

  • CreationTime:Desc: ordena os resultados pela hora de criação em ordem decrescente. Este é o valor padrão.
  • CreationTime:Asc: ordena os resultados pela hora de criação em ordem crescente.
StartTimeStringNo2017-01-11T12:00:00Z

Início do intervalo de tempo a ser consultado. A consulta utiliza o período em que os streams ao vivo desejados foram gravados. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

EndTimeStringNo2017-01-11T13:00:00Z

Fim do intervalo de tempo a ser consultado. A consulta utiliza o período em que os streams ao vivo desejados foram gravados. A hora final deve ser posterior à hora inicial. Especifique a hora no padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora deve estar em UTC.

Parâmetros de resposta

ParameterTypeExampleDescription
LiveRecordVideoListArray of LiveRecordVideo

Lista de vídeos.

LiveRecordVideo
AppNameStringtestApp

Nome do aplicativo.

DomainNameStringexample.com

Nome de domínio.

PlaylistIdString****

ID da playlist.

RecordEndTimeString2017-12-08T08:44:56Z

Fim do intervalo de tempo em que os dados foram consultados. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.

RecordStartTimeString2017-12-08T07:40:56Z

Início do intervalo de tempo em que os dados foram consultados. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.

StreamNameStringlive-test

Nome do stream ao vivo.

VideoStruct

Informações sobre o vídeo.

CateIdInteger78

ID da categoria do vídeo.

CateNameStringCategory name

Nome da categoria do vídeo.

CoverURLStringhttps://image.example.com/coversample.jpg

URL da miniatura do vídeo.

CreationTimeString2017-12-08T07:40:56Z

Hora de criação do vídeo. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.

DescriptionStringDescription of the ApsaraVideo VOD video

Descrição do vídeo.

DurationFloat135.6

Duração do vídeo. Unidade: segundos.

ModifyTimeString2017-12-08T09:40:56Z

Última hora de atualização do vídeo. A hora segue o padrão ISO 8601 no formato yyyy-MM-ddTHH:mm:ssZ. A hora é exibida em UTC.

SizeLong10897890

Tamanho do arquivo mezzanine. Unidade: bytes.

SnapshotsList{"Snapshot":["http://image.example.com/snapshot/sample000001.jpg? auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e273334f52","http://image.example.com/snapshot/sample00002.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e272434f52"]}

Array de URLs de snapshots do vídeo.

StatusStringNormal

Status do vídeo. Valores válidos:

  • Uploading:: indica que o upload do vídeo está em andamento.
  • UploadFail: indica falha no upload do vídeo.
  • UploadSucces: indica que o upload do vídeo foi concluído.
  • Transcoding: indica que a transcodificação do vídeo está em andamento.
  • TranscodeFail: indica falha na transcodificação do vídeo.
  • Blocked: indica que o vídeo está bloqueado.
  • Normal: indica que o vídeo está em estado normal.
TagsStringTag 1, Tag 2

Tags do vídeo. Separe múltiplas tags com vírgulas (,).

TemplateGroupIdString1

ID do grupo de modelos de transcodificação.

TitleStringTitle of the ApsaraVideo VOD video

Título do vídeo.

VideoIdString93ab850b4f6f*****54b6e91d24d81d4

ID do vídeo.

RequestIdString25818875-5F78-4A13-****-D7393642CA58

ID da solicitação.

TotalInteger123

Número total de vídeos retornados.

Exemplos

Exemplos de solicitações

https://vod.{ApiRegion}.aliyuncs.com/?Action=ListLiveRecordVideo
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<ListLiveRecordVideoResponse>
  <RequestId>25818875-5F78-4A13-****-D7393642CA58</RequestId>
  <Total>123</Total>
  <LiveRecordVideoList>
        <LiveRecordVideo>
              <PlaylistId>****</PlaylistId>
              <StreamName>live-test</StreamName>
              <RecordStartTime>2017-12-08T07:40:56Z</RecordStartTime>
              <RecordEndTime>2017-12-08T08:40:56Z</RecordEndTime>
              <DomainName>example.com</DomainName>
              <AppName>testApp</AppName>
        </LiveRecordVideo>
        <LiveRecordVideo>
              <Video>
                    <Status>Normal</Status>
                    <ModifyTime>2017-12-08T09:40:56Z</ModifyTime>
                    <Description>Description of the ApsaraVideo VOD video</Description>
                    <VideoId>93ab850b4f6f*****54b6e91d24d81d4</VideoId>
                    <Size>10897890</Size>
                    <Title>Title of the ApsaraVideo VOD video</Title>
                    <Duration>135.6</Duration>
                    <CateName>Category name</CateName>
                    <CateId>78</CateId>
                    <CreationTime>2017-12-08T07:40:56Z</CreationTime>
                    <CoverURL>https://image.example.com/coversample.jpg</CoverURL>
                    <Snapshots>
                          <Snapshot>{"Snapshot":["http://image.example.com/snapshot/sample000001.jpg? auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e273334f52","http://image.example.com/snapshot/sample00002.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e272434f52"]}</Snapshot>
                    </Snapshots>
                    <Tags>Tag 1, Tag 2</Tags>
                    <TemplateGroupId>1</TemplateGroupId>
              </Video>
        </LiveRecordVideo>
  </LiveRecordVideoList>
</ListLiveRecordVideoResponse>

Formato JSON

{
    "RequestId": "25818875-5F78-4A13-****-D7393642CA58",
    "Total": "123",
    "LiveRecordVideoList": {
        "LiveRecordVideo": [{
            "PlaylistId": "****",
            "StreamName": "live-test",
            "RecordStartTime": "2017-12-08T07:40:56Z",
            "RecordEndTime": "2017-12-08T08:40:56Z",
            "DomainName": "example.com",
            "AppName": "testApp"
        }, {
            "Video": {
                "Status": "Normal",
                "ModifyTime": "2017-12-08T09:40:56Z",
                "Description": "Description of the ApsaraVideo VOD video",
                "VideoId": "93ab850b4f6f*****54b6e91d24d81d4",
                "Size": "10897890",
                "Title": "Title of the ApsaraVideo VOD video",
                "Duration": "135.6",
                "CateName": "Category name",
                "CateId": "78",
                "CreationTime": "2017-12-08T07:40:56Z",
                "CoverURL": "https://image.example.com/coversample.jpg",
                "Snapshots": {
                    "Snapshot": "{\"Snapshot\":[\"http://image.example.com/snapshot/sample000001.jpg? auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e273334f52\",\"http://image.example.com/snapshot/sample00002.jpg?auth_key=1498476426-0-0-f00b9455c49a423ce69cf4e272434f52\"]}"
                },
                "Tags": "Tag 1, Tag 2",
                "TemplateGroupId": "1"
            }
        }]
    }
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.

A tabela a seguir descreve os erros específicos desta operação. Para obter mais informações sobre erros comuns a todas as operações, consulte Erros comuns.

Error code

Error message

HTTP status code

Description

IpsIsEmpty

The specified “Ips” can not be empty.

400

Mensagem de erro retornada porque o parâmetro Ips não foi especificado.

IpsExceededMax

The specified Ips count has exceeded 100.

403

Mensagem de erro retornada porque mais de 100 endereços IP foram adicionados a um grupo.

SecurityIpGroupExceededMax

The audit security group count has exceeded 10.

403

Mensagem de erro retornada porque o número de grupos de segurança de revisão excede o limite superior.