Service Rate Limit Buckets
A Bucket defines the limit that should be enforced against the key it is associated with. A Rate Limit can have multiple buckets so that you can detect and stop attacks at different velocities.
必要なもの:
If you are just getting started with Rate Limits in Verify we recommend checking out our guide on Using Verify Service Rate Limits to Protect Your Application before diving into the API.
Bucket properties
| Resource Properties in REST API format | |
|---|---|
sid
|
A 34 character string that uniquely identifies this Bucket. |
rate_limit_sid
|
The Twilio-provided string that uniquely identifies the Rate Limit resource. |
service_sid
|
The SID of the Service the resource is associated with. |
account_sid
|
The SID of the Account that created the Rate Limit resource. |
max
|
Maximum number of requests permitted in during the interval. |
interval
|
Number of seconds that the rate limit will be enforced over. |
date_created
|
The date and time in GMT when the resource was created specified in RFC 2822 format. |
date_updated
|
The date and time in GMT when the resource was last updated specified in RFC 2822 format. |
url
|
The URL of this resource. |
Create a Bucket
https://verify.twilio.com/v2/Services/{ServiceSid}/RateLimits/{RateLimitSid}/Buckets
パラメーター
| Parameters in REST API format | |
|---|---|
service_sid
Path
|
The SID of the Service the resource is associated with. |
rate_limit_sid
Path
|
The Twilio-provided string that uniquely identifies the Rate Limit resource. |
max
必須
|
Maximum number of requests permitted in during the interval. |
interval
必須
|
Number of seconds that the rate limit will be enforced over. |
例 1
Fetch a Bucket
https://verify.twilio.com/v2/Services/{ServiceSid}/RateLimits/{RateLimitSid}/Buckets/{Sid}
パラメーター
| Parameters in REST API format | |
|---|---|
service_sid
Path
|
The SID of the Service the resource is associated with. |
rate_limit_sid
Path
|
The Twilio-provided string that uniquely identifies the Rate Limit resource. |
sid
Path
|
A 34 character string that uniquely identifies this Bucket. |
例 1
List all Buckets
https://verify.twilio.com/v2/Services/{ServiceSid}/RateLimits/{RateLimitSid}/Buckets
パラメーター
| Parameters in REST API format | |
|---|---|
service_sid
Path
|
The SID of the Service the resource is associated with. |
rate_limit_sid
Path
|
The Twilio-provided string that uniquely identifies the Rate Limit resource. |
例 1
Update a Bucket
https://verify.twilio.com/v2/Services/{ServiceSid}/RateLimits/{RateLimitSid}/Buckets/{Sid}
パラメーター
| Parameters in REST API format | |
|---|---|
service_sid
Path
|
The SID of the Service the resource is associated with. |
rate_limit_sid
Path
|
The Twilio-provided string that uniquely identifies the Rate Limit resource. |
sid
Path
|
A 34 character string that uniquely identifies this Bucket. |
max
オプション
|
Maximum number of requests permitted in during the interval. |
interval
オプション
|
Number of seconds that the rate limit will be enforced over. |
例 1
Delete a Bucket
https://verify.twilio.com/v2/Services/{ServiceSid}/RateLimits/{RateLimitSid}/Buckets/{Sid}
パラメーター
| Parameters in REST API format | |
|---|---|
service_sid
Path
|
The SID of the Service the resource is associated with. |
rate_limit_sid
Path
|
The Twilio-provided string that uniquely identifies the Rate Limit resource. |
sid
Path
|
A 34 character string that uniquely identifies this Bucket. |
例 1
ヘルプが必要ですか？
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.