Устранение стандартных ошибок развертывания Azure
Эта статья описывает устранение неполадок при распространенных ошибках развертывания Azure и предоставляет сведения о решениях. Ресурсы Azure можно развернуть с помощью файлов Bicep или шаблонов Azure Resource Manager (ARM). Если не удается найти код ошибки развертывания, ознакомьтесь с разделом Поиск кода ошибки.
Если вашего кода ошибки нет в списке, откройте вопрос на GitHub. В правой части страницы выберите Отзывы. В нижней части страницы в области Отзывы выберите Эта страница. Предоставьте сведения о документации, но не включайте конфиденциальную информацию, так как проблемы на GitHub являются общедоступными.
Коды ошибок
| Код ошибки | Меры по снижению риска | Дополнительные сведения |
|---|---|---|
| AccountNameInvalid | Следуйте рекомендациям в отношении имен учетных записей хранения. | Устранение ошибок имен учетной записи хранения |
| AccountPropertyCannotBeSet | Проверьте доступные свойства учетной записи хранения. | storageAccounts |
| AllocationFailed | Кластер или регион не имеют доступных ресурсов или не поддерживают запрашиваемый размер виртуальной машины. Повторите запрос позже или укажите другой размер виртуальной машины. | Проблемы подготовки и распределения в Linux Проблемы подготовки и распределения в Windows Устранение неполадок выделения ресурсов |
| AnotherOperationInProgress | Дождитесь завершения параллельной операции. | |
| AuthorizationFailed | Учетная запись или субъект-служба не имеют необходимых прав доступа для выполнения развертывания. Проверьте роль, к которой принадлежит учетная запись, и ее права доступа к области развертывания. Эта ошибка может возникнуть, если не зарегистрирован требуемый поставщик ресурсов. |
Управление доступом Azure на основе ролей (Azure RBAC) Устранение ошибок регистрации |
| BadRequest | Отправленные значения развертывания не соответствуют значениям, ожидаемым Resource Manager. Проверьте внутреннее сообщение о состоянии. Оно поможет вам в устранении неполадки. Проверьте синтаксис шаблона, чтобы устранить ошибки развертывания при использовании шаблона, экспортированного из существующего ресурса Azure. |
Справочник по шаблонам Расположение ресурса в шаблоне ARM Расположение ресурса в файле Bicep Устранение ошибок, связанных с недопустимым шаблоном |
| Conflict | Запрашиваемая операция не разрешена в текущем состоянии ресурса. Например, изменение размера диска разрешено только при создании или освобождении виртуальной машины. | |
| 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 | Проверьте состояние регистрации поставщика ресурсов. | Устранение ошибок регистрации |
| NotFound | Возможно, вы пытаетесь развернуть зависимый ресурс параллельно с родительским ресурсом. Проверьте, не нужно ли добавить зависимость. | Устранение ошибок, связанных с зависимостями |
| OperationNotAllowed | Это сообщение об ошибке может быть вызвано несколькими причинами. 1. Развертывание пытается выполнить операцию, которая не разрешена для SKU spcecified. 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 в различных областях |
Дальнейшие действия
- Сведения об ошибках проверки или развертывания см. в статье Поиск кодов ошибок.
- Дополнительные сведения об устранении неполадок при развертывании см. в статье Включение ведения журнала отладки.
- Чтобы изолировать причину ошибки развертывания, воспользуйтесь статьей Создание шаблона для устранения неполадок.