Consulta do consumo de domínio por 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. Seus valores devem ser precisos até o milissegundo, mas intervalos exatos de 5 minutos, 1 hora ou 4 horas são permitidos. Se o intervalo de tempo for menor ou igual a um dia, a granularidade de tempo será de 5 minutos, por exemplo, 01/07/2020 08:05:00 e 01/07/2020 08:10:00. Se o intervalo de tempo for superior a 1 dia, mas inferior ou igual a 7 dias, a granularidade do tempo é de 1 hora. Se o intervalo de tempo for superior a 7 dias, a granularidade do tempo é de 4 horas.
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 o consumo de nomes de domínio por operadora dentro de um intervalo de tempo.
URI
GET /v1.0/cdn/statistics/carrier-detail-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ística, incluindo flux (tráfego), bw (largura de banda) e req_num (total de solicitações). |
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. |
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/carrier-detail-summary?start_time=1511366400000&end_time=1511452799640&domain_name=ALL&stat_type=req_num&carrier=CMCC,CTCC&enterprise_project_id=0
Resposta
Parâmetros de resposta
Tabela 2 descreve os parâmetros de resposta.
Parâmetro |
Tipo |
Descrição |
---|---|---|
carrier_data |
Array of objects |
Especifica os dados da operadora. Para mais detalhes, consulte Tabela 3. |
descrição do parâmetro carrier_data
Tabela 3 descreve os parâmetros.
Parâmetro |
Tipo |
Descrição |
---|---|---|
carrier |
String |
Especifica a transportadora. |
value |
Integer |
Especifica o valor da métrica consultada. A unidade de tráfego é byte. A unidade de largura de banda é bit/s. |
{ "carrier_data": [ { "carrier":"CMCC", "value": 857 }, { "carrier": "CTCC", "value": 545 } ] }
Código de estado
Consulte Códigos de estado.
Código de erro
Consulte Códigos de erro.