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)/ Gestión de políticas de control de acceso/ Consulta de la lista de políticas de control de acceso

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

Ver PDF

Consulta de la lista de políticas de control de acceso

Función

Esta API se utiliza para consultar la lista de todas las políticas de control de acceso.

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/acls[?page_size, page_no, id, name, acl_type, entity_type]

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: id, name, acl_type, entity_type, 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
id	No	String	ID de política de control de acceso
name	No	String	Nombre de política de control de acceso
acl_type	No	String	Tipo de control de acceso, que puede ser PERMIT o DENY
entity_type	No	String	Tipo de objeto, que puede ser IP o DOMAIN
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.
precise_search	No	String	Nombre del parámetro name para la coincidencia exacta

Solicitud

N/A

Respuesta

**Tabla 3** Descripción de parámetro
Parámetro	Tipo	Descripción
size	Integer	Número de políticas de control de acceso mostradas en la página actual
total	Integer	Número total de políticas de control de acceso
acls	Dictionary	Lista de políticas de control de acceso

**Tabla 4** Descripción de parámetros de acls
Parámetro	Tipo	Descripción
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
update_time	Timestamp	Hora en la que se actualizó por última vez la política de control de acceso
bind_num	Integer	Número de las API a las que se ha enlazado la política de control de acceso

Ejemplo de respuesta:

{
	"total": 1,
	"size": 1,
	"acls": [{
		"id": "d402b35e-1054-4280-b1c5-0d741a28c995",
		"acl_name": "goodone",
		"entity_type": "DOMAIN",
		"acl_type": "PERMIT",
		"acl_value": "19asdfaf-adfadf",
		"update_time": "2017-11-18T14:27:36.918578+08:00",
                "bind_num":1
	}]
}