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

排查常见的 Azure 部署错误

本文介绍如何排查常见的 Azure 部署错误,并提供有关解决方案的信息。 可以使用 Bicep 文件或 Azure 资源管理器模板(ARM 模板)部署 Azure 资源。 如果找不到部署错误的错误代码,请参阅查找错误代码

如果未列出错误代码,请提交 GitHub 问题。 在页面右侧选择“反馈”。 在页面底部的“反馈”下,选择“此页”。 提供文档反馈,但不要包含机密信息,因为 GitHub 问题是公开的。

错误代码

错误代码 缓解措施 详细信息
AccountNameInvalid 遵循存储帐户的命名规则。 解决存储帐户名称错误
AccountPropertyCannotBeSet 查看可用的存储帐户属性。 storageAccounts
AllocationFailed 群集或区域没有可用的资源或无法支持所请求的 VM 大小。 稍后重试请求,或者请求不同的 VM 大小。 Linux 预配和分配问题

Windows 预配和分配问题

排查分配失败
AnotherOperationInProgress 等待并发操作完成。
AuthorizationFailed 帐户或服务主体没有足够的访问权限,无法完成部署。 请检查帐户所属的角色,及其与部署范围相对应的访问权限。

所需的资源提供程序未注册时,可能会收到此错误。
Azure 基于角色的访问控制 (Azure RBAC)

解决注册问题
BadRequest 发送的部署值与资源管理器预期的值不匹配。 请检查内部状态消息,获取故障排除帮助。

验证模板的语法,以解决使用从现有 Azure 资源导出的模板时出现的部署错误。
模板参考

ARM 模板中的资源位置

Bicep 文件中的资源位置

解决模板无效的问题
Conflict 在资源的当前状态下不允许所请求的操作。 例如,仅当创建 VM 或该 VM 已取消分配时,才允许磁盘重设大小。
DeploymentActiveAndUneditable 等待目标为此资源组的并发部署完成。
DeploymentFailedCleanUp 在完整模式下部署时,模板中不存在的任何资源都将被删除。 当没有足够的权限删除模板中所有不存在的资源时,会出现此错误。 若要避免此错误,请将部署模式更改为“增量”。 Azure 资源管理器部署模式
DeploymentNameInvalidCharacters 部署名称只能包含字母、数字、连字符 (-)、点 (.) 或下划线 (_)
DeploymentNameLengthLimitExceeded 部署名称限制为 64 个字符。
DeploymentFailed DeploymentFailed 错误为常规错误,未提供解决错误所需的详细信息。 请查看错误代码的错误详情,其中提供了详细信息。 查找错误代码
DeploymentQuotaExceeded 如果达到每个资源组的部署数限制 800,则会从历史记录中删除不再需要的部署。 解决部署计数超出 800 的错误
DeploymentJobSizeExceeded 简化模板以减小大小。 解决模板大小错误
DnsRecordInUse DNS 记录名称必须唯一。 输入不同的名称。
ImageNotFound 检查 VM 映像设置。
InaccessibleImage Azure 容器实例部署失败。 你可能需要使用用于部署容器的语法 registry/image:tag 来包含映像的标记。 对于专用注册表,请验证你的凭据是否正确。 查找错误代码
InternalServerError 由临时问题引起。 重试部署。
InUseSubnetCannotBeDeleted 当你尝试更新资源时,如果请求进程删除并创建了资源,则可能会发生此错误。 请确保指定所有未更改的值。 更新资源
InvalidAuthenticationTokenTenant 获取相应租户的访问令牌。 只能从帐户所属的租户获取该令牌。
InvalidContentLink 很可能尝试过链接到不可用的嵌套模板。 请仔细检查提供给嵌套模板的 URI。 如果模板在存储帐户中存在,请确保 URI 可访问。 可能需要传递 SAS 令牌。 目前,无法链接到位于 Azure 存储防火墙后面的存储帐户中的模板。 考虑将模板移到其他存储库,如 GitHub。 链接的和嵌套的 ARM 模板

Bicep 模块
InvalidDeploymentLocation 在订阅级别部署时,你为以前使用的部署名称提供了不同的位置。 ARM 模板订阅部署

Bicep 订阅部署
InvalidParameter 为资源提供的某个值与预期值不匹配。 许多不同的条件可能会导致此错误。 例如,密码可能不符合要求,或者 blob 名称可能不正确。 错误消息应表明哪个值需要更正。 ARM 模板参数

Bicep 参数
InvalidRequestContent 部署值包含无法识别的值,或者缺少必需的值。 确认资源类型的值。 模板参考
InvalidRequestFormat 在运行部署时启用调试日志记录功能,并验证请求的内容。 调试日志记录
InvalidResourceLocation 为存储帐户提供唯一名称。 解决存储帐户名称错误
InvalidResourceNamespace 检查在 type 属性中指定的资源命名空间。 模板参考
InvalidResourceReference 资源尚不存在,或错误地引用了它。 请检查是否需要添加依赖项, 并验证所使用的 reference 函数是否包括方案所需的参数。 解决依赖项问题
InvalidResourceType 检查在 type 属性中指定的资源类型。 模板参考
InvalidSubscriptionRegistrationState 向资源提供程序注册订阅。 解决注册问题
InvalidTemplateDeployment
InvalidTemplate
检查模板语法是否存在错误。 解决模板无效的问题
InvalidTemplateCircularDependency 删除不必要的依赖项。 解决循环依赖项
JobSizeExceeded 简化模板以减小大小。 解决模板大小错误
LinkedAuthorizationFailed 检查帐户所属的租户是否与要部署到的资源组所属的租户相同。
LinkedInvalidPropertyId 无法解析资源的资源 ID。 检查是否为资源 ID 提供了所有必需值。 例如,订阅 ID、资源组名称、资源类型、父资源名称(如果需要)和资源名称。 解决资源名称和类型的错误
LocationRequired 提供资源的位置。 ARM 模板中的资源位置

Bicep 文件中的资源位置
MismatchingResourceSegments 请确保嵌套资源的名称和类型中包含正确数量的段。 解决资源段
MissingRegistrationForLocation 检查资源提供程序注册状态,以及支持的位置。 解决注册问题
MissingSubscriptionRegistration 向资源提供程序注册订阅。 解决注册问题
NoRegisteredProviderFound 检查资源提供程序注册状态。 解决注册问题
NotFound 你可能在尝试部署与父资源并行的依赖资源。 请检查是否需要添加依赖项。 解决依赖项问题
OperationNotAllowed 出现此错误消息可能有多种原因。

1. 部署正在尝试执行一个指定 SKU 上不允许的操作。

2. 部署正在尝试执行一个超过了订阅、资源组或区域配额的操作。 请尽可能修改部署,使之保持在配额范围内。 否则,请考虑请求更改配额。
解决配额问题
OperationNotAllowedOnVMImageAsVMsBeingProvisioned 你可能正在尝试删除当前用于预配 VM 的映像。 在部署过程中,不能删除任何虚拟机正在使用的映像。 在 VM 部署完成后重试映像删除操作。
ParentResourceNotFound 确保在创建子资源之前存在父资源。 解决父资源问题
PasswordTooLong 你可能选择了包含太多字符的密码,或在将密码值作为参数传递之前将其转换成了一个安全字符串。 如果模板包括一个安全字符串参数,则不需要将值转换为安全字符串。 请以文本形式提供密码值。
PrivateIPAddressInReservedRange 指定的 IP 地址包括 Azure 所需的地址范围。 请更改 IP 地址,避免使用保留的范围。 专用 IP 地址
PrivateIPAddressNotInSubnet 指定的 IP 地址位于子网范围之外。 请更改 IP 地址,使之位于子网范围之内。 专用 IP 地址
PropertyChangeNotAllowed 已部署资源上的某些属性不能更改。 更新资源时,请仅更改允许的属性。 更新资源
PublicIPCountLimitReached 已达到运行公共 IP 数的限制。 关闭不需要的资源,或联系 Azure 支持部门以请求增加资源。 例如,在 Azure Databricks,请参阅意外的群集终止IP 地址限制阻止群集创建 公共 IP 地址限制
RegionDoesNotAllowProvisioning 选择不同的区域,或提交有关“区域访问权限”的配额支持请求。
RequestDisallowedByPolicy 订阅包含阻止尝试在部署期间执行的操作的资源策略。 请找出阻止该操作的策略。 如果可能,请更改部署,使之符合策略的限制。 解决策略问题
ReservedResourceName 提供不包含保留名称的资源名称。 保留的资源名称
ResourceGroupBeingDeleted 等待删除操作完成。
ResourceGroupNotFound 检查部署的目标资源组的名称。 目标资源组必须已存在于订阅中。 请检查订阅上下文。 Azure CLIPowerShell
ResourceNotFound 部署引用了一个无法解析的资源。 请验证所使用的 reference 函数是否包括方案所需的参数。 解决引用问题
ResourceQuotaExceeded 部署尝试创建的资源超过了订阅、资源组或区域的配额。 请尽可能修改基础结构,使之保持在配额范围内。 否则,请考虑请求更改配额。 解决配额问题
SkuNotAvailable 选择可在所选位置中使用的 SKU(例如 VM 大小)。 解决 SKU 问题
StorageAccountAlreadyTaken
StorageAccountAlreadyExists
为存储帐户提供唯一名称。 解决存储帐户名称错误
StorageAccountInAnotherResourceGroup 为存储帐户提供唯一名称。 解决存储帐户名称错误
StorageAccountNotFound 检查尝试使用的存储帐户的订阅、资源组和名称。
SubnetsNotInSameVnet 一个虚拟机只能有一个虚拟网络。 部署多个 NIC 时,请确保它们属于同一虚拟网络。 Windows VM 多 NIC

Linux VM 多 NIC
SubnetIsFull 子网中没有足够的可用地址,无法部署资源。 可以从子网中释放地址,使用其他子网,或者创建一个新子网。 管理子网虚拟网络常见问题解答

专用 IP 地址
SubscriptionNotFound 无法访问用于部署的指定订阅。 有可能是订阅 ID 错误,部署模板的用户没有足够的权限部署到订阅,或者订阅 ID 格式错误。 使用 ARM 模板嵌套部署进行跨范围部署时,请提供订阅的 GUID。 ARM 模板跨范围部署

Bicep 文件跨范围部署
SubscriptionNotRegistered 在部署了资源后,必须为订阅注册资源提供程序。 使用 Azure 资源管理器模板进行部署时,会在订阅中自动注册资源提供程序。 有时,自动注册未及时完成。 若要避免此间歇性错误,请在部署前注册资源提供程序。 解决注册问题
SubscriptionRequestsThrottled Azure 资源管理器在订阅级别或租户级别限制请求。 资源提供程序(如 Microsoft.Compute)还会限制特定于其操作的请求。

达到限制时,你会收到一条消息和在发送新请求之前应等待的时间值。 例如: Number of requests for subscription '<subscription-id-guid>' and operation '<resource provider>' exceeded the backend storage limit. Please try again after '6' seconds.

HTTP 响应返回类似 HTTP status code 429 Too Many Requests 的消息,其中包含一个 Retry-After 值,该值指定了在发送另一个请求之前要等待的秒数。
限制 Resource Manager 请求

排查 API 限制错误 - 虚拟机

Azure Kubernetes 服务限制
TemplateResourceCircularDependency 删除不必要的依赖项。 解决循环依赖项
TooManyTargetResourceGroups 减少单个部署的资源组数。 ARM 模板跨范围部署

Bicep 文件跨范围部署

后续步骤