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

Consulta os dados de uso de monitoramento de um nome de domínio chamando DescribeLiveDomainMonitoringUsageData.

Descrição da operação

Você pode consultar vários nomes de domínio por vez. Separe vários nomes de domínio com vírgulas (,).
Você pode consultar dados de até os últimos 90 dias.
A granularidade de tempo para consulta de dados é hora ou dia.
O intervalo de tempo máximo de consulta é de 31 dias.

Limite de QPS

O limite de QPS para um único usuário nesta operação é de 20 chamadas por segundo. Se o limite for excedido, as chamadas de API serão limitadas, o que pode afetar seus negócios. Utilize esta operação de forma adequada.

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

get

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

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	Não	O domínio de streaming a ser consultado. Você pode especificar um único nome de domínio ou vários nomes de domínio. Separe vários nomes de domínio com vírgulas (,). Se este parâmetro não for especificado, os dados mesclados de todos os nomes de domínio de streaming ao vivo serão retornados por padrão.	example.com
StartTime	string	Não	A hora de início. Especifique a hora no padrão ISO 8601 no formato YYYY-MM-DDThh:mm:ssZ. A hora deve estar em UTC. A granularidade mínima dos dados é de 1 hora. Se este parâmetro não for especificado, os dados das últimas 24 horas serão retornados por padrão.	2022-12-10T20:00:00Z
EndTime	string	Não	A hora de término. A hora de término deve ser posterior à hora de início. Especifique a hora no padrão ISO 8601 no formato YYYY-MM-DDThh:mm:ssZ. A hora deve estar em UTC.	2022-12-10T22:00:00Z
Region	string	Não	A região do centro de transmissão ao vivo. Se este parâmetro não for especificado, os dados mesclados de todas as regiões serão retornados por padrão. Você pode especificar várias regiões. Separe várias regiões com vírgulas (,).	cn-shanghai
InstanceId	string	Não	O ID da sessão de monitoramento. Se este parâmetro não for especificado, os dados mesclados de todas as sessões de monitoramento serão retornados por padrão. Você pode especificar vários IDs. Separe vários IDs com vírgulas (,).	e62af24d-a354-3b0c-9f1f-da592c4b****
Interval	string	Não	A granularidade de tempo para a consulta. Valores válidos: 3600 (hora) e 86400 (dia).	3600
SplitBy	string	Não	A chave de agrupamento. Valor padrão: resolution, que indica o agrupamento por resolução. Valores válidos: domain, region, instance e resolution. Você pode especificar vários valores. Separe vários valores com vírgulas (,).	resolution

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object	Os parâmetros de resposta.
DomainName	string	O nome de domínio.	example.com
EndTime	string	A hora de término da consulta. A hora está no padrão ISO 8601 no formato YYYY-MM-DDThh:mm:ssZ. A hora está em UTC.	2022-12-10T22:00:00Z
InstanceId	string	O ID da sessão de monitoramento.	e62af24d-a354-3b0c-9f1f-da592c4b****
MonitoringData	object
MonitoringDataItem	array<object>	Os detalhes de uso de monitoramento.
	object	Os detalhes.
DomainName	string	The domain name. This parameter is valid only when Split includes domain.	example.com
Duration	integer	The duration, in minutes.	2000
InstanceId	string	The monitoring session ID. This parameter is valid only when Split includes instance.	e62af24d-a354-3b0c-9f1f-da592c4b****
Region	string	The live center region. This parameter is valid only when Split includes Region.	cn-shanghai
Resolution	string	The resolution. This parameter is valid only when Split includes resolution.	720P
TimeStamp	string	The start time of the time interval. The time is in the ISO 8601 standard in the YYYY-MM-DDThh:mm:ssZ format. The time is in UTC.	2022-12-10T20:00:00Z
Region	string	A região do centro de transmissão ao vivo.	cn-shanghai
RequestId	string	O ID da solicitação.	3C6CCEC4-6B88-4D4A-93E4-D47B3******
StartTime	string	A hora de início da consulta. A hora está no padrão ISO 8601 no formato YYYY-MM-DDThh:mm:ssZ. A hora está em UTC.	2022-12-10T20:00:00Z

Exemplos

Resposta de sucesso

JSON formato

{
  "DomainName": "example.com",
  "EndTime": "2022-12-10T22:00:00Z",
  "InstanceId": "e62af24d-a354-3b0c-9f1f-da592c4b****",
  "MonitoringData": {
    "MonitoringDataItem": [
      {
        "DomainName": "example.com",
        "Duration": 2000,
        "InstanceId": "e62af24d-a354-3b0c-9f1f-da592c4b****",
        "Region": "cn-shanghai",
        "Resolution": "720P",
        "TimeStamp": "2022-12-10T20:00:00Z"
      }
    ]
  },
  "Region": "cn-shanghai",
  "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3******",
  "StartTime": "2022-12-10T20:00:00Z"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidStartTime.Malformed	Specified StartTime is malformed.
400	InvalidEndTime.Malformed	Specified EndTime is malformed.
400	InvalidEndTime.Mismatch	Specified end time does not math the specified start time.	The end time does not match the start time. Make sure that the start and end times match.
400	InvalidTimeSpan	The time span exceeds the limit.	The time span exceeds the limit. Please refer to the API documentation to specify a reasonable time span.
400	InvalidStartTime.ValueNotSupported	The specified value of parameter StartTime is not supported.	The value specified for the StartTime parameter is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.