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 estatísticas sobre nomes de domínio por região e operadora
Atualizado em 2023-02-27 GMT+08:00

Consulta de estatísticas sobre nomes de domínio por região e operadora

Função

  • Você pode consultar dados nos últimos 90 dias.
  • O período de consulta é de 7 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.
  • A hora de início e a hora de término devem ser timestamps em milissegundos. Apenas intervalos exatos de 5 minutos são permitidos, por exemplo, 0 minutos, 5 minutos, 10 minutos e 15 minutos. Se os valores não forem exatos intervalos de 5 minutos, os dados retornados podem não ser os dados esperados.
  • Se a hora de início for 24/01/2019 20:15:00, as estatísticas em [20:15:00, 20:20:00) são coletadas.
  • Unidade: byte para métricas relacionadas ao tráfego, bit/s para métricas relacionadas à largura de banda e número de vezes para quantidade de solicitações.
  • Você pode consultar estatísticas sobre nomes de domínio específicos e detalhes sobre métricas específicas.
  • Se vários nomes de domínio forem passados, os dados de cada nome de domínio serão retornados separadamente.
  • Você pode consultar estatísticas por região e operadora, exceto estatísticas de recuperação de conteúdo.
  • Você pode consultar até 10 métricas de cada vez.
  • Esta API não é aplicável a nomes de domínio cuja área de serviço está fora da China continental.

URI

GET /v1.0/cdn/statistics/domain-item-location-details

Tabela 1 Parâmetros de consulta

Parâmetro

Obrigatório

Tipo

Descrição

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.

start_time

Sim

Long

Hora de início da consulta (timestamp). Apenas intervalos exatos de 5 minutos são permitidos.

end_time

Sim

Long

Hora final da consulta (timestamp). Apenas intervalos exatos de 5 minutos são permitidos.

domain_name

Sim

String

Lista de nomes de domínio. Os nomes de domínio são separados por vírgulas (,), por exemplo, www.test1.com,www.test2.com. O valor all indica que todos os nomes de domínio sob sua conta são consultados.

stat_type

Sim

String

Tipos métricos.

  • Estatísticas de consumo de recursos de rede
    • bw (largura de banda)
    • flux (tráfego)
    • ipv6_bw (largura de banda IPv6)
    • ipv6_flux (tráfego IPv6)
    • https_bw (largura de banda HTTPS)
    • https_flux (tráfego HTTPS)
  • Estatísticas de acesso
    • req_num (número total de solicitações)
    • hit_num (número de acertos)
    • req_time (duração da solicitação)
  • Estatísticas de código de status HTTP (um ou mais tipos podem ser retornados)
    • status_code_2xx (códigos de estado 2xx)
    • status_code_3xx (códigos de estado 3xx)
    • status_code_4xx (códigos de estado 4xx)
    • status_code_5xx (códigos de estado 5xx)

region

Sim

String

Lista de regiões. As regiões estão separadas por vírgulas (,). O valor all indica que todas as regiões são consultadas.

isp

Sim

String

Lista de portadores. As operadoras são separadas por vírgulas (,). O valor all indica que todas as operadoras são consultadas.

Parâmetros de solicitação

Tabela 2 Parâmetro de cabeçalho de solicitação

Parâmetro

Obrigatório

Tipo

Descrição

X-Auth-Token

Sim

String

Token do usuário.

O token pode ser obtido chamando a API do IAM usada para obter um token de usuário. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário.

Parâmetros de resposta

Código de estado: 200

Tabela 3 Parâmetro do corpo de resposta

Parâmetro

Tipo

Descrição

domain_item_location_details

DomainItemLocationDetails object

Detalhes do nome de domínio.

Tabela 4 DomainItemLocationDetails

Parâmetro

Tipo

Descrição

start_time

Long

Hora em que se inicia a recolha de dados (timestamp). O horário pode ser diferente do horário da solicitação.

end_time

Long

Hora em que termina a recolha de dados (timestamp). O horário pode ser diferente do horário da solicitação.

stat_type

String

Tipo métrico.

domains

Array of DomainRegion objects

Detalhes do nome de domínio.

Tabela 5 DomainRegion

Parâmetro

Tipo

Descrição

domain_name

String

Nome de domínio.

region_isp_details

Array of Map<String,Object> objects

Dados métricos. Se não houver dados no segmento de tempo de consulta, uma matriz vazia [] será retornada.

Exemplo de solicitação

GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-item-location-details?start_time=1515996000000&end_time=1515999600000&domain_name=www.test1.com,www.test2.com&stat_type=flux&region=sichuan,guizhou&isp=dianxin

Exemplo de resposta

Código de estado: 200

OK

{
  "domain_item_location_details" : {
    "start_time" : 1515996000000,
    "end_time" : 1515999600000,
    "stat_type" : "flux",
    "domains" : [ {
      "domain_name" : "www.test1.com",
      "region_isp_details" : [ {
        "region" : "sichuan",
        "isp" : "dianxin",
        "flux" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
      }, {
        "region" : "guizhou",
        "isp" : "dianxin",
        "flux" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
      } ]
    }, {
      "domain_name" : "www.test2.com",
      "region_isp_details" : [ {
        "region" : "sichuan",
        "isp" : "dianxin",
        "flux" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
      }, {
        "region" : "guizhou",
        "isp" : "dianxin",
        "flux" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
      } ]
    } ]
  }
}

Códigos de estado

Código de estado

Descrição

200

OK

Códigos de erro

Consulte Códigos de erro.