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

Consulta o uso de gravação em nuvem.

Descrição da operação

Calcula a duração diária de gravação em nuvem para cada especificação.
Oferece suporte à consulta no nível da aplicação ApsaraVideo Real-time Communication.

Limite de QPS

O limite de consultas por segundo (QPS) para um único usuário é 10. Se o limite for excedido, as chamadas de API serão limitadas, o que pode afetar seus serviços. Chame a API com uma frequência razoável.

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:DescribeLiveRtcRecordUsageData

none

*Todos os recursos.

*

Nenhuma

Sintaxe da solicitação

GET  HTTP/1.1

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
StartTime	string	Sim	O horário de início dos dados a serem recuperados. Formato: yyyy-MM-ddTHH:mm:ssZ (UTC).	2017-12-21T08:00:00Z
EndTime	string	Sim	O horário de término. O intervalo de consulta deve ser maior ou igual a 5 minutos e menor ou igual a 31 dias. Formato: yyyy-MM-ddTHH:mm:ssZ (UTC).	2022-10-10T21:00:00Z
AppId	string	Sim	O ID da aplicação ApsaraVideo Real-time Communication. Você pode visualizar o ID da aplicação em Gerenciamento de aplicações ApsaraVideo Real-time Communication. Você também pode visualizar os IDs das suas aplicações navegando até ApsaraVideo Live > Live+ > ApsaraVideo Real-time Communication > Gerenciamento de aplicações.	intl7f92-a5a8*************7ce4eb44a6
RecordMode	string	Sim	O modo de gravação. Valores válidos: 0: modo de gravação de fluxo único. 1: modo de gravação de mistura de fluxos.	1
Interval	string	Não	A granularidade de tempo dos dados consultados. Unidade: segundos. Valores válidos: 3600 (padrão).	3600

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Esquema da resposta
RequestId	string	O ID da solicitação.	16A96B9A-F2*************B92E68F4CD8
RecordMode	string	O modo de gravação. Valores válidos: 0: modo de gravação de fluxo único. 1: modo de gravação de mistura de fluxos.	0
AppId	string	O ID da aplicação ApsaraVideo Real-time Communication a ser consultada.	7fd341b3-c6fa-43e1-96b8-7295a1dd****
TotalSummaryDuration	number	A duração total agregada. Unidade: segundos.	150
AudioSummaryDuration	number	A duração agregada de áudio puro. Unidade: segundos.	20
V480SummaryDuration	number	A duração agregada de vídeo em 480p ou inferior. Unidade: segundos.	30
V720SummaryDuration	number	A duração agregada de vídeo em 720p ou inferior. Unidade: segundos.	40
V1080SummaryDuration	number	A duração agregada de vídeo acima de 720p (incluindo 1080p). Unidade: segundos.	10
Data	array<object>	As informações de estatísticas de uso.
	object	As informações de estatísticas de uso.
Timestamp	string	O carimbo de data/hora das estatísticas. Formato: yyyy-MM-ddTHH:mm:ssZ (UTC).	2022-10-10T20:00:00Z
TotalDuration	number	A duração total. Unidade: segundos.	150
AudioDuration	number	A duração de áudio puro. Unidade: segundos.	20
V480Duration	number	A duração de vídeo em 480p ou inferior. Unidade: segundos.	30
V720Duration	number	A duração de vídeo em 720p ou inferior. Unidade: segundos.	40
V1080Duration	number	A duração de vídeo acima de 720p. Unidade: segundos.	10

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "16A96B9A-F2*************B92E68F4CD8",
  "RecordMode": "0",
  "AppId": "7fd341b3-c6fa-43e1-96b8-7295a1dd****",
  "TotalSummaryDuration": 150,
  "AudioSummaryDuration": 20,
  "V480SummaryDuration": 30,
  "V720SummaryDuration": 40,
  "V1080SummaryDuration": 10,
  "Data": [
    {
      "Timestamp": "2022-10-10T20:00:00Z",
      "TotalDuration": 150,
      "AudioDuration": 20,
      "V480Duration": 30,
      "V720Duration": 40,
      "V1080Duration": 10
    }
  ]
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidStartTime.ValueNotSupported	The specified value of parameter StartTime is not supported.	A hora de início e a hora de término não correspondem. A hora de início não pode ser posterior à hora de término, e o intervalo de tempo não pode exceder 90 dias.
400	InvalidEndTime.Mismatch	Specified end time does not math the specified start time.	A hora de término não corresponde à hora de início. Verifique se os horários estão corretos.
400	InvalidRecordModeParameter	RecordMode parameter error.	O parâmetro RecordMode é inválido.
400	InvalidAppIdParameter	AppId parameter error.	O parâmetro AppId é inválido.
400	InvalidTimeSpan	The time span exceeds the limit.	O intervalo de tempo excede o limite. Consulte a documentação da API e configure um intervalo de tempo de consulta válido.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.