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.
