Consulta de lista de regras da lista negra e da lista branca
Função
Essa API é usada para consultar a lista de regras de lista negra e lista branca.
URI
GET /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. |
page | Não | Integer | Número de página dos dados a serem retornados durante a consulta de paginação. O valor padrão é 1, indicando que os dados na primeira página são retornados. Padrão: 1 |
pagesize | Não | Integer | Número de resultados em cada página durante a consulta de paginação. Faixa de valor: 1 a 100. O valor padrão é 10, indicando que cada página contém 10 resultados. Padrão: 10 |
name | Não | String | Nome da regra da lista branca ou da lista negra |
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âmetros de resposta
Código de estado: 200
Parâmetro | Tipo | Descrição |
|---|---|---|
total | Integer | Número das regras da lista branca e da lista negra |
items | Array of WhiteBlackIpResponseBody objects | Detalhes das regras da lista negra ou da lista branca |
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 |
timestamp | Long | Timestamp (ms) quando a regra foi criada |
description | String | Descrição da regra |
status | Integer | Status da regra. O valor pode ser 0 ou 1.
|
addr | String | Grupo de endereços IP/endereços IP |
white | Integer | Ação Protetora
|
ip_group | Ip_group object | Grupo de endereços IP |
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
GET https://{Endpoint}/v1/{project_id}/waf/policy/{policy_id}/whiteblackip?enterprise_project_id=0 Exemplo de respostas
Código de estado: 200
OK
{
"total" : 1,
"items" : [ {
"id" : "3c96caf769ca4f57814fcf4259ea89a1",
"policyid" : "4dddfd44fc89453e9fd9cd6bfdc39db2",
"name" : "hkhtest",
"timestamp" : 1650362891844,
"description" : "demo",
"status" : 1,
"addr" : "x.x.x.x",
"white" : 0
} ]
} 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.
