az image builder

Administrar y compilar plantillas de generador de imágenes.

Comandos

Nombre	Description	Tipo	Estado
az image builder cancel	Cancele la compilación de imágenes de larga duración en función de la plantilla de imagen.	Principal	GA
az image builder create	Cree una plantilla de Generador de imágenes.	Principal	GA
az image builder customizer	Administrar personalizadores de plantillas del generador de imágenes.	Principal	GA
az image builder customizer add	Agregue un personalizador de Image Builder a una plantilla de Image Builder.	Principal	GA
az image builder customizer clear	Quite todos los personalizadores de image builder de una plantilla de Image Builder.	Principal	GA
az image builder customizer remove	Quite un personalizador de Image Builder de una plantilla de Image Builder.	Principal	GA
az image builder delete	Elimine la plantilla del generador de imágenes.	Principal	GA
az image builder error-handler	Administrar el controlador de errores de plantilla del generador de imágenes.	Principal	GA
az image builder error-handler add	Agregue el controlador de errores a una plantilla de Generador de imágenes existente.	Principal	GA
az image builder error-handler remove	Quite el controlador de errores de una plantilla de Generador de imágenes existente.	Principal	GA
az image builder error-handler show	Mostrar el controlador de errores de una plantilla existente de Image Builder.	Principal	GA
az image builder identity	Administrar identidades de una plantilla de Image Builder.	Principal	GA
az image builder identity assign	Agregue identidades administradas a una plantilla existente de Image Builder. Actualmente, solo se admite una identidad de usuario.	Principal	GA
az image builder identity remove	Quite las identidades administradas de una plantilla existente de Image Builder.	Principal	GA
az image builder identity show	Mostrar identidades administradas de una plantilla de Image Builder.	Principal	GA
az image builder list	Enumerar plantillas del generador de imágenes.	Principal	GA
az image builder optimizer	Administrar el optimizador de plantillas de Image Builder.	Principal	GA
az image builder optimizer add	Agregue el optimizador a una plantilla existente de Image Builder.	Principal	GA
az image builder optimizer remove	Quite el optimizador de una plantilla existente de Image Builder.	Principal	GA
az image builder optimizer show	Mostrar optimizador de una plantilla existente de Image Builder.	Principal	GA
az image builder optimizer update	Actualice un optimizador a partir de una plantilla existente de Image Builder.	Principal	GA
az image builder output	Administrar distribuidores de salida de plantillas del generador de imágenes.	Principal	GA
az image builder output add	Agregue un distribuidor de salida del generador de imágenes a una plantilla de Image Builder.	Principal	GA
az image builder output clear	Quite todos los distribuidores de salida del generador de imágenes de una plantilla de Image Builder.	Principal	GA
az image builder output remove	Quite un distribuidor de salida de Image Builder de una plantilla de Image Builder.	Principal	GA
az image builder output versioning	Administrar el versionador de salida de la plantilla del generador de imágenes.	Principal	GA
az image builder output versioning remove	Quite todas las opciones de control de versiones en las salidas especificadas.	Principal	GA
az image builder output versioning set	Establezca el versionador de salida del generador de imágenes de una plantilla de Image Builder.	Principal	GA
az image builder output versioning show	Mostrar las opciones de control de versiones en las salidas especificadas.	Principal	GA
az image builder run	Cree una plantilla de generador de imágenes.	Principal	GA
az image builder show	Mostrar una plantilla del generador de imágenes.	Principal	GA
az image builder show-runs	Mostrar las salidas de ejecución de una plantilla de Image Builder.	Principal	GA
az image builder trigger	Administrar el desencadenador de plantilla del generador de imágenes.	Principal	GA
az image builder trigger create	Cree un desencadenador para la plantilla de imagen de máquina virtual especificada.	Principal	GA
az image builder trigger delete	Elimine un desencadenador para la plantilla de imagen de máquina virtual especificada.	Principal	GA
az image builder trigger list	Enumere todos los desencadenadores para el recurso plantilla de imagen especificado.	Principal	GA
az image builder trigger show	Obtenga el desencadenador especificado para el recurso de plantilla de imagen especificado.	Principal	GA
az image builder trigger wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición.	Principal	GA
az image builder update	Actualice una plantilla de Image Builder.	Principal	GA
az image builder validator	Administre la validación de la plantilla del generador de imágenes.	Principal	GA
az image builder validator add	Agregue validate a una plantilla existente de Image Builder.	Principal	GA
az image builder validator remove	Quite validate de una plantilla existente de Image Builder.	Principal	GA
az image builder validator show	Mostrar la validación de una plantilla de Generador de imágenes existente.	Principal	GA
az image builder wait	Coloque la CLI en un estado de espera hasta que se cumpla una condición de la plantilla.	Principal	GA

az image builder cancel

Cancele la compilación de imágenes de larga duración en función de la plantilla de imagen.

az image builder cancel [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Ejemplos

Cancelar una compilación de imagen.

az image builder cancel -n mytemplate -g my-group

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la plantilla de imagen.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az image builder create

Cree una plantilla de Generador de imágenes.

az image builder create --name
                        --resource-group
                        [--build-timeout]
                        [--build-vm-identities]
                        [--checksum]
                        [--defer]
                        [--identity]
                        [--image-source]
                        [--image-template]
                        [--location]
                        [--managed-image-destinations]
                        [--no-wait]
                        [--os-disk-size]
                        [--proxy-vm-size]
                        [--scripts]
                        [--shared-image-destinations]
                        [--staging-resource-group]
                        [--subnet]
                        [--tags]
                        [--validator]
                        [--vm-size]
                        [--vnet]

Ejemplos

Cree una plantilla de generador de imágenes a partir de una imagen de Ubuntu2204. Distribúyalo como una imagen administrada y una versión de imagen de la galería de imágenes compartidas. Especifique el identificador del grupo de recursos de almacenamiento provisional como la plantilla de imagen que se usará para compilar la imagen.

scripts="https://my-script-url.net/customize_script.sh"
imagesource="Canonical:0001-com-ubuntu-server-jammy:22_04-lts-gen2:latest"

az image builder create --image-source $imagesource -n myTemplate -g myGroup \
    --scripts $scripts --managed-image-destinations image_1=westus \
    --shared-image-destinations my_shared_gallery/linux_image_def=westus,brazilsouth \
    --identity myIdentity --staging-resource-group myStagingResourceGroup

Cree una plantilla de Image Builder mediante un archivo de plantilla de imagen.

az image builder create -g my-group -n myTemplate --image-template filename

[Avanzado] Cree una plantilla de imagen con varios personalizadores y distribuidores mediante la caché de objetos de la CLI mediante --defer. Admite características como: personalizador y nombres de salida, códigos de salida de PowerShell, scripts insertados, reinicio de windows, personalizadores de archivos, etiquetas de artefacto y distribuidores de salida de vhd.

script="https://my-script-url.com/customize_script.ps1"
imagesource="MicrosoftWindowsServer:WindowsServer:2019-Datacenter:2019.0.20190214"

# create and update template object in local cli cache. Defers put request to ARM
# Cache object ttl set via az configure.
az image builder create --image-source $imagesource -n myTemplate \
    -g myGroup --scripts $script --identity myIdentity --defer

# add customizers
az image builder customizer add -n myTemplate -g myGroup  \
    --customizer-name myPwshScript --exit-codes 0 1 --inline-script \
    "mkdir c:\buildActions" "echo Azure-Image-Builder-Was-Here \
     > c:\buildActions\Output.txt" --type powershell --defer

az image builder customizer add -n myTemplate -g myGroup \
    --customizer-name myFileCustomizer --type file \
    --file-source "https://my-file-source.net/file.txt"  \
    --dest-path "c:\buildArtifacts\file.txt" --defer

# add distributors
az image builder output add -n myTemplate -g myGroup --is-vhd \
    --output-name myWinImageVhd --artifact-tags "is_vhd=True" --defer

az image builder output add -n myTemplate -g myGroup \
    --output-name myWinImageManaged --managed-image winImage \
    --managed-image-location eastus \
    --artifact-tags "is_vhd=False" --defer

# Stop deferring put request to ARM. Create the template from the object cache.
# Cache object will be deleted.
az image builder update -n myTemplate -g myGroup

Parámetros requeridos

--name -n

Nombre de la plantilla de imagen.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--build-timeout

Duración máxima que se esperará durante la creación de la plantilla de imagen, en minutos. El valor predeterminado es 60.

--build-vm-identities

Configuración opcional de la red virtual que se va a usar para implementar la máquina virtual de compilación en. Omítalo si no es necesario usar ninguna red virtual específica.

--checksum

La suma de comprobación SHA256 de la imagen ISO de Red Hat.

--defer

Almacena temporalmente el objeto en la memoria caché local en lugar de enviarlo a Azure. Use az cache comandos para ver o borrar.

--identity

Lista de identidades asignadas por el usuario (nombre o identificador, espacio delimitado) de la plantilla de imagen.

--image-source -i

Imagen base que se va a personalizar. Debe ser un URN de imagen de plataforma válido, alias de imagen de plataforma, URI de imagen ISO de Red Hat, nombre o identificador de imagen administrado o identificador de versión de imagen compartida.

valor de: az vm image list, az vm image show

--image-template

Ruta de acceso local o dirección URL a un archivo de plantilla de imagen. Al usar --image-template, se omiten todos los demás parámetros excepto -g y -n. Referencia: https://docs.microsoft.com/azure/virtual-machines/linux/image-builder-json.

--location -l

Ubicación. Los valores de: az account list-locations. Puede configurar la ubicación predeterminada mediante az configure --defaults location=<location>.

--managed-image-destinations

Información del distribuidor de salida de imagen administrada. Lista separada por espacios de pares clave-valor. Por ejemplo, "image_1=westus2 image_2=westus". Cada clave es el nombre o el identificador de recurso de la imagen administrada que se va a crear. Cada valor es la ubicación de la imagen.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False

--os-disk-size

Tamaño del disco del sistema operativo en GB. Omita o especifique 0 para usar el tamaño de disco del sistema operativo predeterminado de Azure.

--proxy-vm-size

Tamaño de la máquina virtual que se usa para compilar, personalizar y capturar imágenes (Standard_D1_v2 para imágenes de Gen1 y Standard_D2ds_v4 para imágenes de Gen2).

--scripts

Lista separada por espacios de scripts de shell o powershell con los que personalizar la imagen. Cada script debe ser una dirección URL accesible públicamente. Deduce el tipo de script de la extensión de archivo ('.sh' o'.ps1') o del tipo de origen. Más opciones y flexibilidad del personalizador, consulte: "az image template customizer add".

--shared-image-destinations

Información del distribuidor de salida de la galería de imágenes compartidas (sig). Lista separada por espacios de pares clave-valor. Por ejemplo, "my_gallery_1/image_def_1=eastus,westus my_gallery_2/image_def_2=uksouth,canadaeast,francesouth". Cada clave es el identificador de definición de imagen sig o el nombre de la galería sig y la definición de imagen sig delimitada por "/". Cada valor es una lista delimitada por comas de ubicaciones de réplica.

--staging-resource-group

Identificador del grupo de recursos de almacenamiento provisional en la misma suscripción que la plantilla de imagen que se usará para compilar la imagen.

--subnet

Nombre o identificador de subred para implementar la máquina virtual de compilación.

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--validator

Tipo de validación que desea usar en la imagen. Por ejemplo, "Shell" puede ser validación de shell.

--vm-size

Tamaño de la máquina virtual que se usa para compilar, personalizar y capturar imágenes. Omita o especifique una cadena vacía para usar el valor predeterminado (Standard_D1_v2).

--vnet

Nombre de la red virtual para implementar la máquina virtual de compilación. Solo debe especificarla cuando la subred sea un nombre.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az image builder delete

Elimine la plantilla del generador de imágenes.

az image builder delete [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Ejemplos

Elimine la plantilla del generador de imágenes. (generado automáticamente)

az image builder delete --name MyImageTemplate --resource-group MyResourceGroup

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la plantilla de imagen.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az image builder list

Enumerar plantillas del generador de imágenes.

az image builder list [--resource-group]

Parámetros opcionales

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az image builder run

Cree una plantilla de generador de imágenes.

az image builder run [--ids]
                     [--name]
                     [--no-wait]
                     [--resource-group]
                     [--subscription]

Ejemplos

Inicie una ejecución de compilación de plantilla y espere a que finalice.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la plantilla de imagen.

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az image builder show

Mostrar una plantilla del generador de imágenes.

az image builder show [--ids]
                      [--name]
                      [--resource-group]
                      [--subscription]

Ejemplos

Mostrar una plantilla de generador de imágenes (generada automáticamente)

az image builder show --name mytemplate  --resource-group my-group

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la plantilla de imagen.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az image builder show-runs

Mostrar las salidas de ejecución de una plantilla de Image Builder.

az image builder show-runs [--ids]
                           [--name]
                           [--output-name]
                           [--resource-group]
                           [--subscription]

Ejemplos

Ejecute una compilación de plantilla y, a continuación, vea sus salidas de ejecución.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show-runs -n mytemplate -g my-group

Parámetros opcionales

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la plantilla de imagen.

--output-name

Nombre de la salida de ejecución del generador de imágenes.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az image builder update

Actualice una plantilla de Image Builder.

Actualmente no se admite la actualización de plantillas de Image Builder. Este comando se puede usar junto con --defer para actualizar un objeto de plantilla de imagen dentro de la caché de la CLI. Sin --defer it recupera la plantilla de imagen especificada de la memoria caché y envía una solicitud a Azure para crear la plantilla de imagen.

az image builder update [--add]
                        [--defer]
                        [--force-string]
                        [--ids]
                        [--name]
                        [--remove]
                        [--resource-group]
                        [--set]
                        [--subscription]

Ejemplos

Cree un recurso de plantilla a partir de un objeto de plantilla en la caché de la CLI. Consulte "az image builder create/output add/customizer add --help" y "az cache -h" para obtener más información.

# create and write template object to local cli cache
az image builder create --image-source {image_source} -n mytemplate -g my-group \
    --scripts {script} --managed-image-destinations image_1=westus --identity myidentity --defer

# add customizers and outputs to local cache template object via az image template output / customizer add
# one can also update cache object properties through generic update options, such as: --set
az image builder output add -n mytemplate -g my-group --output-name my-win-image-managed \
    --artifact-tags "is_vhd=False"  --managed-image winImage --managed-image-location eastus --defer

# send template create request to azure to create template resource
az image builder update -n mytemplate -g my-group

Parámetros opcionales

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string or JSON string>.

valor predeterminado: []

--defer

Almacena temporalmente el objeto en la memoria caché local en lugar de enviarlo a Azure. Use az cache comandos para ver o borrar.

--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

valor predeterminado: False

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--name -n

Nombre de la plantilla de imagen.

--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list <indexToRemove> O --remove propertyToRemove.

valor predeterminado: []

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=<value>.

valor predeterminado: []

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az image builder wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición de la plantilla.

az image builder wait [--created]
                      [--custom]
                      [--deleted]
                      [--exists]
                      [--ids]
                      [--interval]
                      [--name]
                      [--resource-group]
                      [--subscription]
                      [--timeout]
                      [--updated]

Ejemplos

Inicie una ejecución de compilación de plantilla y espere a que finalice.

az image builder run -n mytemplate -g my-group --no-wait

az image builder wait -n mytemplate -g aibmdi \
    --custom "lastRunStatus.runState!='Running'"

az image builder show -n mytemplate -g my-group

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

valor predeterminado: False

--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

valor predeterminado: False

--exists

Espere hasta que exista el recurso.

valor predeterminado: False

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30

--name -n

Nombre de la plantilla de imagen.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--timeout

Espera máxima en segundos.

valor predeterminado: 3600

--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

valor predeterminado: False

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.