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)/Configuración de limitación de solicitud excluida/Creación de una configuración de limitación de solicitudes excluidas
Actualización más reciente 2025-12-22 GMT+08:00
Ver PDF
Compartir

Creación de una configuración de limitación de solicitudes excluidas

Función

Una política de limitación de solicitudes controla el número máximo de veces que se puede acceder a una API dentro de un período especificado y el número máximo de veces que un inquilino o una aplicación pueden acceder a la API dentro del mismo período.

Cuando sea necesario, puedes crear una configuración de limitación de solicitudes excluidas para especificar el umbral de llamadas a la API para una aplicación específica. Por ejemplo, después de establecer el umbral de invocación de API para todas las aplicaciones en 500 invocaciones/minuto, puede especificar el umbral de invocación de API de la aplicación 1 como 800 invocaciones/minuto.

Puede agregar aplicaciones o inquilinos excluidos a una política de limitación de solicitudes.

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-specials

Solicitud

Tabla 2 Descripción de parámetro

Parámetro

Obligatorio

Tipo

Descripción

call_limits

Sí

Integer

Número máximo de veces que el objeto excluido puede acceder a una API dentro del período de limitación

instance_id

Sí

String

ID de aplicación excluido o ID de cuenta excluido

instance_type

Sí

String

Tipo de objeto, que puede ser APP o USER

strategy_id

Sí

String

Solicitar ID de política de limitación

Ejemplo de solicitud:

{
	"call_limits": 150,
	"instance_id": "98efd77d-10b5-4eca-8170-ed30a4a286a4",
	"instance_type": "APP",
	"strategy_id": "a3106cfe-801f-4919-b0d7-d785dc5b47f9"
}

Respuesta

Tabla 3 Descripción de parámetro

Parámetro

Tipo

Descripción

id

String

ID de configuración de limitación de solicitud excluida

strategy_id

String

Solicitar ID de política de limitación

instance_id

Integer

ID de objeto excluido

instance_name

String

Nombre de una aplicación o un inquilino al que se aplica la configuración de limitación de solicitudes excluidas

instance_type

Integer

Tipo del objeto excluido

call_limits

Integer

Número máximo de veces que el objeto excluido puede acceder a una API dentro del período de limitación

apply_time

Timestamp

Hora en la que se crea la configuración de limitación de solicitud excluida

app_id

String

ID de la aplicación a la que se aplica la configuración de limitación de solicitud excluida

app_name

String

Nombre de la aplicación a la que se aplica la configuración de limitación de solicitud excluida

Ejemplo de respuesta:

{
  "id": "778879b8-df10-495b-a087-874859fdea6d",
  "strategy_id": "a3106cfe-801f-4919-b0d7-d785dc5b47f9",
  "instance_id": "98efd77d-10b5-4eca-8170-ed30a4a286a4",
  "instance_name": "app_002",
  "instance_type": "APP",
  "call_limits": 150,
  "apply_time": "2017-12-29T03: 11: 18.2698381Z",
  "app_id": "98efd77d-10b5-4eca-8170-ed30a4a286a4",
  "app_name": "app_002"
}

Códigos de estado

Tabla 4 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