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/ API/ Configuração de nome de domínio/ Consulta dos 100 principais URLs

Atualizado em 2023-12-18 GMT+08:00

Ver PDF

Consulta dos 100 principais URLs

Função

Essa API é usada para consultar os 100 principais URLs.
Você pode consultar dados nos últimos 90 dias.
O período de consulta não pode exceder 31 dias.
A hora de início e a hora de término devem ser especificadas. Por exemplo, se a hora de início for 24/10/2021 00:00:00 e a hora de término for 25/10/2021 00:00:00, as estatísticas em [24/10/2021 00:00:00, 25/10/2021 00:00:00) serão consultadas.
A hora de início e a hora de término devem ser timestamps em milissegundos. Devem ser 00:00:00. Caso contrário, os dados retornados podem não ser os dados esperados.
As métricas de tráfego são medidas por byte e as métricas de solicitação são medidas por número de vezes. Você pode consultar estatísticas sobre nomes de domínio específicos por métricas específicas.
Um único locatário pode chamar essa API cinco vezes por segundo.

URI

GET /v1.0/cdn/statistics/top-url

**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	Especifica a hora de início da consulta (timestamp, em milissegundos). As informações de hora convertidas a partir do carimbo de data/hora devem estar no formato XXXX-XX-XX 00:00:00.
end_time	Sim	Long	Especifica a hora de término da consulta (timestamp, em milissegundos). As informações de hora convertidas a partir do carimbo de data/hora devem estar no formato XXXX-XX-XX 00:00:00.
domain_name	Sim	String	Especifica a 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.
service_area	Não	String	Valores possíveis: mainland_china e outside_mainland_china. O valor padrão é mainland_china.
stat_type	Sim	String	Especifica os tipos de estatísticas. Valores possíveis: flux (tráfego) e req_num (total de solicitações).

Parâmetros de solicitação

Nenhum

Parâmetros de resposta

Código de estado: 200

**Tabela 2** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
service_area	String	Especifica a área de serviço.
top_url_summary	Array of TopUrlSummary objects	Especifica os dados detalhados.

**Tabela 3** TopUrlSummary
Parâmetro	Tipo	Descrição
url	String	Especifica o nome do URL.
value	Long	Especifica o valor de retorno de uma consulta. Unidade de tráfego: byte.
start_time	Long	Especifica a hora de início da consulta (timestamp).
end_time	Long	Especifica a hora de término da consulta (timestamp).
stat_type	String	Especifica os tipos de estatísticas. Valores possíveis: flux (tráfego) e req_num (total de solicitações).

Exemplos de solicitações

Nenhum

Exemplo de respostas

Código de estado: 200

{
  "top_url_summary" : [ {
    "url" : "www.test.com",
    "value" : 888,
    "start_time" : 1511366400000,
    "end_time" : 1511452799640,
    "stat_type" : "req_num"
  }, {
    "url" : "www.yyy.com",
    "value" : 666,
    "start_time" : 1511366400000,
    "end_time" : 1511452799640,
    "stat_type" : "req_num"
  } ],
  "service_area" : "mainland"
}