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.
Atualizado em 2023-02-27 GMT+08:00

Consulta do consumo de cada nome de domínio

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

Essa API é usada para consultar informações resumidas sobre cada nome de domínio dentro de um intervalo de tempo.

URI

GET /v1.0/cdn/statistics/domain

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 número máximo de nomes de domínio é 20.

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?start_time=1513094400000&end_time=1513180799346&domain_name=example1.example2.com,example3.example4.com&interval=300&stat_type=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

Object

Especifica as estatísticas de nome de domínio. Para mais detalhes, consulte Tabela 3.

descrição do parâmetro de domínio

Tabela 3 descreve os parâmetros.

Tabela 3 descrição do parâmetro de domínio

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 tráfego total consultado. A unidade de tráfego é byte. A unidade de largura de banda é bit/s.

stat_type

String

Especifica o tipo de estatística.

domain_name

String

Especifica o nome de domínio.

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": 
     [
        {
            "value": 197400,
            "start_time": 1513094400000,
            "end_time": 1513180799346,
            "stat_type": "flux",
            "domain_name": "example1.example2.com",
            "service_area": "mainland_china"
        },
        {
            "value": 42825,
            "start_time": 1513094400000,
            "end_time": 1513180799346,
            "stat_type": "flux",
            "domain_name": "example3.example4.com",
            "service_area": "mainland_china"
        }
    ]
}

Código de estado

Consulte Códigos de estado.

Código de erro

Consulte Códigos de erro.