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 2025-12-22 GMT+08:00
Ver PDF
Compartir

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

Códigos de estado

Tabla 5 Códigos de estado

Código de estado

Descripción

200

OK

400

Bad Request

403

Forbidden

404

Not Found

500

Server Internal Error