Поделиться через


Устранение стандартных ошибок развертывания Azure

Эта статья описывает устранение неполадок при распространенных ошибках развертывания Azure и предоставляет сведения о решениях. Ресурсы Azure можно развернуть с помощью файлов Bicep или шаблонов Azure Resource Manager (ARM). Если не удается найти код ошибки развертывания, ознакомьтесь с разделом Поиск кода ошибки.

Если вашего кода ошибки нет в списке, сообщите о проблеме в GitHub. В правой части страницы выберите Отзывы. В нижней части страницы в области Отзывы выберите Эта страница. Предоставьте сведения о документации, но не включайте конфиденциальную информацию, так как проблемы на GitHub являются общедоступными.

Коды ошибок

Код ошибки Исправление Дополнительные сведения
AccountNameInvalid Следуйте рекомендациям в отношении имен учетных записей хранения. Устранение ошибок для имен учетных записей хранения
AccountPropertyCannotBeSet Проверьте доступные свойства учетной записи хранения. Справочник по шаблонам Microsoft.Storage/storageAccounts
AllocationFailed Кластер или регион не имеют доступных ресурсов или не поддерживают запрашиваемый размер виртуальной машины. Повторите запрос позже или укажите другой размер виртуальной машины. Проблемы подготовки и распределения в Linux

Проблемы подготовки и распределения в Windows

Устранение неполадок выделения ресурсов
AnotherOperationInProgress Дождитесь завершения параллельной операции.
AuthorizationFailed Учетная запись или субъект-служба не имеют необходимых прав доступа для выполнения развертывания. Проверьте роль, к которой принадлежит учетная запись, и ее права доступа к области развертывания.

Эта ошибка может возникнуть, если не зарегистрирован требуемый поставщик ресурсов.
Управление доступом на основе ролей в Azure (Azure RBAC).

Устранение ошибок регистрации
BadRequest Отправленные значения развертывания не соответствуют значениям, ожидаемым Resource Manager. Проверьте внутреннее сообщение о состоянии. Оно поможет вам в устранении неполадки.

Проверьте синтаксис шаблона, чтобы устранить ошибки развертывания при использовании шаблона, экспортированного из существующего ресурса Azure.
Справочник по шаблонам

Расположение ресурса в шаблоне ARM

Расположение ресурса в файле Bicep

Устранение ошибок, связанных с недопустимым шаблоном
Конфликт Запрашиваемая операция не разрешена в текущем состоянии ресурса. Например, изменение размера диска разрешено только при создании или освобождении виртуальной машины.
DeploymentActiveAndUneditable Дождитесь завершения параллельного развертывания в эту группу ресурсов.
DeploymentFailedCleanUp При развертывании в полном режиме все ресурсы вне шаблона будут удалены. Эта ошибка возникает, если у вас нет необходимых разрешений для удаления всех ресурсов вне шаблона. Чтобы избежать этой ошибки, измените режим развертывания на добавочный. Режимы развертывания Azure Resource Manager
DeploymentNameInvalidCharacters Имя развертывания может содержать только буквы, цифры, дефис (-), точку (.) или символ подчеркивания (_).
DeploymentNameLengthLimitExceeded Длина имен развертывания ограничена 64 символами.
DeploymentFailed Ошибка DeploymentFailed является общей ошибкой, которая не содержит сведений, необходимых для ее устранения. Найдите в сведениях об ошибке ее код, с помощью которого можно получить дополнительные сведения. Поиск кода ошибки
DeploymentQuotaExceeded Если вы достигли предела в 800 развертываний на группу ресурсов, удалите из журнала те развертывания, которые больше не нужны. Устранение ошибки, возникающей, когда число развертываний превышает 800
DeploymentJobSizeExceeded Упростите шаблон, чтобы уменьшить размер. Устранение ошибок c размером шаблона
DnsRecordInUse Имя записи DNS должно быть уникальным. Введите другое имя.
ImageNotFound Проверьте параметры образа виртуальной машины.
InaccessibleImage Развертывание экземпляра контейнера Azure завершается сбоем. Для развертывания контейнера может потребоваться добавить тег образа с синтаксисом registry/image:tag. Для частного реестра проверьте правильность учетных данных. Поиск кода ошибки
InternalServerError Вызвана временной проблемой. Повторите попытку развертывания.
InUseSubnetCannotBeDeleted Эта ошибка может возникнуть при попытке изменения ресурс, если процесс запроса удаляет и создает этот ресурс. Укажите все неизменяемые значения. Обновление ресурса
InvalidAuthenticationTokenTenant Получите маркер доступа для соответствующего клиента. Маркер можно получить только из клиента, которому принадлежит учетная запись.
InvalidContentLink Скорее всего, была предпринята попытка связать недоступный вложенный шаблон. Внимательно проверьте URI, указанный для вложенного шаблона. Если шаблон существует в учетной записи хранения, убедитесь, что URI доступен. Возможно, понадобится передать маркер SAS. В настоящее время привязаться к шаблону в учетной записи хранения, которая находится за брандмауэром службы хранилища Azure. Попробуйте переместить шаблон в другой репозиторий, например GitHub. Связанные и вложенные шаблоны ARM

Модули Bicep
InvalidDeploymentLocation При развертывании на уровне подписки вы указали другое расположение для ранее использованного имени развертывания. Развертывание подписки с помощью шаблонов ARM

Развертывание подписки с помощью Bicep
InvalidParameter Одно из значений, предоставленных для ресурса, не соответствует ожидаемому значению. Эта ошибка может возникнуть в результате многих различных состояний. Например, пароля может быть недостаточно или имя большого двоичного объекта может быть неверным. В сообщении об ошибке должно быть указано значение, которое необходимо исправить. Параметры шаблона ARM

Параметры Bicep
InvalidRequestContent Среди значений развертывания есть нераспознанные значения, либо отсутствуют обязательные значения. Проверьте значения для типа ресурса. Справочник по шаблонам
InvalidRequestFormat Включите ведение журнала отладки при выполнении развертывания и проверьте содержимое запроса. Ведение журнала отладки
InvalidResourceLocation Предоставьте уникальное имя учетной записи хранения. Устранение ошибок для имен учетных записей хранения
InvalidResourceNamespace Проверьте пространство имен ресурсов, заданное в свойстве type. Справочник по шаблонам
InvalidResourceReference Ресурс не существует, или на него неверно ссылаются. Проверьте, следует ли добавить зависимость. Убедитесь, что для функции reference указаны параметры, необходимые для вашего сценария. Устранение ошибок, связанных с зависимостями
InvalidResourceType Проверьте тип ресурсов, заданный в свойстве type. Справочник по шаблонам
InvalidSubscriptionRegistrationState Зарегистрируйте подписку в поставщике ресурсов. Устранение ошибок регистрации
InvalidTemplateDeployment
InvalidTemplate
Проверьте синтаксис шаблона на наличие ошибок. Устранение ошибок, связанных с недопустимым шаблоном
InvalidTemplateCircularDependency Удалите ненужные зависимости. Устранение циклических зависимостей
JobSizeExceeded Упростите шаблон, чтобы уменьшить размер. Устранение ошибок c размером шаблона
LinkedAuthorizationFailed Проверьте, принадлежит ли учетная запись тому же клиенту, что и группа ресурсов, в которую выполняется развертывание.
LinkedInvalidPropertyId Идентификатор ресурса не разрешен. Убедитесь, что вы указали все необходимые значения для идентификатора ресурса. Например, идентификатор подписки, имя группы ресурсов, тип ресурса, имя родительского ресурса (при необходимости) и имя ресурса. Устранение ошибок имени и типа ресурса
LocationRequired Укажите расположение ресурса. Расположение ресурса в шаблоне ARM

Расположение ресурса в файле Bicep
MismatchingResourceSegments Убедитесь, что имя и тип вложенного ресурса содержат правильное количество сегментов. Разрешение сегментов ресурса
MissingRegistrationForLocation Проверьте состояние регистрации поставщика ресурсов и поддерживаемые расположения. Устранение ошибок регистрации
MissingSubscriptionRegistration Зарегистрируйте подписку в поставщике ресурсов. Устранение ошибок регистрации
NoRegisteredProviderFound Проверьте состояние регистрации поставщика ресурсов. Устранение ошибок регистрации
Не найдено Возможно, вы пытаетесь развернуть зависимый ресурс параллельно с родительским ресурсом. Проверьте, не нужно ли добавить зависимость. Устранение ошибок, связанных с зависимостями
OperationNotAllowed Это сообщение об ошибке может быть вызвано несколькими причинами.

1. Развертывание пытается выполнить операцию, которая не разрешена для указанного номера SKU.

2. Развертывание пытается выполнить операцию, превышающую квоту для подписки, группы ресурсов или региона. Если это возможно, измените развертывание, чтобы не превышать квоты. В противном случае запросите изменение квот.
Устранение ошибок квот ресурсов
OperationNotAllowedOnVMImageAsVMsBeingProvisioned Возможно, вы пытаетесь удалить образ, который в настоящее время используется для подготовки виртуальных машин. Невозможно удалить образ, используемый любой виртуальной машиной во время процесса развертывания. Повторите операцию удаления образа после завершения развертывания виртуальной машины.
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 CLI PowerShell
ResourceNotFound Развертывание ссылается на ресурс, который не может быть разрешен. Убедитесь, что для функции reference указаны параметры, необходимые для вашего сценария. Устранение ошибок с поиском ресурсов
ResourceQuotaExceeded Развертывание пытается создать ресурсы, которые превышают квоту для подписки, группы ресурсов или региона. Если возможно, измените инфраструктуру, чтобы не превышать квоты. В противном случае запросите изменение квот. Устранение ошибок квот ресурсов
SkuNotAvailable Выберите номер SKU (например, размер виртуальной машины), который доступен в выбранном расположении. Устранение ошибок, связанных с недоступностью номера SKU
StorageAccountAlreadyTaken
StorageAccountAlreadyExists
Предоставьте уникальное имя учетной записи хранения. Устранение ошибок для имен учетных записей хранения
StorageAccountInAnotherResourceGroup Предоставьте уникальное имя учетной записи хранения. Устранение ошибок для имен учетных записей хранения
StorageAccountNotFound Проверьте подписку, группу ресурсов и имя учетной записи хранения, которые вы хотите использовать.
SubnetsNotInSameVnet Виртуальная машина может иметь только одну виртуальную сеть. При развертывании нескольких сетевых адаптеров убедитесь, что они принадлежат той же виртуальной сети. Несколько сетевых карт виртуальной машины Windows

Несколько сетевых карт виртуальной машины Linux
SubnetIsFull В подсети недостаточно доступных адресов для развертывания ресурсов. Вы можете освободить адреса из подсети, использовать другую подсеть или создать новую подсеть. Управление подсетями и часто задаваемые вопросы по виртуальной сети

частные IP-адреса.
SubscriptionNotFound Невозможно получить доступ к указанной подписке для развертывания. Возможно, идентификатор подписки неверен, у пользователя, который развертывает шаблон, нет достаточных разрешений для развертывания в подписке, или идентификатор подписки имеет неправильный формат. При использовании вложенных развертываний шаблона ARM для развертывания между областями укажите идентификатор GUID подписки. Развертывание шаблона ARM в различных областях

Развертывание файла Bicep в различных областях
SubscriptionNotRegistered При развертывании ресурса поставщик ресурсов должен быть зарегистрирован для вашей подписки. При использовании шаблона Azure Resource Manager для развертывания поставщик ресурсов автоматически регистрируется в подписке. В некоторых случаях автоматическая регистрация не завершается вовремя. Чтобы избежать этой временной ошибки, зарегистрируйте поставщик ресурсов перед развертыванием. Устранение ошибок регистрации
SubscriptionRequestsThrottled Azure Resource Manager регулирует запросы на уровне подписки или на уровне клиента. Поставщики ресурсов, такие как 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 в различных областях

Следующие шаги