Compartir a través de

az blueprint artifact template

  • Cambio importante

Note

Esta referencia forma parte de la extensión de plano técnico para la CLI de Azure (versión 2.50.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az blueprint artifact template. Obtenga más información sobre las extensiones.

Los planos técnicos y los comandos asociados quedarán en desuso a principios de julio de 2026. Se recomienda a los clientes que realicen la transición a las especificaciones de plantilla y a las pilas de implementaciones para admitir sus escenarios más allá de esa fecha. La documentación de migración está disponible en https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Este grupo de comandos está en desuso implícitamente porque el grupo de comandos "az blueprint" está en desuso y se quitará en una versión futura.

Comandos para administrar el artefacto de plantilla de ARM del plano técnico.

Comandos

Nombre Description Tipo Estado
az blueprint artifact template create

Cree un artefacto de arm de plano técnico.

 Extension GA
az blueprint artifact template update

Actualice el artefacto del arm del plano técnico.

 Extension GA

az blueprint artifact template create

Cambio importante

Los planos técnicos y los comandos asociados quedarán en desuso a principios de julio de 2026. Se recomienda a los clientes que realicen la transición a las especificaciones de plantilla y a las pilas de implementaciones para admitir sus escenarios más allá de esa fecha. La documentación de migración está disponible en https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Este comando está en desuso implícitamente porque el grupo de comandos "az blueprint" está en desuso y se quitará en una versión futura.

Cree un artefacto de arm de plano técnico.

az blueprint artifact template create --artifact-name
                                      --blueprint-name
                                      --template
                                      [--depends-on]
                                      [--description]
                                      [--display-name]
                                      [--management-group]
                                      [--parameters]
                                      [--resource-group-art]
                                      [--subscription]

Ejemplos

Creación de un artefacto de arm

az blueprint artifact template create \
--blueprint-name MyBlueprint --artifact-name MyTemplate \
--parameters path/to/parameter/file --template path/to/template

Parámetros requeridos

--artifact-name

Nombre del artefacto del plano técnico.

--blueprint-name

Nombre de la definición del plano técnico.

--template -t

Plantilla de ARM en cadena JSON o ruta de acceso al archivo JSON.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--depends-on

Artefactos que deben implementarse antes del artefacto especificado.

--description

Descripción del artefacto del plano técnico.

--display-name

DisplayName de este artefacto.

--management-group -m

Use el grupo de administración para el ámbito del plano técnico.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--parameters -p

Parámetros para el artefacto de plantilla de ARM. Puede ser una cadena JSON o una ruta de acceso del archivo JSON.

--resource-group-art

Nombre del artefacto del grupo de recursos al que se asignará la directiva.

--subscription -s

Use la suscripción para el ámbito del plano técnico. Si no se especifica --management-group, el valor --subscription o la suscripción predeterminada se usarán como ámbito.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az blueprint artifact template update

Cambio importante

Los planos técnicos y los comandos asociados quedarán en desuso a principios de julio de 2026. Se recomienda a los clientes que realicen la transición a las especificaciones de plantilla y a las pilas de implementaciones para admitir sus escenarios más allá de esa fecha. La documentación de migración está disponible en https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/migrate-blueprint. Este comando está en desuso implícitamente porque el grupo de comandos "az blueprint" está en desuso y se quitará en una versión futura.

Actualice el artefacto del arm del plano técnico.

az blueprint artifact template update --artifact-name
                                      --blueprint-name
                                      [--depends-on]
                                      [--description]
                                      [--display-name]
                                      [--management-group]
                                      [--parameters]
                                      [--resource-group-art]
                                      [--subscription]
                                      [--template]

Ejemplos

Actualización de un artefacto de arm

az blueprint artifact template update \
--blueprint-name MyBlueprint --artifact-name MyTemplate --display-name "My Template"

Parámetros requeridos

--artifact-name

Nombre del artefacto del plano técnico.

--blueprint-name

Nombre de la definición del plano técnico.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--depends-on

Artefactos que deben implementarse antes del artefacto especificado. Use "--depends-on" sin valores para quitar dependencias.

--description

Descripción del artefacto del plano técnico.

--display-name

DisplayName de este artefacto.

--management-group -m

Use el grupo de administración para el ámbito del plano técnico.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--parameters -p

Parámetros para el artefacto de plantilla de ARM. Puede ser una cadena JSON o una ruta de acceso del archivo JSON.

--resource-group-art

Nombre del artefacto del grupo de recursos al que se asignará la directiva.

--subscription -s

Use la suscripción para el ámbito del plano técnico. Si no se especifica --management-group, el valor --subscription o la suscripción predeterminada se usarán como ámbito.

Propiedad Valor
Grupo de parámetros: Resource_scope Arguments
--template -t

Plantilla de ARM en cadena JSON o ruta de acceso al archivo JSON.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False