云 API API 频率限制说明

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

相关产品
云 API 产品页,含版本规格、价格与购买入口。

一、查看接口的频率限制

大部分产品的 API 频率限制信息已在其 API 文档的 API 概览中给出。以云服务器为例,可通过 云服务器 > API 概览 查看相关接口的频率限制值。

人脸识别(iai)产品由于业务形态等原因采用了接口组的频率限制策略,具体可参考文档 接口组并发限制。

二、频率限制的维度

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 服务的请求均会受到频率限制。包括但不限于:

·SDK/HTTP 调用。

·腾讯云控制台。

·腾讯云开发者工具:命令行工具、API Explorer、CloudShell 等。

四、提高接口的频率限制

当接口默认频率限制不满足业务实际需求时,你可以 提交工单 申请提高限频。我们将综合系统资源、稳定性等因素全面评估申请,评估通过后将会为你调整限频。

赞 (0)
上一篇 4天前
下一篇 4天前