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/ API Gateway/ Referencia de la API/ Las API de gateway compartido (para usuarios existentes)/ Vinculación de políticas de control de acceso/ Consulta de la lista de políticas de control de acceso vinculadas a una API

Actualización más reciente 2023-03-29 GMT+08:00

Ver PDF

Consulta de la lista de políticas de control de acceso vinculadas a una API

Función

Esta API se utiliza para consultar la lista de políticas de control de acceso que se han enlazado a una API especificada.

URI

La siguiente tabla muestra el método de solicitud HTTP/HTTPS y el URI de la API.

**Tabla 1** Método de solicitud de HTTP/HTTPS y URI
Método de solicitud	URI
GET	/v1.0/apigw/acl-bindings/binded-acls[?page_no,page_size,api_id,env_id,env_name,acl_id,acl_name]

Se puede agregar una combinación de diferentes condiciones de consulta al final del URI utilizando signos de interrogación (?) y ampersands (&).
Las condiciones de consulta incluyen api_id, env_id, env_name, acl_id, acl_name, page_size y page_no.

En la siguiente tabla se enumeran los parámetros del URI.

**Tabla 2** Descripción de parámetro
Parámetro	Obligatorio	Tipo	Descripción
api_id	Sí	String	ID de API
env_id	No	String	ID de entorno
env_name	No	String	Nombre del entorno
acl_id	No	String	ID de política de control de acceso
acl_name	No	String	Nombre de política de control de acceso
page_size	No	Integer	Número de registros mostrados en cada página. El valor predeterminado es 20.
page_no	No	Integer	Número de página. El valor predeterminado es 1.

Solicitud

N/A

Respuesta

**Tabla 3** Descripción de parámetro
Parámetro	Tipo	Descripción
total	Integer	Número de políticas de control de acceso vinculadas a la API
size	Integer	Número de políticas de control de acceso devueltas
acls	Dictionary	Lista de políticas de control de acceso

**Tabla 4** Descripción de parámetros de acls
Parámetro	Tipo	Descripción
acl_id	String	ID de política de control de acceso
acl_name	String	Nombre de política de control de acceso
acl_type	String	Tipo de control de acceso, que puede ser: PERMIT (lista blanca) DENY (lista negra)
acl_value	String	Objetos de control de acceso
entity_type	String	Tipo de objeto, que puede ser: IP DOMAIN ADMIN
env_id	String	ID del entorno en el que entra en vigor la política de control de acceso
env_name	String	Nombre del entorno en el que entra en vigor la política de control de acceso
bind_id	String	ID de vinculación
bind_time	Timestamp	Hora en que la política de control de acceso está vinculada a la API

Ejemplo de respuesta:

{
  "total": 1,
  "size": 1,
  "acls": [
    {
      "acl_id": "206bb985d8a04ec09f13c3e51ef77095",
      "acl_name": "acl_001",
      "entity_type": "IP",
      "acl_type": "PERMIT",
      "acl_value": "192.168.1.14,192.168.2.0/24,192.168.1.8-192.168.1.110",
      "env_id": "DEFAULT_ENVIRONMENT_RELEASE_ID",
      "env_name": "RELEASE",
      "bind_id": "4ffc0da71ddd4c22add8ff801e19846c",
      "bind_time": "2018-07-27T11:27:10Z"
    }
  ]
}