Consulta de resumo do 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, mas são permitidos intervalos exatos de uma hora ou um dia (00:00:00). Se o intervalo de tempo for inferior a 7 dias, a granularidade de 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 tempo for maior que 7 dias, mas menor que 31 dias, 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
Esta API é usada para consultar informações resumidas sobre nomes de domínio específicos dentro de um intervalo de tempo.
URI
GET /v1.0/cdn/statistics/domain-summary
Solicitação
Parâmetros de solicitação
Tabela 1 descreve os 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ísticas: bw (largura de banda), flux (tráfego), bs_bw (largura de banda de recuperação), bs_flux (tráfego de recuperação), req_num (número total de solicitações), req_hit_rate (taxa de acerto de cache), flux_hit_rate (taxa de acerto de tráfego), bs_fail_rate (taxa de falha de recuperação), qps (solicitações por segundo), http_code_2xx (código de status 2x x), 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?start_time=1513094400000&end_time=1513180799346&domain_name=example3.example2.example1.com&interval=300&stat_type=flux&enterprise_project_id=0
Resposta
Parâmetros de resposta
Tabela 2 descreve os parâmetros de resposta.
Parâmetro |
Tipo |
Descrição |
---|---|---|
domain_summary |
Object |
Especifica o total dos objetos de dados consultados. Para mais detalhes, consulte Tabela 3. |
descrição do parâmetro domain_summary
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). |
value |
Integer |
Especifica o valor total de uma métrica (unidade de tráfego: byte; 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. |
{ "domain_summary": { "value": 835038584, "start_time": 1513094400000, "end_time": 1513180799346, "stat_type": "flux", "service_area": "mainland_china" } }
Código de estado
Consulte Códigos de estado.
Código de erro
Consulte Códigos de erro.