你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

了解 Azure 资源管理器如何限制请求

本文介绍 Azure 资源管理器如何限制请求。 介绍了如何在达到限制之前跟踪剩余的请求数,以及在达到限制时如何应对。

限制在两个级别发生。 Azure 资源管理器限制对订阅和租户的请求。 如果请求低于订阅和租户的限制,资源管理器会将该请求路由到资源提供程序。 资源提供程序应用针对该订阅和租户的操作专门指定的限制。

下图显示了在请求从用户转到 Azure 资源管理器和资源提供程序时如何应用限制。 此图显示,最初会在发送请求的用户所在的区域中按主体 ID 和 Azure 资源管理器实例对请求进行限制。 每小时的请求数会受限制。 将请求转发到资源提供程序时,将按资源区域(而不是按用户区域中的 Azure 资源管理器实例)对请求进行限制。 也会按主体用户 ID 和小时对资源提供程序请求进行限制。

示意图显示了将请求从用户发送到 Azure 资源管理器和资源提供程序时应用限制的方式。

订阅和租户限制

每个订阅级别和租户级别的操作都会受到限制。 订阅请求是需要传递订阅 ID 的请求,例如在订阅中检索资源组。 例如,向 https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups?api-version=2022-01-01 发送请求是订阅级操作。 租户请求(例如,检索有效的 Azure 位置)不包括订阅 ID。 例如,向 https://management.azure.com/tenants?api-version=2022-01-01 中发送请求则是租户级操作。

下表显示了每小时的默认限制。

范围 操作 限制
订阅 reads 12000
订阅 删除 15000
订阅 Writes 1200
租户 reads 12000
租户 Writes 1200

这些限制的范围局限于发出请求的安全主体(用户或应用程序)以及订阅 ID 或租户 ID。 如果请求来自多个安全主体,则对订阅或租户的限制高于每小时 12,000 个和 1,200 个。

这些限制适用于每个 Azure 资源管理器实例。 每个 Azure 区域中有多个实例,Azure 资源管理器将部署到所有 Azure 区域。 因此,实践中的限制要高于这些限制。 来自用户的请求通常由不同的 Azure 资源管理器实例进行处理。

其余请求在响应头值中返回。

迁移到区域限制和令牌存储桶算法

从 2024 年开始,Microsoft 会将 Azure 订阅迁移到新的限制体系结构。 通过此更改,你将遇到新的限制。 新的限制将按区域,而不是按 Azure 资源管理器实例应用。 新体系结构使用令牌存储桶算法来管理 API 限制。

令牌存储桶表示每秒可以发送的最大请求数。 达到最大请求数后,重新填充速率决定了令牌在存储桶中变为可用状态的速度。

通过这些更新后的限制,可以更轻松地刷新和管理配额。

新限制为:

范围 Operations 存储桶大小 每秒重新填充速率
订阅 reads 250 25
订阅 删除数 200 10
订阅 Writes 200 10
租户 reads 250 25
租户 删除数 200 10
租户 Writes 200 10

订阅限制将会按订阅、服务主体和操作类型应用。 对于每个运营类型,还存在相当于单个服务主体限制 15 倍的全局订阅限制。 全局限制适用于所有服务主体。 如果超出全局、服务主体或特定于租户的限制,则将限制请求。

免费或试用客户的限制可能更小。

例如,假设你的存储桶大小为 250 个读取请求令牌,而重新填充速率为每秒 25 个令牌。 如果每秒发送 250 个读取请求,则存储桶将会清空,并且会限制请求。 在存储桶达到其最大容量 250 个令牌之前,每秒将有 25 个令牌可用。 可以在令牌可用时使用令牌。

如何知道我的订阅是否使用新的限制体验?

将订阅迁移到新的限制体验后,响应标头会显示每分钟(而不是每小时)的剩余请求数。 此外,Retry-After 值会显示一分钟或更少,而不是五分钟。 有关详细信息,请参阅错误代码

为什么限制更改为按区域而不是按实例?

由于不同区域具有不同的资源管理器实例数,因此按实例限制会导致限制性能不一致。 按区域限制可保持限制处于一致状态且可以预测。

新的限制体验如何影响我的限制?

可以发送更多请求。 写入请求增加 30 倍。 删除请求增加 2.4 倍。 读取请求增加 7.5 倍。

是否可以阻止我的订阅迁移到新的限制体验?

否,最终将迁移所有订阅。

资源提供程序限制

资源提供程序应用自身的限制。 在每个订阅中,资源提供程序会按区域限制请求中的资源。 由于资源管理器受资源管理器实例的限制,并且每个区域中有多个资源管理器实例,因此资源提供程序收到的请求数可能会超过上一部分的默认限制。

本部分讨论某些广泛使用的资源提供程序的限制。

存储限制

仅当使用 Azure 资源管理器对 Azure 存储执行管理操作时,以下限制才适用。 这些限制按区域适用于请求中的资源。

资源 限制
存储帐户管理操作数(读取) 每 5 分钟 800 次
存储帐户管理操作数(写入) 每秒 10 次/每小时 1200 次
存储帐户管理操作数(列出) 每 5 分钟 100 次

网络限制

Microsoft.Network 资源提供程序应用以下限制:

Operation 限制
写入/删除 (PUT) 每 5 分钟 1000 次
读取 (GET) 每 5 分钟 10000 次

除了这些常规限制外,以下限制也适用于 DNS 操作:

DNS 区域操作 限制(每区域)
创建或更新 每分钟 40 个
Delete 每分钟 40 个
Get 每分钟 1000 个
列出 每分钟 60 个
按资源组列表 每分钟 60 个
更新 每分钟 40 个
DNS 记录集操作 限制(每区域)
创建或更新 每分钟 200 个
删除 每分钟 200 个
获取 每分钟 2000 个
按 DNS 区域列出 每分钟 60 个
按类型列出 每分钟 60 个
更新 每分钟 200 个

计算限制

有关计算操作的限制的信息,请参阅排查 API 限制错误 - 计算

若要检查虚拟机规模集中的虚拟机实例,请使用虚拟机规模集操作。 例如,使用虚拟机规模集 VM - 列出和相应的参数来检查虚拟机实例的电源状态。 此 API 可减少请求数。

Azure Resource Graph 限制

Azure Resource Graph 会限制对其操作发出的请求数。 本文所述的用于确定剩余请求数以及在达到限制时如何采取应对措施的步骤同样适用于 Resource Graph。 但是,Resource Graph 设置了自身的限制和重置速率。 有关详细信息,请参阅 Resource Graph 限制标头

其他资源提供程序

有关其他资源提供程序中的限制的信息,请参阅:

错误代码

达到限制时,会收到 HTTP 状态代码“429 请求过多”。 响应包含 Retry-After 值,该值指定在发送下一个请求之前应用程序应该等待(或休眠)的秒数。 如果在重试值用尽之前发送请求,将不会处理该请求,并会返回一个新的重试值。

如果使用的是 Azure SDK,该 SDK 可能会采用自动重试配置。 有关详细信息,请参阅 Azure 服务的重试指南

某些资源提供程序返回 429 来报告暂时性问题。 该问题可能是一种过载状态,它不是由你的请求直接造成的。 或者,它可能表示目标资源或依赖资源的状态相关的暂时性错误。 例如,当目标资源被另一个操作锁定时,网络资源提供程序将返回 429 和 RetryableErrorDueToAnotherOperation 错误代码。 若要确定错误是由限制还是暂时性的状况造成,请查看响应中的错误详细信息。

剩余的请求数

可以通过检查响应标头来确定剩余的请求数。 读取请求在标头中返回一个值,表示剩余读取请求的数目。 写入请求包含的值表示剩余写入请求的数目。 下表描述了可在其中检查这些值的标头:

响应标头 说明
x-ms-ratelimit-remaining-subscription-deletes 划归到订阅的剩余删除数。 执行删除操作时返回此值。
x-ms-ratelimit-remaining-subscription-reads 划归到订阅的剩余读取数。 执行读取操作时返回此值。
x-ms-ratelimit-remaining-subscription-writes 划归到订阅的剩余写入数。 执行写入操作时返回此值。
x-ms-ratelimit-remaining-tenant-reads 划归到租户的剩余读取数
x-ms-ratelimit-remaining-tenant-writes 划归到租户的剩余写入数
x-ms-ratelimit-remaining-subscription-resource-requests 划归到订阅的剩余资源类型请求数。

仅当服务替代了默认限制时,才返回此标头值。 Resource Manager 将累加此值而不是订阅读取/写入数。
x-ms-ratelimit-remaining-subscription-resource-entities-read 划归到订阅的剩余资源类型集合请求数。

仅当服务替代了默认限制时,才返回此标头值。 此值提供剩余集合请求数(列出资源)。
x-ms-ratelimit-remaining-tenant-resource-requests 划归到租户的剩余资源类型请求数。

仅在租户级别,且仅当服务替代了默认限制时,为请求添加此标头。 Resource Manager 将累加此值而不是租户读取/写入数。
x-ms-ratelimit-remaining-tenant-resource-entities-read 划归到租户的剩余资源类型集合请求数。

仅在租户级别,且仅当服务替代了默认限制时,为请求添加此标头。

资源提供程序还可以返回包含剩余请求数相关信息的响应标头。 有关“计算”资源提供程序返回的响应标头的信息,请参阅调用速率参考性响应标头

检索标头值

检索代码或脚本中的这些标头值与检索任何标头值没有什么不同。

例如,在 C# 中,可使用以下代码从名为 responseHttpWebResponse 对象中检索标头值:

response.Headers.GetValues("x-ms-ratelimit-remaining-subscription-reads").GetValue(0)

PowerShell 中,可以从 Invoke-WebRequest 操作检索标头值。

$r = Invoke-WebRequest -Uri https://management.azure.com/subscriptions/{guid}/resourcegroups?api-version=2016-09-01 -Method GET -Headers $authHeaders
$r.Headers["x-ms-ratelimit-remaining-subscription-reads"]

有关完整 PowerShell 示例的信息,请参阅检查订阅的资源管理器限制

若要查看剩余请求数以进行调试,可在 PowerShell cmdlet 中提供 -Debug 参数。

Get-AzResourceGroup -Debug

这会返回许多值,包括以下响应值:

DEBUG: ============================ HTTP RESPONSE ============================

Status Code:
OK

Headers:
Pragma                        : no-cache
x-ms-ratelimit-remaining-subscription-reads: 11999

若要获取写入限制,请使用写入操作:

New-AzResourceGroup -Name myresourcegroup -Location westus -Debug

这会返回许多值,包括以下值:

DEBUG: ============================ HTTP RESPONSE ============================

Status Code:
Created

Headers:
Pragma                        : no-cache
x-ms-ratelimit-remaining-subscription-writes: 1199

Azure CLI 中,可以使用更详细的选项检索标头值。

az group list --verbose --debug

这会返回许多值,包括以下值:

msrest.http_logger : Response status: 200
msrest.http_logger : Response headers:
msrest.http_logger :     'Cache-Control': 'no-cache'
msrest.http_logger :     'Pragma': 'no-cache'
msrest.http_logger :     'Content-Type': 'application/json; charset=utf-8'
msrest.http_logger :     'Content-Encoding': 'gzip'
msrest.http_logger :     'Expires': '-1'
msrest.http_logger :     'Vary': 'Accept-Encoding'
msrest.http_logger :     'x-ms-ratelimit-remaining-subscription-reads': '11998'

若要获取写入限制,请使用写入操作:

az group create -n myresourcegroup --location westus --verbose --debug

这会返回许多值,包括以下值:

msrest.http_logger : Response status: 201
msrest.http_logger : Response headers:
msrest.http_logger :     'Cache-Control': 'no-cache'
msrest.http_logger :     'Pragma': 'no-cache'
msrest.http_logger :     'Content-Length': '163'
msrest.http_logger :     'Content-Type': 'application/json; charset=utf-8'
msrest.http_logger :     'Expires': '-1'
msrest.http_logger :     'x-ms-ratelimit-remaining-subscription-writes': '1199'

后续步骤