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
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. |
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
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â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
|
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
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
|
ip_group |
Ip_group object |
Grupo de endereços IP |
status |
Integer |
Status da regra. O valor pode ser 0 ou 1.
|
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. |
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
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro |
error_msg |
String |
Mensagem de erro |
Código de estado: 401
Parâmetro |
Tipo |
Descrição |
---|---|---|
error_code |
String |
Código de erro |
error_msg |
String |
Mensagem de erro |
Código de estado: 500
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
OK
{ "id" : "5d43af25404341058d5ab17b7ba78b56", "policyid" : "38ff0cb9a10e4d5293c642bc0350fa6d", "name" : "demo", "timestamp" : 1650531872900, "description" : "demo", "status" : 1, "addr" : "x.x.x.x", "white" : 0, "size" : 1 }
Códigos de status
Código de status |
Descrição |
---|---|
200 |
OK |
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.