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/ Atualização de uma regra de proteção de lista negra ou lista branca
Atualizado em 2022-11-02 GMT+08:00
Ver PDF
Compartilhar

Atualização de uma regra de proteção de lista negra ou lista branca

Função

Essa API é usada para atualizar as regras de proteção de listas negras e listas brancas. Você pode atualizar endereços IP, intervalos de endereços IP, ações de proteção e outras informações.

URI

PUT /v1/{project_id}/waf/policy/{policy_id}/whiteblackip/{rule_id}

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.

rule_id

Sim

String

ID da regra da lista negra ou da lista branca. Ele pode ser obtido chamando a API **ListWhiteblackipRule.
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 regra da lista branca ou da lista negra

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 incluídos na regra da lista branca ou da lista negra.

description

String

Descrição da regra da lista negra ou da lista branca

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

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

{
  "name" : "demo",
  "white" : 0,
  "description" : "demo",
  "addr" : "1.1.1.2"
}

Exemplo de respostas

Código de estado: 200

Solicitação bem-sucedida.

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

Códigos de status

Código de status

Descrição

200

Solicitação bem-sucedida.

400

Falha na solicitação.

401

O token não tem permissões necessárias.

500

Erro de servidor interno.

Códigos de erro

Consulte Códigos de erro.

Tópico principal: Gerenciamento de regras