Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Web Application Firewall/ Referencia de la API/ API/ Gestión de reglas/ Creación de una regla de lista negra/lista blanca

Actualización más reciente 2022-11-02 GMT+08:00

Ver PDF

Creación de una regla de lista negra/lista blanca

Función

Esta API se utiliza para crear una regla de lista negra o lista blanca.

URI

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

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID del proyecto
policy_id	Sí	String	ID de política. Se puede obtener llamando a la API ListPolicy.

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
enterprise_project_id	No	String	ID del proyecto de empresa. Se puede obtener mediante el llamado API ListEnterpriseProject de EPS.

Parámetros de solicitud

**Tabla 3** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Se puede obtener llamando a la API IAM (valor de X-Subject-Token en el encabezado de respuesta).
Content-Type	Sí	String	Tipo de contenido Predeterminado: application/json;charset=utf8

**Tabla 4** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
name	Sí	String	El nombre de la regla contiene un máximo de 64 caracteres. Solo se permiten letras, dígitos, guiones bajos (_) y puntos (.).
addr	Sí	String	Direcciones IP o intervalos de direcciones IP en la regla de lista negra o lista blanca, por ejemplo, 42.123.120.66 o 42.123.120.0/16.
description	No	String	Descripción de la regla
white	Sí	Integer	Acción protectora: \n - 0: Block \n - 1: Allow \n - 2: Log only

Parámetros de respuesta

Código de estado: 200

**Tabla 5** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
id	String	ID de la regla.
policyid	String	ID de política
addr	String	Direcciones IP o intervalos de direcciones IP en la regla de lista negra o lista blanca, por ejemplo, 42.123.120.66 o 42.123.120.0/16.
white	Integer	Acción protectora: \n - 0: Block \n - 1: Allow \n - 2: Log only
timestamp	Long	Hora en que se crea una regla. El valor es una marca de tiempo de 13 dígitos en milisegundos.

Código de estado: 400

**Tabla 6** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Código de estado: 401

**Tabla 7** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Código de estado: 500

**Tabla 8** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
error_code	String	Código de error
error_msg	String	Mensaje de código de error

Solicitudes de ejemplo

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

Ejemplo de respuestas

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
}