Consulta de estatísticas sobre nomes de domínio sob uma região ou operadora
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. A hora de início e a hora de término devem ser precisas até o milissegundo, mas apenas intervalos de amostragem exatos são permitidos. Por exemplo, se o intervalo de amostragem for de 5 minutos, a hora de início e a hora de término poderão ser 01/07/2020 08:05:00 e 01/07/2020 08:10: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 as estatísticas de nomes de domínio sob uma operadora especificada em uma região especificada e período de tempo especificado.
URI
GET /v1.0/cdn/statistics/region-carrier-detail
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ística, incluindo flux (tráfego), bw (largura de banda) e req_num (total de solicitações). |
region |
Sim |
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:
O valor ALL indica que todas as regiões são consultadas. |
carrier |
Sim |
String |
Especifica a lista de operadoras. Os nomes abreviados das transportadoras são usados aqui. Atualmente, os valores válidos são CTCC (China Telecom), CUCC (China Unicom), ENET (China Education and Research Network), CMCC (China Mobile) e CRC (Tietong). Os nomes das operadoras são separados por vírgulas (,). Por exemplo, CTCC,CMCC. O valor ALL indica que todas as operadoras são consultadas. region e carrier não podem ser definidas como ALL. |
interval |
Não |
Integer |
Especifica o intervalo de amostragem. interval é medido em segundos, e seus valores são descritos da seguinte forma: Para um período de tempo de 1 dia, o valor pode ser 5 minutos, 1 hora, 4 horas ou 8 horas. Para um intervalo de tempo de 2 a 7 dias, o valor pode ser 5 minutos, 1 hora, 4 horas, 8 horas ou 1 dia. Para um período de 8 a 31 dias, o valor pode ser 4 horas, 8 horas ou 1 dia. 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. Se precisar especificá-lo na solicitação, converta o intervalo em segundos. |
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-carrier-detail?start_time=1559318400000&end_time=1559577600000&domain_name=www.test1.com,www.test2.com,www.test3.com,www.test4.com&stat_type=req_num®ion=beijing&carrier=CMCC&interval=86400&enterprise_project_id=0
Resposta
Parâmetros de resposta
Tabela 2 descreve os parâmetros de resposta.
Parâmetro |
Tipo |
Descrição |
---|---|---|
region |
Array of strings |
Especifica a região. |
carrier |
Array of strings |
Especifica a transportadora. |
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). |
stat_type |
String |
Especifica os tipos de estatística, incluindo flux (tráfego), bw (largura de banda) e req_num (total de solicitações). |
interval |
Integer |
Especifica o intervalo de amostragem. |
values |
Array of integers |
Especifica o valor de retorno de uma consulta. Os dados de um determinado período de tempo são exibidos com base na granularidade do tempo de consulta. Os valores são separados por vírgulas (,). A unidade de tráfego é byte. A unidade de largura de banda é bit/s.
NOTA:
Se vários nomes de domínio forem consultados, o valor retornado será o total de resultados da consulta de todos os nomes de domínio. |
{ "region": [ "beijing" ], "carrier": [ "all" ], "start_time": 1559318400000, "end_time": 1559577600000, "stat_type": "req_num", "values": [ 66, 64, 68 ], "interval": 86400 }
Código de estado
Consulte Códigos de estado.
Código de erro
Consulte Códigos de erro.