Solución de errores comunes de implementación de Azure
En este artículo se describe cómo solucionar problemas de errores comunes de implementación de Azure y se proporciona información sobre las soluciones. Los recursos de Azure se pueden implementar con archivos Bicep o plantillas de Azure Resource Manager (plantillas de ARM). Si no encuentra el código del error de implementación, consulte Búsqueda de códigos de error.
Si no aparece el código de error, envíe una incidencia de GitHub. En el lado derecho de la página, seleccione Comentarios. En la parte inferior de la página, en Comentarios, seleccione Esta página. Proporcione sus comentarios sobre la documentación, pero no incluya información confidencial porque GitHub problemas son públicos.
Códigos de error
| Código de error | Mitigación | Más información |
|---|---|---|
| AccountNameInvalid | Siga las instrucciones de nomenclatura de las cuentas de almacenamiento. | Resolución de errores de nombres de cuenta de almacenamiento |
| AccountPropertyCannotBeSet | Consulte las propiedades disponibles para la cuenta de almacenamiento. | storageAccounts |
| AllocationFailed | El clúster o la región no tienen recursos disponibles o no admiten el tamaño de máquina virtual solicitado. Vuelva a realizar la solicitud más adelante o solicite otro tamaño de máquina virtual. | Problemas de aprovisionamiento y asignación de Linux Problemas de aprovisionamiento y asignación de Windows Solución de problemas de asignación |
| AnotherOperationInProgress | Espere a que la operación simultánea finalice. | |
| AuthorizationFailed | La cuenta o entidad de servicio no dispone de acceso suficiente para completar la implementación. Compruebe el rol al que la cuenta pertenece y su acceso para el ámbito de implementación. Puede recibir este error cuando un proveedor de recursos necesario no está registrado. |
Control de acceso basado en roles de Azure (Azure RBAC) Resolución de registros |
| BadRequest | Envió valores de implementación que no coinciden con los que Resource Manager esperaba. Compruebe el mensaje de estado interno para obtener ayuda para solucionar el problema. Valide la sintaxis de la plantilla para resolver los errores de implementación al usar una plantilla que se exportó desde un recurso de Azure existente. |
Referencia de plantilla Ubicación del recurso en la plantilla de ARM Ubicación del recurso en un archivo Bicep Resolución de plantilla no válida |
| Conflicto | Se solicita una operación no permitida con el estado actual del recurso. Por ejemplo, solo se permite el cambio de tamaño del disco al crear una VM o al desasignar la VM. | |
| DeploymentActiveAndUneditable | Espere a que la implementación simultánea de este grupo de recursos finalice. | |
| DeploymentFailedCleanUp | Al implementar en modo completo, se eliminará cualquier recurso que no esté en la plantilla. Obtendrá este error si no tiene los permisos adecuados para eliminar todos los recursos que no están en la plantilla. Para evitar el error, cambie el modo de implementación a incremental. | Modos de implementación de Azure Resource Manager |
| DeploymentNameInvalidCharacters | El nombre de implementación solo puede contener letras, dígitos, guiones (-), puntos (.) o caracteres de subrayado (_). |
|
| DeploymentNameLengthLimitExceeded | Los nombres de implementación se limitan a 64 caracteres. | |
| DeploymentFailed | El error DeploymentFailed es un error general que no proporciona la información necesaria para resolverlo. Mire en los detalles del error si hay un código de error que proporcione más información. | Búsqueda de códigos de error |
| DeploymentQuotaExceeded | Si se alcanza el límite de 800 implementaciones por grupo de recursos, elimine las implementaciones que ya no necesite del historial. | Resolución de error cuando el recuento de implementaciones es superior a 800 |
| DeploymentJobSizeExceeded | Simplifique la plantilla para reducir el tamaño. | Resolución de errores de tamaño de plantilla |
| DnsRecordInUse | El nombre del registro de DNS debe ser único. Escribe otro nombre. | |
| ImageNotFound | Compruebe la configuración de la imagen de máquina virtual. | |
| InaccessibleImage | Se produce un error en la implementación de la instancia de Azure Container Instances. Es posible que tenga que incluir la etiqueta de la imagen con la sintaxis registry/image:tag para implementar el contenedor. En el caso de un registro privado, compruebe que las credenciales son correctas. |
Búsqueda de códigos de error |
| InternalServerError | Causado por un problema temporal. Vuelva a intentar la implementación. | |
| InUseSubnetCannotBeDeleted | Este error puede producirse al intentar actualizar un recurso, si el proceso de solicitud elimina y crea el recurso. Asegúrese de especificar todos los valores sin cambios. | Actualización de recursos |
| InvalidAuthenticationTokenTenant | Obtenga el token de acceso para el inquilino adecuado. Solo puede obtener el token del inquilino al que pertenece su cuenta. | |
| InvalidContentLink | Probablemente ha tratado de agregar un vínculo a una plantilla anidada que no está disponible. Compruebe el URI proporcionado para la plantilla anidada. Si la plantilla se encuentra en una cuenta de almacenamiento, asegúrese de que puede accederse al URI. Debe pasar un token de SAS. Actualmente, no se puede agregar un vínculo a una plantilla que se encuentre en una cuenta de almacenamiento detrás de un firewall de Azure Storage. De todos modos, tiene la posibilidad de mover la plantilla a otro repositorio, como GitHub. | Plantillas de ARM vinculadas y anidadas Módulos de Bicep |
| InvalidDeploymentLocation | Al realizar la implementación en el nivel de suscripción, ha proporcionado una ubicación diferente para un nombre de implementación usado previamente. | Implementación de una suscripción con una plantilla de ARM Implementación de una suscripción con Bicep |
| InvalidParameter | Uno de los valores proporcionados para un recurso no coincide con el valor esperado. Este error puede deberse a muchas condiciones diferentes. Por ejemplo, una contraseña puede ser insuficiente o un nombre de blob puede ser incorrecto. El mensaje de error debe indicar qué valor debe corregirse. | Parámetros de la plantilla de ARM Parámetros de Bicep |
| InvalidRequestContent | Los valores de implementación incluyen valores que no se reconocen o valores requeridos que faltan. Confirme los valores para el tipo de recurso. | Referencia de plantilla |
| InvalidRequestFormat | Habilite el registro de depuración cuando se ejecute la implementación y compruebe el contenido de la solicitud. | Registro de depuración |
| InvalidResourceLocation | Proporcione un nombre único para la cuenta de almacenamiento. | Resolución de errores de nombres de cuenta de almacenamiento |
| InvalidResourceNamespace | Compruebe el espacio de nombres del recurso especificado en la propiedad type. | Referencia de plantilla |
| InvalidResourceReference | El recurso aún no existe o se hace referencia a él de forma incorrecta. Compruebe si tiene que agregar una dependencia. Compruebe que el uso de la función reference incluye los parámetros necesarios para su escenario. | Resolución de dependencias |
| InvalidResourceType | Compruebe el tipo de recurso especificado en la propiedad type. | Referencia de plantilla |
| InvalidSubscriptionRegistrationState | Registre la suscripción con el proveedor de recursos. | Resolución de registros |
| InvalidTemplateDeployment InvalidTemplate |
Compruebe la sintaxis de la plantilla en busca de errores. | Resolución de plantilla no válida |
| InvalidTemplateCircularDependency | Quite las dependencias innecesarias. | Resolver dependencias circulares |
| JobSizeExceeded | Simplifique la plantilla para reducir el tamaño. | Resolución de errores de tamaño de plantilla |
| LinkedAuthorizationFailed | Compruebe si la cuenta pertenece al mismo inquilino que el grupo de recursos en que está realizando la implementación. | |
| LinkedInvalidPropertyId | No se ha resuelto el identificador de un recurso. Compruebe que ha proporcionado todos los valores necesarios para el identificador de recurso. Por ejemplo, el identificador de suscripción, el nombre del grupo de recursos, el tipo de recurso, el nombre del recurso primario (si es necesario) y el nombre del recurso. | Resolución de errores de coincidencia entre el nombre y el tipo del recurso |
| LocationRequired | Proporcione una ubicación para el recurso. | Ubicación del recurso en la plantilla de ARM Ubicación del recurso en un archivo Bicep |
| MismatchingResourceSegments | Asegúrese de que el recurso anidado tiene el número correcto de segmentos de nombre y tipo. | Resolver los segmentos de recursos |
| MissingRegistrationForLocation | Compruebe el estado de registro del proveedor de recursos y las ubicaciones admitidas. | Resolución de registros |
| MissingSubscriptionRegistration | Registre la suscripción con el proveedor de recursos. | Resolución de registros |
| NoRegisteredProviderFound | Compruebe el estado de registro del proveedor de recursos. | Resolución de registros |
| NotFound | Puede que esté intentando implementar un recurso dependiente en paralelo con un recurso principal. Compruebe si tiene que agregar una dependencia. | Resolución de dependencias |
| OperationNotAllowed | Puede haber varios motivos por los que aparece este mensaje de error. 1. La implementación está intentando realizar una operación que no está permitida en el SKU especificado. 2. La implementación trata de realizar una operación que excede la cuota de la suscripción, del grupo de recursos o de la región. Si es posible, revise la implementación para respetar las cuotas. De lo contrario, considere la posibilidad de solicitar un cambio de las cuotas. |
Resolución de cuotas |
| OperationNotAllowedOnVMImageAsVMsBeingProvisioned | Es posible que esté intentando eliminar una imagen que se está usando ahora mismo para aprovisionar máquinas virtuales. No se puede eliminar una imagen que esté usando ninguna máquina virtual durante el proceso de implementación. Vuelva a intentar la operación de eliminación de imágenes una vez completada la implementación de la máquina virtual. | |
| ParentResourceNotFound | Asegúrese de que existe un recurso principal antes de crear los recursos secundarios. | Resolución del recurso principal |
| PasswordTooLong | Puede que haya seleccionado una contraseña con demasiados caracteres, o que haya convertido el valor de contraseña en una cadena segura antes de pasarlo como parámetro. Si la plantilla incluye un parámetro de cadena segura, no es necesario convertir el valor en una cadena segura. Proporcione el valor de contraseña como texto. | |
| PrivateIPAddressInReservedRange | La dirección IP especificada incluye un intervalo de direcciones requerido por Azure. Cambie la dirección IP para evitar el intervalo reservado. | Direcciones IP privadas |
| PrivateIPAddressNotInSubnet | La dirección IP especificada está fuera del intervalo de subred. Cambie la dirección IP para que esté dentro del intervalo de subred. | Direcciones IP privadas |
| PropertyChangeNotAllowed | Algunas propiedades no se pueden cambiar en un recurso implementado. Al actualizar un recurso, limite los cambios a las propiedades permitidas. | Actualización de recursos |
| PublicIPCountLimitReached | Ha alcanzado el límite para el número de IPs públicas en ejecución. Apague los recursos innecesarios o póngase en contacto con el soporte técnico de Azure para solicitar un aumento. Por ejemplo, en Azure Databricks, consulte Finalización inesperada del clúster y Límite de direcciones IP impide la creación del clúster. | Límites de dirección IP pública |
| RegionDoesNotAllowProvisioning | Seleccione una región diferente o envíe una solicitud de soporte técnico de cuota para el acceso a la región. | |
| RequestDisallowedByPolicy | La suscripción incluye una directiva de recursos que impide una acción que intenta realizar durante la implementación. Busque la directiva que bloquea la acción. Si es posible, cambie la implementación para cumplir con las limitaciones de la directiva. | Resolución de directivas |
| ReservedResourceName | Proporcione un nombre de recurso que no incluya un nombre reservado. | Nombres de recurso reservados |
| ResourceGroupBeingDeleted | Espere a que la eliminación finalice. | |
| ResourceGroupNotFound | Compruebe el nombre del grupo de recursos de destino para la implementación. El grupo de recursos de destino ya debe existir en la suscripción. Compruebe el contexto de la suscripción. | CLI de AzurePowerShell |
| ResourceNotFound | La implementación hace referencia a un recurso que no se puede resolver. Compruebe que el uso de la función reference incluye los parámetros necesarios para su escenario. | Resolución de referencias |
| ResourceQuotaExceeded | La implementación trata de crear recursos que exceden la cuota de la suscripción, del grupo de recursos o de la región. Si es posible, revise la infraestructura para respetar las cuotas. De lo contrario, considere la posibilidad de solicitar un cambio de las cuotas. | Resolución de cuotas |
| SkuNotAvailable | Seleccione la SKU (como el tamaño de la máquina virtual) que está disponible para la ubicación seleccionada. | Resolución de SKU |
| StorageAccountAlreadyTaken StorageAccountAlreadyExists |
Proporcione un nombre único para la cuenta de almacenamiento. | Resolución de errores de nombres de cuenta de almacenamiento |
| StorageAccountInAnotherResourceGroup | Proporcione un nombre único para la cuenta de almacenamiento. | Resolución de errores de nombres de cuenta de almacenamiento |
| StorageAccountNotFound | Compruebe la suscripción, el grupo de recursos y el nombre de la cuenta de almacenamiento que intenta utilizar. | |
| SubnetsNotInSameVnet | Una máquina virtual solo puede tener una red virtual. Al implementar varias NIC, asegúrese de que pertenecen a la misma red virtual. | Máquinas virtuales Windows con varias NIC Máquinas virtuales Linux con varias NIC |
| SubnetIsFull | No hay suficientes direcciones disponibles en la subred para implementar recursos. Puede liberar direcciones de la subred, usar una subred o crear una nueva subred. | Preguntas más frecuentes sobre la administración de subredes y redes virtuales Direcciones IP privadas |
| SubscriptionNotFound | No se puede acceder a una suscripción especificada para la implementación. Podría deberse a que el identificador de la suscripción sea incorrecto, a que el usuario que implemente la plantilla carezca de los permisos adecuados para implementar en la suscripción o a que el identificador de la suscripción tenga un formato incorrecto. Al usar implementaciones anidadas de plantillas de ARM para implementar en distintos ámbitos, proporcione el GUID de la suscripción. | Implementación de plantillas de ARM en varios ámbitos Implementación de archivos Bicep en varios ámbitos |
| SubscriptionNotRegistered | Al implementar un recurso se debe registrar el proveedor de recursos de la suscripción. Cuando se usa una plantilla de Azure Resource Manager para la implementación, el proveedor de recursos se registra automáticamente en la suscripción. A veces, el registro automático no se completa a tiempo. Para evitar este error intermitente, registre el proveedor de recursos antes de la implementación. | Resolución de registros |
| SubscriptionRequestsThrottled | Azure Resource Manager limita las solicitudes en el nivel de suscripción o en el nivel de inquilino. Los proveedores de recursos como Microsoft.Compute también limitan las solicitudes específicas de sus operaciones. Cuando se alcanza un límite, se obtiene un mensaje y un valor con la cantidad de tiempo que deberá esperar antes de enviar una nueva solicitud. Por ejemplo: Number of requests for subscription '<subscription-id-guid>' and operation '<resource provider>' exceeded the backend storage limit. Please try again after '6' seconds. Una respuesta HTTP devuelve un mensaje como HTTP status code 429 Too Many Requests con un valor Retry-After que especifica el número de segundos que se deberá esperar antes de enviar otra solicitud. |
Limitación de solicitudes de Resource Manager Solución de errores de limitación de API: máquinas virtuales Limitación de Azure Kubernetes Service |
| TemplateResourceCircularDependency | Quite las dependencias innecesarias. | Resolver dependencias circulares |
| TooManyTargetResourceGroups | Reduzca el número de grupos de recursos de una sola implementación. | Implementación de plantillas de ARM en varios ámbitos Implementación de archivos Bicep en varios ámbitos |
Pasos siguientes
- Para obtener información sobre los errores de validación o implementación, vea Buscar códigos de error.
- Para obtener más detalles sobre cómo solucionar problemas de una implementación, consulte Habilitación del registro de depuración.
- Para aislar la causa de un error de implementación, consulte Creación de una plantilla de resolución de problemas.