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/TaurusDB/Referencia de la API/Las API (recomendadas)/Proxy de base de datos/Configuración de reglas de control de acceso

Actualización más reciente 2025-03-21 GMT+08:00

Configuración de reglas de control de acceso

Función

Esta API se utiliza para configurar reglas de control de acceso. Antes de invocar a esta API:

Aprender cómo autorizar y autenticarla.
Obtenga la región y el punto de conexión requeridos.

URI

POST /v3/{project_id}/instances/{instance_id}/proxy/{proxy_id}/access-control

**Tabla 1** Parámetros de URI
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	ID de proyecto de un tenant en una región. Para obtener este valor, consulte Obtención de un ID de proyecto.
instance_id	Sí	String	ID de instancia, que es compatible con el formato UUID.
proxy_id	Sí	String	ID de instancia de proxy, que cumple con el formato UUID.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Token de usuario. Para obtener este valor, invoque a la API de IAM para obtener un token de usuario. El valor de X-Subject-Token en el encabezado de respuesta es el valor del token.
X-Language	No	String	Tipo de idioma de solicitud. El valor predeterminado es en-us. Valores: en-us zh-cn

**Tabla 3** Parámetro del cuerpo de la solicitud
Parámetro	Obligatorio	Tipo	Descripción
type	Sí	String	Tipo de control de acceso. Valores: white: indica la lista blanca. black: indica la lista negra.
ip_list	Sí	Array of AccessControlRule objects	Matriz de direcciones IP que controlan el acceso. Se pueden agregar hasta 300 direcciones IP o bloques CIDR.

**Tabla 4** AccessControlRule
Parámetro	Obligatorio	Tipo	Descripción
ip	Sí	String	Dirección IP o bloque CIDR.
description	No	String	Comentarios. Longitud de caracteres: 0–50. No se permiten paréntesis angulares (<>).

Parámetros de respuesta

Código de estado: 200

**Tabla 5** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
open_access_control	Boolean	Si el control de acceso está habilitado. Valores: true: habilitar false: deshabilitar

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 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 error.

Ejemplo de la solicitud

Configuración de reglas de control de acceso

POST https://{endpoint}/v3/0483b6b16e954cb88930a360d2c4e663/instances/61a4ea66210545909d74a05c27a7179ein07/proxy/e87088f0b6a345e79db19d57c41fde15po01/access-control

{
  "type" : "black",
  "ip_list" : [ {
    "ip" : "192.107.0.1",
    "description" : "black01"
  } ]
}