为保障服务的稳定性和公平性，火山引擎云手机对单个用户调用 OpenAPI 的频率进行限制（即 QPS 限制）。当您的调用频率超过预设阈值时，将会触发限流机制。请仔细阅读本文，了解各接口的 QPS 限制、限流机制及最佳实践，合理调用 OpenAPI，以确保您的业务程序能够稳定、高效地运行。 ## 单用户 QPS 限制说明 * **定义**：单用户 QPS 限制指单个火山引擎主账号及其名下所有子账号，每秒调用某个特定 OpenAPI 的总次数上限。该限制由主账号统一计算。 * **示例**：`ListPod` 接口的 QPS 限制为 30 次/秒。若一个主账号和其 4 个子账号同时调用此接口，那么在任意一秒内，这 5 个账号发起的总请求数不能超过 30 次。 * **适用范围**：如无特殊说明，本文档中的 QPS 限制适用于所有地域。 ## 限流机制与错误处理当您的请求频率超过 QPS 限制时，服务端将拒绝该请求并返回错误。 * **错误信息示例**： ```json { "ResponseMetadata": { "RequestId": "20250412113356FC59******D8E376A6FD", "Action": "ListPod", "Version": "2025-05-01", "Service": "ACEP", "Region": "cn-north-1", "Error": { "CodeN": 100027, "Code": "AccountFlowLimitExceeded", "Message": "Request was rejected because the request speed of this openAPI is beyond the current flow control limit." } } } ``` * **处理建议**：您的程序在收到该错误后，不应立即重试。建议采用指数退避（Exponential Backoff）策略进行重试。例如，第一次重试前等待 1 秒，如果依然失败，第二次等待 2 秒，第三次等待 4 秒，以此类推，并设置一个最大等待时间上限。 ## 最佳实践遵循以下建议，可以帮助您更高效地使用 OpenAPI，并避免触发限流： 1. **优先使用批量接口**：查询多个资源时，应优先使用批量接口（如 `ListPod`），而不是在循环中调用单次查询接口（如 `DetailPod`）。 2. **增加本地缓存**：对于不频繁变更的数据，可在您的业务侧增加缓存机制，减少不必要的 API 调用。 3. **合理规划任务**：对于需要大量调用 API 的定时任务，应规划好执行策略，将请求在时间上分散开，避免在同一秒内集中爆发。 ## 提升配额我们提供的默认 QPS 限制能够满足绝大多数业务场景。如果您的业务量确实需要更高的调用频率，您可以通过[提交工单](https://console.volcengine.com/workorder/create?step=2&SubProductID=P00000173)联系我们申请提升配额。请在申请中详细说明您的业务场景、所需接口及期望的 QPS 值。 ## 各接口 QPS 限制详情 ### 实例管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[创建实例 CreatePod](https://www.volcengine.com/docs/6394/2277775) |2025\-05\-01 |50 |\- | |[创建安卓实例并部署应用 CreatePodOneStep](https://www.volcengine.com/docs/6394/2277814) |2025\-05\-01 |50 |\- | |[实例更新 UpdatePod](https://www.volcengine.com/docs/6394/2277370) |2025\-05\-01 |50 |\- | |[实例重置 ResetPod](https://www.volcengine.com/docs/6394/1905410) |2025\-05\-01 |10 |\- | |[查询实例详情 DetailPod](https://www.volcengine.com/docs/6394/1221464) |2023\-10\-30 |200 |\- | |[查询实例列表 ListPod](https://www.volcengine.com/docs/6394/2304643) |2025\-05\-01 |30 |\- | |[实例数据复制迁移 PodDataTransfer](https://www.volcengine.com/docs/6394/1221461) |2023\-10\-30 |5 |\- | |[获取实例应用列表 GetPodAppList](https://www.volcengine.com/docs/6394/1226895) |2023\-10\-30 |200 |10 | |[实例关机 PowerOffPod](https://www.volcengine.com/docs/6394/1189474) |2023\-10\-30 |200 |\- | |[实例开机 PowerOnPod](https://www.volcengine.com/docs/6394/1189475) |2023\-10\-30 |200 |\- | |[暂停/恢复实例推流 PodMute](https://www.volcengine.com/docs/6394/2277382) |2025\-05\-01 |50 |10 | |[实例重启 RebootPod](https://www.volcengine.com/docs/6394/2279963) |2025\-05\-01 |50 |\- | |[打开/关闭实例 ADB PodAdb](https://www.volcengine.com/docs/6394/2279964) |2025\-05\-01 |50 |\- | |[实例停止推流 PodStop](https://www.volcengine.com/docs/6394/2279965) |2025\-05\-01 |50 |10 | |[实例删除 DeletePod](https://www.volcengine.com/docs/6394/2279974) |2025\-05\-01 |50 |\- | |[设置代理服务 SetProxy](https://www.volcengine.com/docs/6394/1340579) |2023\-10\-30 |50 |10 | |[备份实例 BackupPod](https://www.volcengine.com/docs/6394/1398954) |2025\-05\-01 |5 |\- | |[取消备份实例 CancelBackupPod](https://www.volcengine.com/docs/6394/1398955) |2025\-05\-01 |5 |\- | |[还原实例 RestorePod](https://www.volcengine.com/docs/6394/1398957) |2025\-05\-01 |5 |\- | |[取消还原实例 CancelRestorePod](https://www.volcengine.com/docs/6394/1398956) |2025\-05\-01 |5 |\- | |[迁移实例 MigratePod](https://www.volcengine.com/docs/6394/1398958) |2025\-05\-01 |5 |\- | ### 实例属性管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[更新实例属性 UpdatePodProperty](https://www.volcengine.com/docs/6394/1905407) |2025\-05\-01 |50 |\- | |[查询实例属性列表 GetPodProperty](https://www.volcengine.com/docs/6394/1174765) |2023\-10\-30 |50 |\- | |[添加机型库 AddPhoneTemplate](https://www.volcengine.com/docs/6394/1905402) |2025\-05\-01 |50 |\- | |[查询机型库列表 ListPhoneTemplate](https://www.volcengine.com/docs/6394/1905403) |2025\-05\-01 |200 |\- | |[查询机型库 GetPhoneTemplate](https://www.volcengine.com/docs/6394/1905406) |2025\-05\-01 |200 |\- | |[更新机型库 UpdatePhoneTemplate](https://www.volcengine.com/docs/6394/1905405) |2025\-05\-01 |50 |\- | |[删除机型库 RemovePhoneTemplate](https://www.volcengine.com/docs/6394/1905404) |2025\-05\-01 |50 |\- | ### 云机管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[查询云机列表 ListHost](https://www.volcengine.com/docs/6394/1221480) |2023\-10\-30 |50 |\- | |[更新云机 UpdateHost](https://www.volcengine.com/docs/6394/2280228) |2025\-05\-01 |50 |\- | ### 资源管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[查询实例资源列表 ListPodResource](https://www.volcengine.com/docs/6394/1262345) |2023\-10\-30 |200 |\- | |[修改实例订单并发数量 UpdatePodResourceApplyNum](https://www.volcengine.com/docs/6394/2282311) |2025\-05\-01 |50 |\- | |[更新业务存储资源 UpdateProductResource](https://www.volcengine.com/docs/6394/2282312) |2025\-05\-01 |50 |\- | |[实例订购预付费-自动下单 SubscribeResourceAuto](https://www.volcengine.com/docs/6394/2282313) |2025\-05\-01 |50 |\- | |[并发实例自动下单续订 RenewResourceAuto](https://www.volcengine.com/docs/6394/2282492) |2025\-05\-01 |50 |\- | |[查询实例资源组列表 ListPodResourceSet](/docs/6394/1221598) |2023\-10\-30 |30 |\- | |[查询实例规格列表 ListInstanceConfigurationSpec](/docs/6394/1404692) |2023\-10\-30 |50 |\- | ### 屏幕布局管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[删除屏幕布局 DeleteDisplayLayout](https://www.volcengine.com/docs/6394/2283603) |2025\-05\-01 |50 |\- | ### 应用管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[启动应用 LaunchApp](https://www.volcengine.com/docs/6394/1262211) |2023\-10\-30 |50 |10 | |[安装应用 InstallApp](https://www.volcengine.com/docs/6394/1226893) |2023\-10\-30 |50 |10 | |[卸载应用 UninstallApp](https://www.volcengine.com/docs/6394/1262202) |2023\-10\-30 |50 |10 | |[上传应用 UploadApp](https://www.volcengine.com/docs/6394/1262199) |2023\-10\-30 |50 |\- | |[关闭应用 CloseApp](https://www.volcengine.com/docs/6394/1262212) |2023\-10\-30 |50 |10 | |[查询应用信息列表 ListApp](https://www.volcengine.com/docs/6394/1747879) |2025\-05\-01 |30 |\- | |[应用修改 UpdateApp](https://www.volcengine.com/docs/6394/2283605) |2025\-05\-01 |50 |\- | |[应用删除 DeleteApp](https://www.volcengine.com/docs/6394/2283606) |2025\-05\-01 |50 |\- | |[应用版本删除 DeleteAppVersion](https://www.volcengine.com/docs/6394/2283610) |2025\-05\-01 |50 |\- | ### 云手机操控 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[上传文件 PushFile](https://www.volcengine.com/docs/6394/1262356) |2023\-10\-30 |50 |10 | |[异步执行命令 RunCommand](https://www.volcengine.com/docs/6394/1262358) |2023\-10\-30 |50 |10 | |[同步执行命令 RunSyncCommand](https://www.volcengine.com/docs/6394/1262359) |2023\-10\-30 |50 |10 | |[截图 ScreenShot](https://www.volcengine.com/docs/6394/1262354) |2023\-10\-30 |50 |10 | |[批量截图 BatchScreenShot](https://www.volcengine.com/docs/6394/1262214) |2023\-10\-30 |50 |\- | |[实例开始截图 StartScreenShot](https://www.volcengine.com/docs/6394/1753267) |2025\-05\-01 |30 |\- | |[实例停止截图 StopScreenShot](https://www.volcengine.com/docs/6394/1753268) |2025\-05\-01 |30 |\- | |[实例开始录屏 StartRecording](https://www.volcengine.com/docs/6394/1997312) |2025\-05\-01 |200 |\- | |[实例停止录屏 StopRecording](https://www.volcengine.com/docs/6394/1997313) |2025\-05\-01 |200 |\- | |[封禁用户 BanUser](https://www.volcengine.com/docs/6394/2283611) |2025\-05\-01 |50 |\- | |[批量实例截图 BatchScreenShot](https://www.volcengine.com/docs/6394/2279747) |2025\-05\-01 |50 |\- | ### 标签管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[标签更新 UpdateTag](https://www.volcengine.com/docs/6394/2283614) |2025\-05\-01 |50 |\- | |[查询标签列表 ListTag](https://www.volcengine.com/docs/6394/1221497) |2023\-10\-30 |50 |\- | |[标签删除 DeleteTag](https://www.volcengine.com/docs/6394/2283636) |2025\-05\-01 |50 |\- | |[标签绑定 AttachTag](https://www.volcengine.com/docs/6394/2283618) |2025\-05\-01 |50 |\- | ### 任务管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[查询任务详情 GetTaskInfo](https://www.volcengine.com/docs/6394/1262190) |2023\-10\-30 |200 |\- | |[查询任务列表信息 ListTask](/docs/6394/1262192) |2023\-10\-30 |30 |\- | ### 网络配置与管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[查询端口映射列表 ListPortMappingRule](https://www.volcengine.com/docs/6394/1285450) |2023\-10\-30 |50 |\- | |[创建自定义路由规则 AddCustomRoute](https://www.volcengine.com/docs/6394/1651303) |2025\-05\-01 |50 |\- | |[删除自定义路由规则 DeleteCustomRoute](https://www.volcengine.com/docs/6394/1651304) |2025\-05\-01 |50 |\- | |[查询自定义路由规则 ListCustomRoute](https://www.volcengine.com/docs/6394/1651305) |2025\-05\-01 |50 |\- | |[更新自定义路由规则 UpdateCustomRoute](https://www.volcengine.com/docs/6394/1651306) |2025\-05\-01 |50 |\- | |[更新 DNS 规则 UpdateDNSRule](https://www.volcengine.com/docs/6394/2283639) |2025\-05\-01 |50 |\- | |[删除 DNS 规则 DeleteDNSRule](https://www.volcengine.com/docs/6394/2283640) |2025\-05\-01 |50 |\- | |[查询 DNS 规则列表 ListDNSRule](/docs/6394/1351360) |2023\-10\-30 |30 |\- | ### 历史版本 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[【旧版】创建实例 CreatePod](https://www.volcengine.com/docs/6394/1221457) |2023\-10\-30 |50 |\- | |[【旧版】创建实例并部署应用 CreatePodOneStep](https://www.volcengine.com/docs/6394/1221466) |2023\-10\-30 |50 |\- | |[【旧版】更新实例 UpdatePod](https://www.volcengine.com/docs/6394/1222689) |2023\-10\-30 |50 |\- | |[【旧版】实例重置 ResetPod](https://www.volcengine.com/docs/6394/1221459) |2023\-10\-30 |50 |\- | |[【旧版】暂停/恢复实例推流 PodMute](/docs/6394/1262197) |2023\-10\-30 |50 |10 | |[【旧版】重启实例 RebootPod](https://www.volcengine.com/docs/6394/1262198) |2023\-10\-30 |50 |\- | |[【旧版】打开/关闭实例 ADB PodAdb](https://www.volcengine.com/docs/6394/1262210) |2023\-10\-30 |50 |\- | |[【旧版】停止实例推流 PodStop](https://www.volcengine.com/docs/6394/1262209) |2023\-10\-30 |50 |10 | |[【旧版】删除实例 DeletePod](https://www.volcengine.com/docs/6394/1262360) |2023\-10\-30 |50 |\- | |[【旧版】修改实例属性 UpdatePodProperty](https://www.volcengine.com/docs/6394/1221517) |2023\-10\-30 |50 |10 | |[【旧版】开始录屏 StartRecording](/docs/6394/1262355) |2023\-10\-30 |50 |\- | |[【旧版】停止录屏 StopRecording](/docs/6394/1262216) |2023\-10\-30 |50 |\- | |[【旧版】查询云机详情 DetailHost](/docs/6394/1221481) |2023\-10\-30 |50 |\- | |[【旧版】更新云机 UpdateHost](https://www.volcengine.com/docs/6394/1221482) |2023\-10\-30 |50 |\- | |[【旧版】查询镜像信息 ListImage](/docs/6394/1328782) |2023\-10\-30 |30 |\- | |[【旧版】获取机房列表 ListDc](/docs/6394/1221465) |2023\-10\-30 |50 |\- | |[【旧版】查询套餐列表 ListConfiguration](/docs/6394/1262346) |2023\-10\-30 |50 |\- | |[【旧版】更新订购实例数量 UpdatePodResourceApplyNum](https://www.volcengine.com/docs/6394/1262344) |2023\-10\-30 |50 |\- | |[【旧版】查询业务存储资源 GetProductResource](/docs/6394/1262195) |2023\-10\-30 |50 |\- | |[【旧版】自动下单复购资源 SubscribeResourceAuto](https://www.volcengine.com/docs/6394/1222526) |2023\-10\-30 |50 |\- | |[【旧版】批量安装应用 InstallApps](/docs/6394/1226896) |2023\-10\-30 |50 |10 | |[【旧版】查询应用信息 DetailApp](/docs/6394/1226897) |2023\-10\-30 |50 |\- | |[【旧版】修改应用 UpdateApp](https://www.volcengine.com/docs/6394/1262200) |2023\-10\-30 |50 |\- | |[【旧版】自动下载安装应用 AutoInstallApp](/docs/6394/1262196) |2023\-10\-30 |50 |10 | |[【旧版】删除应用 DeleteApp](https://www.volcengine.com/docs/6394/1262201) |2023\-10\-30 |50 |\- | |[【旧版】删除应用版本 DeleteAppVersion](https://www.volcengine.com/docs/6394/1392442) |2023\-10\-30 |50 |\- | |[【旧版】下载文件 PullFile](/docs/6394/1262357) |2023\-10\-30 |50 |10 | |[【旧版】封禁用户 BanUser](https://www.volcengine.com/docs/6394/1262213) |2023\-10\-30 |50 |\- | |[【旧版】删除标签 DeleteTag](https://www.volcengine.com/docs/6394/1262205) |2023\-10\-30 |50 |\- | |[【旧版】实例打标签 AttachTag](https://www.volcengine.com/docs/6394/1262206) |2023\-10\-30 |50 |\- | |[【旧版】更新 DNS 规则 UpdateDNSRule](https://www.volcengine.com/docs/6394/1351361) |2023\-10\-30 |50 |\- | ## 即将生效 QPS 限制的接口 :::warning 以下接口的 QPS 限制将于 **2026 年 3 月 31 日** 正式生效。 ::: ### 实例管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[查询实例资源状态 GetPodMetric](/docs/6394/2189040) |2025\-05\-01 |50 |\- | |[清理用户数据 PodDataDelete](/docs/6394/2189059) |2025\-05\-01 |50 |\- | ### 云机管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[重启云机 RebootHost](/docs/6394/2189049) |2025\-05\-01 |50 |\- | |[重置云机 ResetHost](/docs/6394/2189043) |2025\-05\-01 |50 |\- | ### 镜像管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[查询镜像分布 ListImageResource](/docs/6394/2189051) |2025\-05\-01 |30 |\- | |[查询镜像预热信息 GetImagePreheating](/docs/6394/2189046) |2025\-05\-01 |50 |\- | |[镜像内置应用 CreateImageOneStep](/docs/6394/2189044) |2025\-05\-01 |50 |\- | ### 资源管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[更新业务存储资源 UpdateProductResource](https://www.volcengine.com/docs/6394/1262207) |2023\-10\-30 |50 |\- | |[自动下单续订实例 RenewResourceAuto](/docs/6394/1222527) |2023\-10\-30 |50 |\- | |[退订后付费云机资源 UnsubscribeHostResource](/docs/6394/2189024) |2025\-05\-01 |50 |\- | ### 屏幕布局管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[查询基础版屏幕布局列表 ListDisplayLayoutMini](/docs/6394/1221495) |2023\-10\-30 |30 |\- | |[创建基础版屏幕布局 CreateDisplayLayoutMini](/docs/6394/2189022) |2025\-05\-01 |50 |\- | |[删除屏幕布局 DeleteDisplayLayout](https://www.volcengine.com/docs/6394/1262193) |2023\-10\-30 |50 |\- | ### 应用管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[批量启动应用 LaunchApps](/docs/6394/2189055) |2025\-05\-01 |50 |\- | |[查询应用版本部署信息列表 ListAppVersionDeploy](/docs/6394/1226898) |2023\-10\-30 |30 |\- | |[查询应用崩溃 GetAppCrashLog](/docs/6394/2189025) |2025\-05\-01 |50 |\- | |[删除应用版本 DeleteAppVersion](https://www.volcengine.com/docs/6394/1392442) |2023\-10\-30 |50 |\- | ### 标签管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[创建标签 CreateTag](/docs/6394/2189038) |2025\-05\-01 |50 |\- | |[更新标签 UpdateTag](https://www.volcengine.com/docs/6394/1262204) |2023\-10\-30 |50 |\- | ### 网络配置与管理 |OpenAPI |版本 |单用户 QPS 限制（单位：次/秒） |单实例 QPS 限制（单位：次/秒） | |---|---|---|---| |[创建端口映射规则 CreatePortMappingRule](/docs/6394/2189037) |2025\-05\-01 |50 |\- | |[绑定端口映射规则 BindPortMappingRule](/docs/6394/2189032) |2025\-05\-01 |50 |\- | |[解绑端口映射规则 UnbindPortMappingRule](/docs/6394/2189031) |2025\-05\-01 |50 |\- | |[查询端口映射详情 DetailPortMappingRule](/docs/6394/2189035) |2025\-05\-01 |50 |\- | |[创建 DNS 规则 CreateDNSRule](/docs/6394/2189047) |2025\-05\-01 |50 |\- | |[查询 DNS 规则详情 DetailDNSRule](/docs/6394/2189052) |2025\-05\-01 |50 |\- | |[删除 DNS 规则 DeleteDNSRule](https://www.volcengine.com/docs/6394/1351363) |2023\-10\-30 |50 |\- | |[创建自定义路由规则 AddCustomRoute](/docs/6394/1651303) |2025\-05\-01 |50 |\- | |[删除自定义路由规则 DeleteCustomRoute](/docs/6394/1651304) |2025\-05\-01 |50 |\- | |[查询自定义路由规则 ListCustomRoute](/docs/6394/1651305) |2025\-05\-01 |30 |\- | |[更新自定义路由规则 UpdateCustomRoute](/docs/6394/1651306) |2025\-05\-01 |50 |\- |