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/ Eliminación de una regla de lista negra o de lista blanca

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

Ver PDF

Eliminación de una regla de lista negra o de lista blanca

Función

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

URI

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

**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.
rule_id	Sí	String	ID de la regla de lista negra o lista blanca. Se puede obtener llamando a la API ListWhiteblackipRule.

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

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
id	String	ID de regla de lista negra o blanca
policyid	String	ID de política
name	String	Nombre de la regla
timestamp	Long	Hora en que se elimina una regla. El valor debe ser una marca de tiempo de 13 dígitos en milisegundos.
description	String	Descripción.
status	Integer	Estado de la regla. El valor puede ser 0 (deshabilitado) o 1 (habilitado).
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

Código de estado: 400

**Tabla 5** 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 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: 500

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

Solicitudes de ejemplo

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

Ejemplo de respuestas

Código de estado: 200

La solicitud se ha realizado correctamente.

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