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

Descrição da operação

A duração de armazenamento dos dados é de até 90 dias. Você pode consultar dados de vários nomes de domínio por vez. Separe vários nomes de domínio com vírgulas (,). São suportados no máximo 500 nomes de domínio. Os dados de vários nomes de domínio são retornados como resultados de agregação. A granularidade de tempo dos dados retornados varia com base no intervalo de tempo especificado por StartTime e EndTime:

Intervalo de tempo ≤ 3 dias: A granularidade de tempo é de 5 minutos.
3 dias < intervalo de tempo ≤ 31 dias: A granularidade de tempo é de 1 hora.
Intervalo de tempo > 31 dias: A granularidade de tempo é de 1 dia.

Nota

Se nem StartTime nem EndTime forem especificados, os dados das últimas 24 horas serão retornados por padrão.

Limite de QPS

O limite de QPS para usuário único desta 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. Invoque 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:DescribeLiveDomainBpsDataByLayer

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. Você pode especificar vários nomes de domínio separados por vírgulas (,). Se este parâmetro for deixado vazio, os dados agregados de todos os nomes de domínio serão retornados por padrão.	pull.aliyundoc.com
StartTime	string	Não	O início do intervalo de tempo a ser consultado, no formato yyyy-MM-ddTHH:mm:ssZ (UTC). Nota Se este parâmetro não for especificado, os dados das últimas 24 horas serão retornados por padrão. A granularidade mínima dos dados é de 5 minutos.	2022-03-15T16:00:00Z
EndTime	string	Não	O fim do intervalo de tempo a ser consultado, no formato yyyy-MM-ddTHH:mm:ssZ (UTC). O horário de término deve ser posterior ao horário de início.	2022-03-16T16:59:59Z
Interval	string	Não	A granularidade de tempo dos dados a serem consultados. Unidade: segundos. Valores válidos: 300 3600 86400 Nota Intervalo de tempo ≤ 3 dias: Os valores válidos de granularidade de tempo dos dados são 300, 3600 e 86400. 3 dias < intervalo de tempo ≤ 31 dias: Os valores válidos de granularidade de tempo dos dados são 3600 e 86400. Intervalo de tempo > 31 dias: O único valor válido é 86400. Se este parâmetro não for especificado ou o valor especificado não for suportado, o valor padrão 300 será usado.	300
IspNameEn	string	Não	O nome do provedor de serviços de Internet (ISP) em inglês. Se este parâmetro não for especificado, os dados de todos os ISPs serão retornados. Nota Você pode chamar a operação DescribeLiveRegionAndIsp para consultar os nomes em inglês das regiões e ISPs.	tele***
LocationNameEn	string	Não	O nome da região em inglês. Se este parâmetro não for especificado, os dados de todas as regiões serão retornados. Nota Você pode chamar a operação DescribeLiveRegionAndIsp para consultar os nomes em inglês das regiões e ISPs.	hangzhou
Layer	string	Não	A dimensão da consulta. Valores válidos: Camada de rede (IPv4, IPv6) Camada de aplicação (http, https, quic) all (padrão) Valores válidos: all \| IPv4 \| IPv6 \| http \| https \| quic (sensível a maiúsculas e minúsculas).	all

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
BpsDataInterval	object
DataModule	array<object>	Os dados de largura de banda (bps) para cada intervalo de tempo.
	object	Os dados de largura de banda (bps) para cada intervalo de tempo.
TimeStamp	string	The beginning of the time interval. The value is in the yyyy-MM-ddTHH:mm:ssZ format (UTC).	2022-03-15T16:00:00Z
TrafficValue	string	The total traffic. Unit: bytes.	331
Value	string	The peak bandwidth. Unit: bit/s.	0.56
DataInterval	string	O intervalo de tempo entre as entradas de dados. Unidade: segundos.	300
RequestId	string	O ID da solicitação.	BEA5625F-8FCF-48F4-851B-2A48566EA967

Exemplos

Resposta de sucesso

JSON formato

{
  "BpsDataInterval": {
    "DataModule": [
      {
        "TimeStamp": "2022-03-15T16:00:00Z",
        "TrafficValue": "331",
        "Value": "0.56"
      }
    ]
  },
  "DataInterval": "300",
  "RequestId": "BEA5625F-8FCF-48F4-851B-2A48566EA967"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidStartTime.Malformed	Specified parameter StartTime is not valid.
400	InvalidEndTime.Malformed	Specified parameter EndTime is not valid.
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	InvalidStartTime.ValueNotSupported	Specified end time does not math the specified start time,And the time range does not exceed 90 days.	The start time and the end time do not match. The start time cannot be later than the end time, and the interval between the start time and the end time cannot exceed 90 days.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.