DescribeLiveRecordVodConfigs - ApsaraVideo Live: Central de Documentação do Alibaba Cloud

Consulta as configurações de live-to-VOD de um domínio de streaming.

Descrição da operação

Limite de QPS

Esta API é limitada a 1.000 consultas por minuto para cada conta. Se você exceder esse limite, as chamadas de API serão limitadas, o que pode afetar seus negócios.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

live:DescribeLiveRecordVodConfigs

get

*All Resource

*

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
RegionId	string	Não	O ID da região.	cn-shanghai
DomainName	string	Sim	O domínio de streaming.	example.com
AppName	string	Não	O AppName do stream ao vivo.	liveApp****
StreamName	string	Não	O nome do stream.	liveStream****
PageNum	integer	Não	O número da página. Valor padrão: 1.	1
PageSize	integer	Não	O número de entradas por página. Valor padrão: 10. Valores válidos: 5 a 100.	10

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
PageNum	integer	O número da página.	1
RequestId	string	O ID da solicitação.	5056369B-D337-499E-B8B7-B761BD37B08A
PageSize	integer	O tamanho da página.	1
Total	string	O número total de entradas.	100
LiveRecordVodConfigs	object
LiveRecordVodConfig	array<object>	Uma lista de configurações de live-to-VOD.
	array<object>	Uma configuração de live-to-VOD.
StorageLocation	string	The storage address.	****-tjptr2vatm.oss-cn-shanghai.aliyuncs.com
AppName	string	The AppName of the live stream.	liveApp****
AutoCompose	string	Indicates whether automatic composition is enabled. Valid values: ON: enabled. OFF: disabled.	ON
OnDemand	integer	The trigger mode of live stream recording. Valid values: 0 (default): Automatic recording. 1: Triggered by callback notifications of on-demand recording. 2: Triggered by corresponding parameters in the stream ingest URL. 7: Triggered manually. By default, recording is disabled. You can call the `RealTimeRecordCommand` operation to manually start or stop recording.	0
StreamName	string	The stream name.	liveStream****
CreateTime	string	The creation time, in UTC. The time is formatted as yyyy-MM-ddTHH:mm:ssZ.	2015-12-01T17:37:00Z
VodTranscodeGroupId	string	The ID of the ApsaraVideo VOD transcoding template group for transcoding the recording files.	e2d796d3bb5fd8049d32bff62f94****
CycleDuration	integer	The maximum duration of each recording file. Unit: seconds. Default value: 3600. Range: 300 to 21600.	360
DomainName	string	The streaming domain.	example.com
ComposeVodTranscodeGroupId	string	The ID of the ApsaraVideo VOD transcoding template group for transcoding the composed video created by automatic composition. Nota This parameter is returned only when `AutoCompose` is set to `ON`.	dadfcaadde****
RecordContent	string	The content to record. Valid values: `raw` (default): Records the source stream. `transcode`: Records the transcoded streams.	raw
DelayTime	integer	The reconnect timeout, in seconds. If a stream is interrupted but recovers within this window, the new content is automatically appended to the exisiting recording file. Otherwise, the previous session is considered ended, and a new recording file will be created. Valid values: 15 to 21600.	180
TranscodeTemplates	string	The transcoding templates configured in ApsaraVideo Live. It specifies which transcoded streams to record. A value of `*` indicates that all transcoded streams are recorded.	["sd","hd"]
FormatConfig	boolean	Specifies whether to enable format-specific configuration for VOD processing settings. The default value is true.	true
SpaceId	string	The ID of the ApsaraVideo VOD application space. You can find the ID in the ApsaraVideo VOD console or by calling the ListAppInfo operation. This parameter is required only if you have enabled application spaces.	app-1000000
RecordFormatList	object
RecordFormat	array<object>	A list of recording format configurations.
	object	A recording format configuration.
Format	string	The recording format.	m3u8
SliceDuration	integer	The duration of a TS segment, in seconds.	30
AutoCompose	string	Indicates whether automatic composition is enabled. ON: enabled. OFF: disabled.	ON
VideoProcess	string	The video to process. Valid values: `origin` (default): Processes the source recording files. `compose`: Processes the composed video.	origin
ProcessMethod	string	The video processing method. Valid values: `transcode`: Processes the video by using a transcoding template group set in ApsaraVideo VOD. `workflow`: Processes the video by using a workflow set in ApsaraVideo VOD.	transcode
ProcessTemplateId	string	The ID of the transcoding template group or workflow to use for video processing.	e2d796d3bb5fd8049d32bff62f94****
Tags	string	The video category.	sports

Exemplos

Resposta de sucesso

JSON formato

{
  "PageNum": 1,
  "RequestId": "5056369B-D337-499E-B8B7-B761BD37B08A",
  "PageSize": 1,
  "Total": "100",
  "LiveRecordVodConfigs": {
    "LiveRecordVodConfig": [
      {
        "StorageLocation": "****-tjptr2vatm.oss-cn-shanghai.aliyuncs.com",
        "AppName": "liveApp****",
        "AutoCompose": "ON",
        "OnDemand": 0,
        "StreamName": "liveStream****",
        "CreateTime": "2015-12-01T17:37:00Z",
        "VodTranscodeGroupId": "e2d796d3bb5fd8049d32bff62f94****",
        "CycleDuration": 360,
        "DomainName": "example.com",
        "ComposeVodTranscodeGroupId": "dadfcaadde****",
        "RecordContent": "raw",
        "DelayTime": 180,
        "TranscodeTemplates": "[\"sd\",\"hd\"]",
        "FormatConfig": true,
        "SpaceId": "app-1000000",
        "RecordFormatList": {
          "RecordFormat": [
            {
              "Format": "m3u8",
              "SliceDuration": 30,
              "AutoCompose": "ON",
              "VideoProcess": "origin",
              "ProcessMethod": "transcode",
              "ProcessTemplateId": "e2d796d3bb5fd8049d32bff62f94****",
              "Tags": "sports"
            }
          ]
        }
      }
    ]
  }
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InternalError	The request processing has failed due to backend service exception.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.