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 estatísticas sobre nomes de domínio sob uma região ou operadora
Atualizado em 2023-02-27 GMT+08:00

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.

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.

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:
  • Nome de uma região, por exemplo, Pequim, Xangai, Hong Kong, Macau e Taiwan. Use pinyin chinês (beijing, shanghai, and gangaotai). Use haiwai para regiões fora da China.
  • Os parâmetros para Shanxi e Shaanxi são os seguintes: shanxi e shaanxi.

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&region=beijing&carrier=CMCC&interval=86400&enterprise_project_id=0

Resposta

Parâmetros de resposta

Tabela 2 descreve os parâmetros de resposta.

Tabela 2 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.

Exemplo de respostas
{
    "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.