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 tabla de referencia
Actualización más reciente 2022-11-02 GMT+08:00
Ver PDF
Compartir

Creación de una tabla de referencia

Función

Esta API se utiliza para crear una tabla de referencia.

URI

POST /v1/{project_id}/waf/valuelist

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

Sí

String

ID del proyecto
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

Nombre de tabla de referencia. El valor puede contener un máximo de 64 caracteres. Solo se permiten dígitos, letras, guiones (-) guiones bajos y puntos (.).

Mínimo: 2

Máximo: 64

type

Sí

String

Tipo de tabla de referencia. Para obtener más información, consulte la lista de enumeración.

Mínimo: 2

Máximo: 32

Valores de enumeración:

  • url
  • params
  • ip
  • cookie
  • referer
  • user-agent
  • header
  • response_code
  • response_header
  • response_body

values

Sí

Array of strings

Valor de la tabla de referencia

description

No

String

Descripción de la tabla de referencia. El valor contiene un máximo de 128 caracteres.

Mínimo: 0

Máximo: 128

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 tabla de referencia

name

String

Nombre de tabla de referencia

type

String

Tipo de tabla de referencia

description

String

Descripción de la tabla de referencia

timestamp

Long

Marca de tiempo de la tabla de referencia

values

Array of strings

Valor de la tabla de referencia

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 estad: 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/valuelist?enterprise_project_id=0

{
  "name" : "demo",
  "type" : "url",
  "values" : [ "/124" ],
  "description" : "demo"
}

Ejemplo de respuestas

Código de estado: 200

La solicitud se ha realizado correctamente.

{
  "id" : "e5d9032d8da64d169269175c3e4c2849",
  "name" : "demo",
  "type" : "url",
  "values" : [ "/124" ],
  "timestamp" : 1650524684892,
  "description" : "demo",
  "producer" : 1
}

Códigos de estado

Código de estado

Descripción

200

La solicitud se ha realizado correctamente.

400

Error de solicitud.

401

Permisos de token insuficientes.

500

Error del servidor interno

Códigos de error

Consulte Códigos de error.

Tema principal: Gestión de reglas