Compartir vía


Solución de problemas de errores con instancias de Azure Blueprint

Importante

El 11 de julio de 2026, Blueprints (versión preliminar) quedará en desuso. Migre las definiciones y asignaciones de planos técnicos existentes a Especificaciones de plantilla y Pilas de implementación. Los artefactos de plano técnico se convertirán en plantillas JSON de ARM o archivos de Bicep que se usan para definir pilas de implementación. Para obtener información sobre cómo crear un artefacto como un recurso de ARM, consulte:

Es posible que, al crear, asignar o quitar planos técnicos, se tropiece con errores. En este artículo se describen diversos errores que pueden producirse y cómo resolverlos.

Búsqueda de detalles del error

Muchos errores serán el resultado de asignar un plano técnico a un ámbito. Cuando se produce un error en una asignación, el plano técnico proporciona detalles sobre la implementación errónea. Esta información indica el problema, de modo que se pueda corregir y la siguiente implementación se realice correctamente.

  1. Seleccione Todos los servicios en el panel izquierdo. Busque y seleccione Planos técnicos.

  2. En la página de la izquierda seleccione Planos técnicos asignados y use el cuadro de búsqueda para filtrar las asignaciones de plano técnico a fin de encontrar las asignaciones con error. También puede ordenar la tabla de asignaciones por la columna Estado de aprovisionamiento para ver todas las asignaciones con error agrupadas conjuntamente.

  3. Seleccione el plano técnico con el estado Error o haga clic con el botón derecho y seleccione Ver los detalles de la asignación.

  4. En la parte superior de la página de asignación de planos técnicos, un banner rojo de advertencia indica que la asignación dio un error. Seleccione cualquier lugar del banner para obtener más detalles.

Es habitual que el error se deba a un artefacto y no al plano técnico en su conjunto. Si un artefacto crea un almacén de claves y Azure Policy impide la creación, se producirá un error en toda la asignación.

Errores generales

Escenario: Infracción de la directiva

Problema

Se produjo un error en la implementación de la plantilla debido a la infracción de la directiva.

Causa

Una directiva puede entrar en conflicto con la implementación por los motivos siguientes:

  • El recurso que se crea está restringido por la directiva (normalmente restricciones de SKU o ubicación)
  • La implementación establece campos que están configurados por la directiva (normalmente con etiquetas)

Solución

Cambie el plano técnico para que no entre en conflicto con las directivas en los detalles del error. Si este cambio no es posible, una opción alternativa es hacer que el ámbito de la asignación de directivas cambie para que el plano técnico deje de estar en conflicto con la directiva.

Escenario: El parámetro de plano técnico es una función

Problema

Los parámetros de plano técnico que son funciones se procesan antes de que se pasen a los artefactos.

Causa

Pasar un parámetro de plano técnico que usa una función, como [resourceGroup().tags.myTag], a un artefacto genera el resultado procesado de la función que se va a establecer en el artefacto, en lugar de la función dinámica.

Solución

Para pasar una función como parámetro, escape la cadena completa con [, de modo que el parámetro de plano técnico sea similar a [[resourceGroup().tags.myTag]. El carácter de escape hace que los planos técnicos traten el valor como una cadena al procesar el plano técnico. El servicio de planos técnicos luego coloca la función en el artefacto para que pueda ser dinámico, según lo previsto. Para obtener más información, consulte Sintaxis y expresiones de las plantillas de Azure Resource Manager.

Eliminación de errores

Escenario: Tiempo de espera de eliminación de asignaciones

Problema

No se ha completado la eliminación de una asignación de plano técnico.

Causa

Una asignación de plano técnico puede quedar atrapada en un estado no terminal cuando se elimina. Este estado se produce cuando los recursos creados por la asignación de plano técnico todavía están pendientes de eliminación o no devuelven un código de estado a Azure Blueprints.

Solución

Las asignaciones de plano técnico en un estado no terminal se marcan automáticamente como Error después de un tiempo de espera de seis horas. Una vez que el tiempo de espera ha ajustado el estado de la asignación de plano técnico, se puede volver a intentar la eliminación.

Pasos siguientes

Si su problema no aparece o es incapaz de resolverlo, visite uno de nuestros canales para obtener ayuda adicional:

  • Obtenga respuestas de expertos de Azure en los foros de Azure.
  • Póngase en contacto con @AzureSupport, la cuenta oficial de Microsoft Azure para mejorar la experiencia del cliente, al dirigir a la comunidad de Azure a los recursos adecuados: respuestas, soporte técnico y expertos.
  • Si necesita más ayuda, puede registrar un incidente de soporte técnico de Azure. Vaya al sitio de Soporte técnico de Azure y seleccione Obtener soporte.