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 detalhes de consumo

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

Ver PDF

Consulta de detalhes de consumo

Você pode consultar dados nos últimos 90 dias.

O intervalo de tempo varia de 1 hora a 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. Se o intervalo de amostragem for menor ou igual a 1 hora, a granularidade do tempo deve ser de uma hora, por exemplo, 01/07/2020 08:00:00 e 01/07/2020 09:00:00. Se o intervalo de amostragem for superior a 1 hora, a granularidade de tempo deve ser um dia inteiro, por exemplo, 01/07/2020 00:00:00 e 02/07/2020 00:00:00.

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 detalhes de consumo sobre nomes de domínio específicos dentro de um intervalo de tempo.

URI

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

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. Um máximo de 100 nomes de domínio podem ser consultados por vez.
interval	Não	Integer	Especifica o intervalo de amostragem. interval é medido em segundos, e seus valores são descritos da seguinte forma: Para um intervalo de tempo de 1 dia, os intervalos de amostragem podem ser de 5 minutos, 1 hora, 4 horas e 8 horas. Ou seja, os valores podem ser 300, 3600, 14400 e 28800. Para um intervalo de tempo de 2 a 7 dias, os intervalos de amostragem podem ser de 5 minutos, 1 hora, 4 horas, 8 horas e 1 dia. Ou seja, os valores podem ser 300, 3600, 14400, 28800 e 86400. Para um intervalo de tempo de 8 a 31 dias, os intervalos de amostragem podem ser de 4 horas, 8 horas e 1 dia. Ou seja, os valores podem ser 14400, 28800 e 86400. Se você não especificar um valor para interval, o sistema usará o menor valor correspondente ao período de tempo consultado por padrão.
stat_type	Sim	String	Especifica os tipos de estatísticas: bw (largura de banda), flux (tráfego), bs_bw (largura de banda de recuperação), bs_flux (tráfego de recuperação), bs_num (número total de solicitações de recuperação), bs_fail_num (número total de recuperações com falha), req_num (número total de solicitações), req_hit_rate (taxa de acertos de cache), flux_hit_rate (taxa de acertos de tráfego), bs_fail_rate (taxa de falha de recuperação), qps (solicitações por segundo), http_code_2xx (código de status 2xx), http_code_3xx (código de status 3xx), http_code_4xx (código de status 4xx) e http_code_5xx (código de status 5xx).
service_area	Não	String	Os valores válidos são mainland_china e outside_mainland_china. O valor padrão é mainland_china. Não é possível consultar métricas de recuperação, incluindo bs_flux, bs_bw e bs_fail_rate por área de serviç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.

Exemplos de solicitações

Caminho solicitado

GET https://cdn.myhuaweicloud.com/v1.0/cdn/statistics/domain-summary-detail?start_time=1498838400000&end_time=1502380500000&domain_name=www.example.com&interval=300&stat_type=bs_flux&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
domain_summary_detail	Object	Especifica os dados detalhados. Para mais detalhes, consulte Tabela 3.

descrição do parâmetro domain_summary_detail

Tabela 3 descreve os parâmetros.

**Tabela 3** descrição do parâmetro domain_summary_detail
Parâmetro	Tipo	Descrição
start_time	Integer	Especifica a hora de início de uma consulta (timestamp, em milissegundos).
end_time	Integer	Especifica a hora de término de uma consulta (timestamp, em milissegundos).
interval	Integer	Especifica o intervalo de amostragem, medido por segundos.
values	Array of integers	Especifica a matriz de pontos de amostragem. Cada ponto de amostragem é gerado em cada intervalo de amostragem. O tipo de cada ponto de amostragem é longo. A unidade de tráfego é byte. A unidade de largura de banda é bit/s.
stat_type	String	Especifica o tipo de estatística.
service_area	String	Os valores válidos são mainland_china (China continental) e outside_mainland_china (fora da China continental). Não é possível consultar métricas de recuperação por área de serviço.

Exemplo de respostas

{
  "domain_summary_detail": {
        "interval": 300,
        "values": [835038583,835038584],
        "start_time": 1498838400000,
        "end_time": 1502380500000,
        "stat_type": "bs_flux",
        "service_area": "outside_example_china"
   }
}