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

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

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

String

ID de instancia, que es compatible con el formato UUID.

proxy_id

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

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

String

Tipo de control de acceso. Valores:

  • white: indica la lista blanca.
  • black: indica la lista negra.

ip_list

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

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

Ejemplo de la respuesta

Código de estado: 200

Operación exitosa.

{
  "open_access_control" : false
}

Código de estado

Para más detalles, véase Códigos de estado.

Código de error

Para más detalles, véase Códigos de error.