x-apigateway-ratelimits.policy
Meaning: Definition of a request throttling policy.
Scope of effect: x-apigateway-ratelimits
Example:
x-apigateway-ratelimits:customRatelimitName:api-limit: 200app-limit: 200user-limit: 200ip-limit: 200interval: 1unit: MINUTEshared: falsespecial:- type: USERlimit: 100instance: xxxxxxx
Parameter | Mandatory | Type | Description |
---|---|---|---|
api-limit | Yes | Number | Maximum number of times an API can be called. |
user-limit | No | Number | Maximum number of times the API can be called by a user. |
app-limit | No | Number | Maximum number of times the API can be called by an app. |
ip-limit | No | Number | Maximum number of times the API can be called by an IP address. |
interval | Yes | Number | Throttling period. |
unit | Yes | String | Throttling unit, which can be SECOND, MINUTE, HOUR, or DAY. |
shared | No | Boolean | Whether to share the throttling limits among APIs. |
special | No | Array | Special request throttling policy. |
Parent topic: API Design File Extension Definitions