文档中心>云 API>开发指南>API 频率限制说明

API 频率限制说明

最近更新时间:2024-08-05 10:14:01

我的收藏
为了保障服务性能和业务稳定,腾讯云 API 会针对不同地域、不同账号发起的 API 请求设置相应的频率限制策略。当响应结果包含 RequestLimitExceeded 错误码时,说明当前请求已超出接口频率限制。此时,可以采用延迟重试等方法来避免限频错误。

查看接口的频率限制

每个 API 的频率限制已列举在产品 API 文档的 API 概览中。以云服务器为例,可通过 云服务器 > API 概览 查看相关接口的频率限制值。

频率限制的维度

API 概览所给出的接口频率限制的维度为 API + 接入地域 + 子账号。各字段说明如下:
字段
说明
API
即请求传入的 Action。取值参考接口文档有关公共参数 Action 的说明。例如云服务器的查询实例列表接口,取值为DescribeInstances
接入地域
请求解析到云 API 服务器的所在地域,非产品或接口实际提供服务的地域。
云 API 支持就近接入,当请求域名未指定地域,例如 Endpoint="cvm.tencentcloudapi.com"。云 API 将根据客户端所在位置,自动解析到最近的地域服务器。
也支持指定地域接入,例如 Endpoint="cvm.ap-guangzhou.tencentcloudapi.com",请求将指定解析到云 API 的广州服务器。
子账号
本次请求所使用的子账号。当使用主账号直接请求时,主账号即为子账号。
举例说明,接口DescribeInstances的默认频率限制20次/秒
当用户使用子账号 A,经云 API 广州服务器发起请求时,每一秒钟的前20次请求都能成功到达业务后端。之后的请求则会因超出频率限制被云 API 拦截。
但当用户在第21次请求使用子账号 B,或者接入地域指定为北京,则因为 “API + 接入地域 + 子账号”构成一个新组合,请求仍能成功到达业务后端。
注意:
限频的时间窗口是以请求到达服务器的时间计算,而不是客户端发出的时间。
API + 接入地域 + 子账号的默认限频策略外,API 请求还会受主账号限频、IP 限频等限频策略作用。API 请求需满足全部的限频策略,云 API 才会放行,使请求能够到达业务后端。当您遇到未触达默认限频阈值但请求仍被限流时,可联系 售后支持 进一步做排查与答疑。

频率限制的作用范围

接入到云 API 服务的请求均会受到频率限制。包括但不限于:
SDK/HTTP 调用。
腾讯云控制台。
腾讯云开发者工具:命令行工具、API Explorer、CloudShell 等。

提高接口的频率限制

当接口默认频率限制不能满足业务实际需求时,您可以 提交工单 申请调高相关接口的限频。