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/ Gerenciamento de regras/ Criação de uma regra de lista negra/lista branca

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

Ver PDF

Criação de uma regra de lista negra/lista branca

Função

Essa API é usada para criar uma regra de lista negra ou lista branca.

URI

POST /v1/{project_id}/waf/policy/{policy_id}/whiteblackip

**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.
policy_id	Sim	String	ID da política. Ele pode ser obtido chamando a API ListPolicy.

**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.

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

**Tabela 4** Parâmetros do corpo da solicitação
Parâmetro	Obrigatório	Tipo	Descrição
name	Sim	String	Nome da rue. O valor pode conter no máximo 64 caracteres. Apenas letras, dígitos, hifens (-), sublinhados (_) e pontos (.) são permitidos.
addr	Não	String	Endereço IP ou intervalos de endereços IP na regra de lista negra ou lista branca, por exemplo, 42.123.120.66 ou 42.123.120.0/16.
description	Não	String	Descrição da regra
white	Sim	Integer	Ação Protetora 0: O WAF bloqueia solicitações que atingem a regra. 1: O WAF permite solicitações que batem na regra. 2: O WAF registra apenas solicitações que atingem a regra.
ip_group_id	Não	String	ID do grupo de endereços IP criado. Use este parâmetro ou addr. Para adicionar um grupo de endereços IP, vá para o console do WAF, escolha Objects > Address Groups, e clique em Add Address Group.

Parâmetros de resposta

Código de estado: 200

**Tabela 5** Parâmetros do corpo de resposta
Parâmetro	Tipo	Descrição
id	String	ID da regra
name	String	Nome da regra da lista branca ou da lista negra
policyid	String	ID da política
addr	String	Endereço IP ou intervalos de endereços IP na regra de lista negra ou lista branca, por exemplo, 42.123.120.66 ou 42.123.120.0/16.
white	Integer	Ação Protetora 0: O WAF bloqueia solicitações que atingem a regra. 1: O WAF permite solicitações que batem na regra. 2: O WAF registra apenas solicitações que atingem a regra.
ip_group	Ip_group object	Grupo de endereços IP
status	Integer	Status da regra. O valor pode ser 0 ou 1. 0: A regra está desativada. 1: A regra está ativada.
description	String	Descrição da regra
timestamp	Long	Hora em que uma regra é criada. O valor é um carimbo de data/hora de 13 dígitos em milissegundos.

**Tabela 6** Ip_group
Parâmetro	Tipo	Descrição
id	String	ID do grupo de endereços IP
name	String	Nome do grupo de endereços IP
size	Long	Número de endereços IP ou intervalos de endereços IP no grupo de endereços IP

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

POST https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/whiteblackip?enterprise_project_id=0

{
  "name" : "demo",
  "white" : 0,
  "description" : "demo",
  "addr" : "x.x.x.x"
}

Exemplo de respostas

Código de estado: 200

{
  "id" : "5d43af25404341058d5ab17b7ba78b56",
  "policyid" : "38ff0cb9a10e4d5293c642bc0350fa6d",
  "name" : "demo",
  "timestamp" : 1650531872900,
  "description" : "demo",
  "status" : 1,
  "addr" : "x.x.x.x",
  "white" : 0,
  "size" : 1
}