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)/Políticas de limitación de solicitud de enlace/Vinculación de una política de limitación de solicitudes
Actualización más reciente 2025-12-22 GMT+08:00
Ver PDF
Compartir

Vinculación de una política de limitación de solicitudes

Función

La política de limitación de solicitudes vinculada a una API controlará todo el acceso a la API. Si el número de invocaciones a la API dentro de un período especificado alcanza el límite, se rechazará el acceso posterior, protegiendo la API de backend del tráfico anormal y asegurando un funcionamiento estable del servicio.

Esta API se utiliza para vincular una política de limitación de solicitudes a una API que se ha publicado en un entorno.

Puede vincular diferentes políticas de limitación de solicitudes a una API en entornos diferentes, pero solo puede vincular una política de limitación de solicitudes a la API en cada entorno.

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

POST

/v1.0/apigw/throttle-bindings

Solicitud

Tabla 2 Descripción de parámetro

Parámetro

Obligatorio

Tipo

Descripción

publish_ids

Sí

Array of strings

ID de registro de publicación de API

strategy_id

Sí

String

ID de una política de limitación de solicitudes

Ejemplo de solicitud:

{
  "publish_ids": [
    "374a6d5a-20c7-4ea1-82e1-19fce4556956",
    "65e6fe53-1ac3-4481-ba36-9f0bc6f22057"
  ],
  "strategy_id": "0325b671-2d50-4614-9868-22102262695d"
}

Respuesta

Tabla 3 Descripción de parámetro

Parámetro

Tipo

Descripción

throttle_applys

Dictionary

Lista de vinculación

Tabla 4 Descripción del parámetro de throttle_applys

Parámetro

Tipo

Descripción

id

String

ID de vinculación

strategy_id

String

ID de una política de limitación de solicitudes

publish_id

String

ID de registro de publicación de API

scope

Integer

Alcance de la política de limitación de solicitudes, que puede ser:

  • 1: acceso desde usuarios y aplicaciones
  • 2: acceso desde un usuario
  • 3: acceso desde una aplicación

Actualmente, solo se admite 1.

apply_time

Timestamp

Hora en la que la política de limitación de solicitudes está vinculada a la API

Ejemplo de respuesta:

{
	"throttle_applys": [{
		"id": "507c6a9f-8322-4dc2-8ba5-b4d74e3690d3",
		"strategy_id": "0325b671-2d50-4614-9868-22102262695d",
		"publish_id": "374a6d5a-20c7-4ea1-82e1-19fce4556956",
		"scope": 1,
		"apply_time": "2017-12-29T03:01:11.138456Z"
	},
	{
		"id": "90f05978-06a3-4096-8bea-b5e2fa12b843",
		"strategy_id": "0325b671-2d50-4614-9868-22102262695d",
		"publish_id": "65e6fe53-1ac3-4481-ba36-9f0bc6f22057",
		"scope": 1,
		"apply_time": "2017-12-29T03:01:11.138456Z"
	}]
}

Códigos de estado

Tabla 5 Códigos de estado

Código de estado

Descripción

201

Created

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Server Internal Error