Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.

Central de ajuda> Content Delivery Network> Referência de API> APIs desatualizadas> Análise estatística> Consulta de consumo de domínio por região

Atualizado em 2023-02-27 GMT+08:00

Ver PDF

Consulta de consumo de domínio por região

Você pode consultar dados nos últimos 90 dias.

O período de tempo dos dados consultados não pode exceder 31 dias.

Você pode especificar até 100 nomes de domínio em uma consulta.

A hora de início e a hora de término devem ser especificadas ao mesmo tempo. Seus valores devem ser precisos até o milissegundo, mas intervalos exatos de 5 minutos, 1 hora ou 4 horas são permitidos. Se o intervalo de tempo for menor ou igual a um dia, a granularidade de tempo será de 5 minutos, por exemplo, 01/07/2020 08:05:00 e 01/07/2020 08:10:00. Se o intervalo de tempo for superior a 1 dia, mas inferior ou igual a 7 dias, a granularidade do tempo é de 1 hora. Se o intervalo de tempo for superior a 7 dias, a granularidade do tempo é de 4 horas.

Se a hora de início e a hora de término não atenderem aos requisitos, os dados retornados podem ser diferentes do esperado.

Função

Essa API é usada para consultar o consumo de nomes de domínio por região dentro de um intervalo de tempo.

URI

GET /v1.0/cdn/statistics/region-detail-summary

Solicitação

Parâmetros de solicitação

Tabela 1 descreve os parâmetros de solicitação.

**Tabela 1** Parâmetros de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
start_time	Não	Integer	Especifica a hora de início de uma consulta (timestamp, em milissegundos).
end_time	Não	Integer	Especifica a hora de término de uma consulta (timestamp, em milissegundos).
domain_name	Sim	String	Especifica uma lista de nomes de domínio. Use vírgulas (,) para separar nomes de domínio, por exemplo, www.test1.com,www.test2.com. O valor ALL indica que todos os nomes de domínio sob um locatário são consultados.
stat_type	Sim	String	Especifica os tipos de estatística, incluindo flux (tráfego), bw (largura de banda) e req_num (total de solicitações).
region	Não	String	Especifica a lista de regiões, que abrange as 34 divisões de nível provincial (incluindo Hong Kong, Macau e Taiwan) da China, regiões fora da China e outras. Separe essas regiões com vírgulas (,). Por exemplo, beijing,neimenggu. NOTA: Nome de uma região, por exemplo, Pequim, Xangai, Hong Kong, Macau e Taiwan. Use pinyin chinês (beijing, shanghai e gangaotai). Use haiwai para regiões fora da China. Os parâmetros para Shanxi e Shaanxi são os seguintes: shanxi e shaanxi. Se este parâmetro for definido como ALL ou não for transportado em uma solicitação, todas as regiões serão consultadas.
enterprise_project_id	Não	String	Projeto corporativo ao qual o recurso pertence. Este parâmetro é válido somente quando a função do projeto empresarial está ativada. O valor all indica todos os projetos. Esse parâmetro é obrigatório quando você usa um usuário do IAM para chamar essa API.

Exemplos de solicitações

Caminho solicitado

GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/region-detail-summary?start_time=1511366400000&end_time=1511452799640&domain_name=ALL&stat_type=req_num&region=beijing,neimenggu&enterprise_project_id=0

Resposta

Parâmetros de resposta

Tabela 2 descreve os parâmetros de resposta.

**Tabela 2** Parâmetro de resposta
Parâmetro	Tipo	Descrição
region_data	Array of objects	Especifica a lista de dados detalhada da região. Para mais detalhes, consulte Tabela 3.

descrição do parâmetro region_data

Tabela 3 descreve os parâmetros.

**Tabela 3** descrição do parâmetro region_data
Parâmetro	Tipo	Descrição
region	String	Especifica a região.
value	Integer	Especifica o valor da métrica consultada. A unidade de tráfego é byte. A unidade de largura de banda é bit/s.

Exemplo de respostas

{
   "region_data":
   [
      {
        "region": "beijing",
        "value": 586
      },
      {
        "region": "neimenggu",
        "value": 862
      }
   ]
}