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/ Web Application Firewall/ Referência de API/ API/ Painel de controle/ Consulta de solicitações de sites

Atualizado em 2022-11-02 GMT+08:00

Ver PDF

Consulta de solicitações de sites

Função

Esta API é usada para consultar solicitações de sites. Observe que as API relacionadas ao painel não podem ser usadas para consultar dados por tempo personalizado. Somente os dados exibidos no console para ontem, hoje, últimos 3 dias, últimos 7 dias e últimos 30 dias podem ser consultados.

URI

GET /v1/{project_id}/waf/overviews/request/timeline

**Tabela 1** Parâmetros de caminho
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	String	ID do projeto. Para obtê-lo, vá para o console de gerenciamento do Huawei Cloud e passe o cursor sobre seu nome de usuário. Na janela exibida, escolha My Credentials.Em seguida, na área Projects, visualize Project ID correspondente.

**Tabela 2** Parâmetros de consulta
Parâmetro	Obrigatório	Tipo	Descrição
enterprise_project_id	Não	String	Você pode obter o ID chamando a API ListEnterpriseProject do EPS.
from	Sim	Long	Hora de início (13 dígitos timestamp em milissegundos). Este parâmetro deve ser usado junto com to.
to	Sim	Long	Hora de término (timestamp de 13 dígitos em milissegundos). Este parâmetro deve ser usado junto com from.
hosts	Não	Array	Os ID de nome de domínio. No modo de nuvem, os ID de nome de domínio podem ser obtidos chamando a API ListHost. No modo dedicado, os ID de nome de domínio podem ser obtidos chamando a API ListPremiumHost. Por padrão, esse parâmetro não é necessário e os dados estatísticos de todos os nomes de domínio protegidos no projeto são consultados. Para consultar dados sobre vários nomes de domínio especificados, consulte o exemplo de solicitação.
instances	Não	Array	Os ID de instância que você deseja consultar. Esse parâmetro é necessário somente para instâncias dedicadas do WAF e instâncias de balanceamento de carga (modo ELB).
group_by	Não	String	Como os dados são exibidos. Para exibir dados por dia, defina o parâmetro como DAY. Por padrão, esse parâmetro não é especificado e os dados são exibidos por minuto.

Parâmetros de solicitação

**Tabela 3** Parâmetros de cabeçalho de solicitação
Parâmetro	Obrigatório	Tipo	Descrição
X-Auth-Token	Sim	String	Token do usuário. Ele pode ser obtido chamando a API do IAM (valor de X-Subject-Token no cabeçalho da resposta).
Content-Type	Sim	String	Tipo de conteúdo. Padrão: application/json;charset=utf8

Parâmetros de resposta

Código de estado: 200

**Tabela 4** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
[items]	Array of StatisticsTimelineItem objects	Solicitar Dados de Cronograma para Estatísticas de Segurança.

**Tabela 5** StatisticsTimelineItem
Parâmetro	Tipo	Descrição
key	String	Valor da chave. As opções são ACCESS para solicitações totais, CRAWLER para mitigação de bot, TOTAL_ATTACK para ataques totais, WEB_ATTACK para proteção básica da Web, PRECISE para proteção precisa, CC para proteção contra ataques CC
timeline	Array of TimeLineItem objects	Dados estatísticos ao longo do tempo para o valor da chave correspondente

**Tabela 6** TimeLineItem
Parâmetro	Tipo	Descrição
time	Long	Data e hora
num	Integer	Quantidade.

Código de estado: 400

**Tabela 7** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro
error_msg	String	Mensagem de erro

Código de estado: 401

**Tabela 8** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro
error_msg	String	Mensagem de erro

Código de estado: 500

**Tabela 9** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
error_code	String	Código de erro
error_msg	String	Mensagem de erro

Exemplos de solicitações

GET https://{Endpoint}/v1/{project_id}/waf/overviews/request/timeline?enterprise_project_id=0&from=1650470400196&to=1650470450000

Exemplo de respostas

Código de estado: 200

[ {
  "key" : "ACCESS",
  "timeline" : [ {
    "time" : 1650470400196,
    "num" : 0
  } ]
}, {
  "key" : "PRECISE",
  "timeline" : [ {
    "time" : 1650470400196,
    "num" : 0
  } ]
}, {
  "key" : "CRAWLER",
  "timeline" : [ {
    "time" : 1650470400196,
    "num" : 0
  } ]
}, {
  "key" : "CC",
  "timeline" : [ {
    "time" : 1650470400196,
    "num" : 0
  } ]
}, {
  "key" : "TOTAL_ATTACK",
  "timeline" : [ {
    "time" : 1650470400000,
    "num" : 0
  } ]
}, {
  "key" : "WEB_ATTACK",
  "timeline" : [ {
    "time" : 1650470400196,
    "num" : 0
  } ]
} ]