az acr

Note

Este grupo de comandos tiene comandos definidos en CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Administrar registros privados con Azure Registros de contenedor.

Comandos

Nombre	Description	Tipo	Estado
az acr agentpool	Administrar grupos de agentes de tareas privadas con Azure Registros de contenedor.	Core	Preview
az acr agentpool create	Cree un grupo de agentes para un Azure Container Registry.	Core	Preview
az acr agentpool delete	Elimine un grupo de agentes.	Core	Preview
az acr agentpool list	Enumere los grupos de agentes de un Azure Container Registry.	Core	Preview
az acr agentpool show	Obtenga las propiedades de un grupo de agentes especificado para una Azure Container Registry.	Core	Preview
az acr agentpool update	Actualice un grupo de agentes para un Azure Container Registry.	Core	Preview
az acr artifact-streaming	Administrar el streaming de artefactos para cualquier repositorio o imágenes admitidas en un ACR.	Core	Preview
az acr artifact-streaming create	Cree un artefacto de streaming de referencias para una imagen específica en un ACR.	Core	Preview
az acr artifact-streaming operation	Administre las operaciones de creación de artefactos de streaming para ACR.	Core	Preview
az acr artifact-streaming operation cancel	Cancele la operación de artefacto de streaming dada para ACR.	Core	Preview
az acr artifact-streaming operation show	Compruebe el estado de la operación para el streaming de artefactos en un ACR.	Core	Preview
az acr artifact-streaming show	Mostrar si el streaming de artefactos está habilitado en un repositorio para una Azure Container Registry.	Core	Preview
az acr artifact-streaming update	Habilite o deshabilite la creación automática de artefactos de streaming para imágenes recién insertadas en un registro determinado.	Core	Preview
az acr build	Pone en cola una compilación rápida, lo que proporciona registros de streaming para una Azure Container Registry.	Core	GA
az acr cache	Administrar reglas de caché en Azure registros de contenedor.	Core	GA
az acr cache create	Cree una regla de caché.	Core	GA
az acr cache delete	Elimine una regla de caché.	Core	GA
az acr cache list	Enumere las reglas de caché en un Azure Container Registry.	Core	GA
az acr cache show	Mostrar una regla de caché.	Core	GA
az acr cache update	Actualice el conjunto de credenciales en una regla de caché.	Core	GA
az acr check-health	Obtiene información de estado sobre el entorno y, opcionalmente, un registro de destino.	Core	GA
az acr check-name	Comprueba si un nombre de Azure Container Registry es válido y está disponible para su uso.	Core	GA
az acr config	Configure directivas para Azure Registros de contenedor.	Core	GA
az acr config authentication-as-arm	Administre la directiva "Azure AD authenticate as ARM" para Azure Container Registries.	Core	Preview
az acr config authentication-as-arm show	Muestre la directiva "Azure AD autenticada como ARM" configurada para un Azure Container Registry.	Core	Preview
az acr config authentication-as-arm update	Actualice la directiva "Azure autenticación de AD como ARM" para un Azure Container Registry.	Core	Preview
az acr config content-trust	Administrar la directiva de confianza de contenido para Azure Registros de contenedor.	Core	Deprecated
az acr config content-trust show	Muestra la directiva de confianza de contenido configurada para un Azure Container Registry.	Core	Deprecated
az acr config content-trust update	Actualice la directiva de confianza de contenido para un Azure Container Registry.	Core	GA
az acr config retention	Administrar la directiva de retención para Azure Registros de contenedor.	Core	Preview
az acr config retention show	Muestra la directiva de retención configurada para un Azure Container Registry.	Core	Preview
az acr config retention update	Actualizar la directiva de retención de un Azure Container Registry.	Core	Preview
az acr config soft-delete	Administrar la directiva de eliminación temporal para Azure Registros de contenedor.	Core	Preview
az acr config soft-delete show	Muestra la directiva de eliminación temporal configurada para una Azure Container Registry.	Core	Preview
az acr config soft-delete update	Actualice la directiva de eliminación temporal para una Azure Container Registry.	Core	Preview
az acr connected-registry	Administre los recursos del Registro conectados con Azure Container Registries.	Core	GA
az acr connected-registry create	Cree un registro conectado para un Azure Container Registry.	Core	GA
az acr connected-registry deactivate	Desactive un registro conectado desde Azure Container Registry.	Core	GA
az acr connected-registry delete	Elimine un registro conectado de Azure Container Registry.	Core	GA
az acr connected-registry get-settings	Recupere la información necesaria para activar un registro conectado y cree o rota las credenciales del token de sincronización.	Core	GA
az acr connected-registry list	Enumere todos los registros conectados en el registro primario actual.	Core	GA
az acr connected-registry list-client-tokens	Enumere todos los tokens de cliente asociados a registros conectados específicos.	Core	GA
az acr connected-registry permissions	Administre los permisos del repositorio en varios registros conectados. Consulte https://aka.ms/acr/connected-registry para obtener más información.	Core	GA
az acr connected-registry permissions show	Muestra la información del mapa del ámbito de sincronización del registro conectado.	Core	GA
az acr connected-registry permissions update	Agregue y quite permisos de repositorio en todas las asignaciones de ámbito de sincronización del registro conectadas necesarias.	Core	GA
az acr connected-registry show	Mostrar los detalles del registro conectados.	Core	GA
az acr connected-registry update	Actualice un registro conectado para un Azure Container Registry.	Core	GA
az acr create	Cree un Azure Container Registry.	Core	GA
az acr credential	Administrar credenciales de inicio de sesión para Azure registros de contenedor.	Core	GA
az acr credential-set	Administrar conjuntos de credenciales en Azure Registros de contenedor.	Core	GA
az acr credential-set create	Cree un conjunto de credenciales.	Core	GA
az acr credential-set delete	Elimine un conjunto de credenciales.	Core	GA
az acr credential-set list	Enumere los conjuntos de credenciales en un Azure Container Registry.	Core	GA
az acr credential-set show	Mostrar un conjunto de credenciales.	Core	GA
az acr credential-set update	Actualice el nombre de usuario o la contraseña Azure Key Vault identificador de secreto en un conjunto de credenciales.	Core	GA
az acr credential renew	Vuelva a generar las credenciales de inicio de sesión de un Azure Container Registry.	Core	GA
az acr credential show	Obtenga las credenciales de inicio de sesión de un Azure Container Registry.	Core	GA
az acr delete	Elimina un Azure Container Registry.	Core	GA
az acr encryption	Administrar el cifrado del registro de contenedor.	Core	GA
az acr encryption rotate-key	Girar (actualizar) la clave de cifrado del registro de contenedor.	Core	GA
az acr encryption show	Muestra los detalles de cifrado del registro de contenedor.	Core	GA
az acr export-pipeline	Administrar canalizaciones de exportación de ACR.	Extension	Preview
az acr export-pipeline create	Cree una canalización de exportación.	Extension	Preview
az acr export-pipeline delete	Elimine una canalización de exportación.	Extension	Preview
az acr export-pipeline list	Enumerar las canalizaciones de exportación en una instancia de Container Registry.	Extension	Preview
az acr export-pipeline show	Mostrar una canalización de exportación en detalle.	Extension	Preview
az acr helm	Administrar gráficos de Helm para Azure Registros de contenedor.	Core	Deprecated
az acr helm delete	Elimine una versión del gráfico de Helm en un Azure Container Registry.	Core	Deprecated
az acr helm install-cli	Descargue e instale la herramienta de línea de comandos de Helm.	Core	Versión preliminar y en desuso
az acr helm list	Enumere todos los gráficos de Helm de un Azure Container Registry.	Core	Deprecated
az acr helm push	Inserte un paquete de gráfico de Helm en un Azure Container Registry.	Core	Deprecated
az acr helm repo	Administrar repositorios de gráficos de Helm para Azure Registros de contenedor.	Core	Deprecated
az acr helm repo add	Agregue un repositorio de gráficos de Helm desde un Azure Container Registry a través de la CLI de Helm.	Core	Deprecated
az acr helm show	Describir un gráfico de Helm en un Azure Container Registry.	Core	Deprecated
az acr identity	Administrar identidades de servicio (administradas) para un registro de contenedor.	Core	GA
az acr identity assign	Asigne una identidad administrada a un registro de contenedor.	Core	GA
az acr identity remove	Quite una identidad administrada de un registro de contenedor.	Core	GA
az acr identity show	Muestra los detalles de identidad del registro de contenedor.	Core	GA
az acr import	Importa una imagen a un Azure Container Registry desde otro registro de contenedor. La importación elimina la necesidad de docker pull, docker tag o docker push. Para imágenes más grandes, considere la posibilidad de usar `--no-wait`.	Core	GA
az acr import-pipeline	Administrar canalizaciones de importación de ACR.	Extension	Preview
az acr import-pipeline create	Cree una canalización de importación.	Extension	Preview
az acr import-pipeline delete	Elimine una canalización de importación.	Extension	Preview
az acr import-pipeline list	Enumerar las canalizaciones de importación en un registro de contenedor.	Extension	Preview
az acr import-pipeline show	Mostrar una canalización de importación con detalle.	Extension	Preview
az acr list	Enumera todos los registros de contenedor de la suscripción actual.	Core	GA
az acr login	Inicie sesión en un Azure Container Registry a través de la CLI de Docker.	Core	GA
az acr manifest	Administrar manifiestos de artefactos en Azure Registros de contenedor.	Core	Preview
az acr manifest delete	Elimine un manifiesto en un Azure Container Registry.	Core	Preview
az acr manifest list	Enumere los manifiestos de un repositorio en un Azure Container Registry.	Core	Preview
az acr manifest list-deleted	Enumere los manifiestos eliminados temporalmente en un repositorio de un Azure Container Registry.	Core	Preview
az acr manifest list-deleted-tags	Enumere las etiquetas eliminadas temporalmente en un repositorio de un Azure Container Registry.	Core	Preview
az acr manifest list-metadata	Enumere los metadatos de los manifiestos de un repositorio en un Azure Container Registry.	Core	Preview
az acr manifest list-referrers	Enumere los remitentes a un manifiesto en un Azure Container Registry.	Core	Preview
az acr manifest restore	Restaure un artefacto y una etiqueta eliminados temporalmente en un Azure Container Registry.	Core	Preview
az acr manifest show	Obtenga un manifiesto en un Azure Container Registry.	Core	Preview
az acr manifest show-metadata	Obtenga los metadatos de un artefacto en un Azure Container Registry.	Core	Preview
az acr manifest update-metadata	Actualice los metadatos del manifiesto de un artefacto en un Azure Container Registry.	Core	Preview
az acr network-rule	Administrar reglas de red para Azure Registros de contenedor.	Core	GA
az acr network-rule add	Agregue una regla de red.	Core	GA
az acr network-rule list	Enumera las reglas de red.	Core	GA
az acr network-rule remove	Quite una regla de red.	Core	GA
az acr pack	Administre Azure Container Registry tareas que usan paquetes de compilación nativos en la nube.	Core	Preview
az acr pack build	Pone en cola una tarea de compilación rápida que compila una aplicación y la inserta en un Azure Container Registry.	Core	Preview
az acr pipeline-run	Administre las ejecuciones de canalización de importación y exportación de ACR.	Extension	Preview
az acr pipeline-run clean	Elimine todas las ejecuciones de canalización con errores en el registro.	Extension	Preview
az acr pipeline-run create	Cree una ejecución de canalización.	Extension	Preview
az acr pipeline-run delete	Elimine una ejecución de canalización.	Extension	Preview
az acr pipeline-run list	Enumera las ejecuciones de canalización de todas las canalizaciones de un registro de contenedor.	Extension	Preview
az acr pipeline-run show	Mostrar una ejecución de canalización con detalle.	Extension	Preview
az acr private-endpoint-connection	Administrar conexiones de punto de conexión privado del registro de contenedor.	Core	GA
az acr private-endpoint-connection approve	Apruebe una solicitud de conexión de punto de conexión privado para un registro de contenedor.	Core	GA
az acr private-endpoint-connection delete	Elimine una solicitud de conexión de punto de conexión privado para un registro de contenedor.	Core	GA
az acr private-endpoint-connection list	Enumere todas las conexiones de punto de conexión privado a un registro de contenedor.	Core	GA
az acr private-endpoint-connection reject	Rechazar una solicitud de conexión de punto de conexión privado para un registro de contenedor.	Core	GA
az acr private-endpoint-connection show	Mostrar detalles de la conexión de punto de conexión privado de un registro de contenedor.	Core	GA
az acr private-link-resource	Administrar recursos de vínculo privado del Registro.	Core	GA
az acr private-link-resource list	Enumere los recursos de private link admitidos para un registro.	Core	GA
az acr query	Consulte el contenido de un ACR mediante el lenguaje de consulta Kusto.	Extension	GA
az acr replication	Administrar regiones con replicación geográfica de Azure Registros de contenedor.	Core	GA
az acr replication create	Cree una región replicada para un Azure Container Registry.	Core	GA
az acr replication delete	Elimine una región replicada de un Azure Container Registry.	Core	GA
az acr replication list	Enumere todas las regiones de un Azure Container Registry replicado geográficamente.	Core	GA
az acr replication show	Obtenga los detalles de una región replicada.	Core	GA
az acr replication update	Actualiza una replicación.	Core	GA
az acr repository	Administrar repositorios (nombres de imagen) para Azure Registros de contenedor.	Core	GA
az acr repository delete	Elimine un repositorio o una imagen en una Azure Container Registry.	Core	GA
az acr repository list	Enumera los repositorios de un Azure Container Registry.	Core	GA
az acr repository list-deleted	Enumeración de repositorios eliminados temporalmente en una Azure Container Registry.	Core	Preview
az acr repository show	Obtenga los atributos de un repositorio o imagen en un Azure Container Registry.	Core	GA
az acr repository show-tags	Mostrar etiquetas para un repositorio en un Azure Container Registry.	Core	GA
az acr repository untag	Desetiquetar una imagen en un Azure Container Registry.	Core	GA
az acr repository update	Actualice los atributos de un repositorio o imagen en un Azure Container Registry.	Core	GA
az acr run	Pone en cola una ejecución rápida que proporciona registros transmitidos para una Azure Container Registry.	Core	GA
az acr scope-map	Administrar asignaciones de acceso de ámbito para Azure Registros de contenedor.	Core	GA
az acr scope-map create	Cree un mapa de ámbito para un Azure Container Registry.	Core	GA
az acr scope-map delete	Elimine un mapa de ámbito de un Azure Container Registry.	Core	GA
az acr scope-map list	Enumere todos los mapas de ámbito de un Azure Container Registry.	Core	GA
az acr scope-map show	Mostrar detalles y atributos de un mapa de ámbito para un Azure Container Registry.	Core	GA
az acr scope-map update	Actualice un mapa de ámbito para un Azure Container Registry.	Core	GA
az acr show	Obtenga los detalles de un Azure Container Registry.	Core	GA
az acr show-endpoints	Mostrar puntos de conexión del Registro.	Core	GA
az acr show-usage	Obtenga el uso del almacenamiento de un Azure Container Registry.	Core	GA
az acr supply-chain	Comandos para administrar los recursos de la cadena de suministro de acr.	Extension	Preview
az acr supply-chain workflow	Comandos para administrar flujos de trabajo de la cadena de suministro de acr.	Extension	Preview
az acr supply-chain workflow cancel-run	Cancele el flujo de trabajo de la cadena de suministro que se está ejecutando actualmente.	Extension	Preview
az acr supply-chain workflow create	Cree un flujo de trabajo de la cadena de suministro de acr.	Extension	Preview
az acr supply-chain workflow delete	Elimine el flujo de trabajo de la cadena de suministro de acr.	Extension	Preview
az acr supply-chain workflow list	Enumerar el estado de las imágenes de flujo de trabajo de la cadena de suministro de acr.	Extension	Preview
az acr supply-chain workflow show	Mostrar tareas de flujo de trabajo de la cadena de suministro de acr.	Extension	Preview
az acr supply-chain workflow update	Actualice el flujo de trabajo de la cadena de suministro de acr.	Extension	Preview
az acr task	Administrar una colección de pasos para crear, probar y OS & Aplicar revisiones a imágenes de contenedor mediante Azure Registros de contenedor.	Core	GA
az acr task cancel-run	Cancele una ejecución especificada de un Azure Container Registry.	Core	GA
az acr task create	Cree una serie de pasos para crear, probar y contenedores de aplicación de revisiones de & Framework. Las tareas admiten desencadenadores de confirmaciones de Git y actualizaciones de imágenes base.	Core	GA
az acr task credential	Administrar las credenciales de una tarea. Consulte https://aka.ms/acr/tasks/cross-registry-authentication para obtener más información.	Core	GA
az acr task credential add	Agregue una credencial de inicio de sesión del Registro personalizada a la tarea.	Core	GA
az acr task credential list	Enumere todas las credenciales del Registro personalizadas para la tarea.	Core	GA
az acr task credential remove	Quite las credenciales de una tarea.	Core	GA
az acr task credential update	Actualice la credencial de inicio de sesión del Registro para una tarea.	Core	GA
az acr task delete	Elimine una tarea de un Azure Container Registry.	Core	GA
az acr task identity	Identidades administradas para la tarea. Consulte https://aka.ms/acr/tasks/task-create-managed-identity para obtener más información.	Core	GA
az acr task identity assign	Actualice la identidad administrada de una tarea.	Core	GA
az acr task identity remove	Quite las identidades administradas de una tarea.	Core	GA
az acr task identity show	Muestra las identidades administradas para la tarea.	Core	GA
az acr task list	Enumere las tareas de un Azure Container Registry.	Core	GA
az acr task list-runs	Enumere todas las ejecuciones ejecutadas para una Azure Container Registry, con la capacidad de filtrar por una tarea específica.	Core	GA
az acr task logs	Mostrar registros para una ejecución determinada. Si no se proporciona ningún identificador de ejecución, muestre los registros de la última ejecución creada.	Core	GA
az acr task run	Desencadene manualmente una tarea que podría estar esperando confirmaciones de Git o desencadenadores de actualización de imágenes base.	Core	GA
az acr task show	Obtenga las propiedades de una tarea con nombre para un Azure Container Registry.	Core	GA
az acr task show-run	Obtiene las propiedades de una ejecución especificada de una tarea de Azure Container Registry.	Core	GA
az acr task timer	Administrar desencadenadores de temporizador para una tarea.	Core	GA
az acr task timer add	Agregue un desencadenador de temporizador a una tarea.	Core	GA
az acr task timer list	Enumerar todos los desencadenadores de temporizador para una tarea.	Core	GA
az acr task timer remove	Quite un desencadenador de temporizador de una tarea.	Core	GA
az acr task timer update	Actualice el desencadenador del temporizador para una tarea.	Core	GA
az acr task update	Actualice una tarea para un Azure Container Registry.	Core	GA
az acr task update-run	Aplique revisiones a las propiedades de ejecución de una tarea de Azure Container Registry.	Core	GA
az acr taskrun	Administre las tareas mediante Azure Registros de contenedor.	Core	Preview
az acr taskrun delete	Elimine una tarearun de un Azure Container Registry.	Core	Preview
az acr taskrun list	Enumere las tareas de un Azure Container Registry.	Core	Preview
az acr taskrun logs	Mostrar registros de ejecución para una tarea determinadarun.	Core	Preview
az acr taskrun show	Obtiene las propiedades de un taskrun con nombre para un Azure Container Registry.	Core	Preview
az acr token	Administrar tokens para un Azure Container Registry.	Core	GA
az acr token create	Cree un token asociado a una asignación de ámbito para una Azure Container Registry.	Core	GA
az acr token credential	Administrar credenciales de un token para una Azure Container Registry.	Core	GA
az acr token credential delete	Elimine una credencial de token.	Core	GA
az acr token credential generate	Genere o reemplace una o ambas contraseñas de un token para una Azure Container Registry. Para usar el token y la contraseña para acceder a un registro de contenedor, consulte https://aka.ms/acr/repo-permissions.	Core	GA
az acr token delete	Elimine un token de un Azure Container Registry.	Core	GA
az acr token list	Enumera todos los tokens de un Azure Container Registry.	Core	GA
az acr token show	Mostrar detalles y atributos de un token para un Azure Container Registry.	Core	GA
az acr token update	Actualice un token (reemplace la asignación de ámbito asociada) para un Azure Container Registry.	Core	GA
az acr update	Actualice un Azure Container Registry.	Core	GA
az acr webhook	Administrar webhooks para Azure Registros de contenedor.	Core	GA
az acr webhook create	Cree un webhook para un Azure Container Registry.	Core	GA
az acr webhook delete	Elimine un webhook de un Azure Container Registry.	Core	GA
az acr webhook get-config	Obtenga el URI de servicio y los encabezados personalizados del webhook.	Core	GA
az acr webhook list	Enumere todos los webhooks de un Azure Container Registry.	Core	GA
az acr webhook list-events	Enumerar los eventos recientes de un webhook.	Core	GA
az acr webhook ping	Desencadene un evento ping para un webhook.	Core	GA
az acr webhook show	Obtenga los detalles de un webhook.	Core	GA
az acr webhook update	Actualice un webhook.	Core	GA

az acr build

Editar

Pone en cola una compilación rápida, lo que proporciona registros de streaming para una Azure Container Registry.

az acr build --registry
             [--acquire-policy-token]
             [--agent-pool]
             [--auth-mode {Default, None}]
             [--build-arg]
             [--change-reference]
             [--file]
             [--image]
             [--log-template]
             [--no-format]
             [--no-logs]
             [--no-push]
             [--no-wait]
             [--platform]
             [--resource-group]
             [--secret-build-arg]
             [--source-acr-auth-id {[caller], none}]
             [--target]
             [--timeout]
             []

Ejemplos

Poner en cola un contexto local como una compilación de Linux, etiquetarlo e insertarlo en el registro.

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry .

Poner en cola un contexto local como una compilación de Linux, etiquetarlo e insertarlo en el registro sin registros de streaming.

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry --no-logs .

Poner en cola un contexto local como una compilación de Linux sin insertarlo en el registro.

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry --no-push .

Poner en cola un contexto local como una compilación de Linux sin insertarlo en el registro.

az acr build -r myregistry .

Poner en cola un contexto de GitHub remoto como una compilación de Windows, etiquetarlo e insertarlo en el registro.

az acr build -r myregistry https://github.com/Azure/acr-builder.git -f Windows.Dockerfile --platform windows

Poner en cola una compilación remota del contexto de artefacto de OCI.

az acr build -r myregistry oci://myregistry.azurecr.io/myartifact:mytag

Poner en cola un contexto local como una compilación de Linux en la arquitectura arm/v7, etiquetarla e insertarla en el registro.

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry . --platform linux/arm/v7

Poner en cola un contexto local como una compilación de Linux, etiquetarlo e insertarlo en el registro habilitado para el permiso de repositorio basado en ABAC y usar la identidad Entra del autor de la llamada para autenticarse con el registro de origen.

az acr build -t sample/hello-world:{{.Run.ID}} -r myregistry . --source-acr-auth-id [caller]

Parámetros requeridos

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--agent-pool

Vista previa

Nombre del grupo de agentes.

--auth-mode

Modo de autenticación del registro de origen.

Propiedad	Valor
Valores aceptados:	Default, None

--build-arg

Argumento build en formato "--build-arg name[=value]". Se admiten múltiplo pasando "--build-arg name[=value]" varias veces. IMPORTANTE: Este parámetro no debe incluir contraseñas, tokens de acceso ni información confidencial de ningún tipo. Este valor de parámetro será visible para el equipo de ACR con fines de depuración.

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--file -f

Ruta de acceso relativa del archivo docker a la carpeta raíz del código fuente. El valor predeterminado es "Dockerfile".

--image -t

El nombre y la etiqueta de la imagen con el formato : "-t repo/image:tag". Se admiten varias etiquetas pasando -t varias veces.

--log-template

Vista previa

La plantilla de repositorio y etiqueta para ejecutar el artefacto de registro con el formato "log/repo:tag" (por ejemplo, "acr/logs:{{.Run.ID}}"). Solo se aplica al registro habilitado para CMK.

--no-format

Indica si los registros deben mostrarse en formato sin formato.

Propiedad	Valor
Valor predeterminado:	False

--no-logs

No muestre los registros después de poner en cola correctamente la compilación.

Propiedad	Valor
Valor predeterminado:	False

--no-push

Indica si la imagen compilada debe insertarse en el registro.

Propiedad	Valor
Valor predeterminado:	False

--no-wait

No espere a que la compilación se complete y vuelva inmediatamente después de poner en cola la compilación.

Propiedad	Valor
Valor predeterminado:	False

--platform

La plataforma donde se ejecuta build/task, Eg, "windows" y "linux". Cuando se usa en los comandos de compilación, también se puede especificar en formato "os/arch/variant" para la imagen resultante. Por ejemplo, linux/arm/v7. Las partes 'arch' y 'variant' son opcionales.

--resource-group -g

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

--secret-build-arg

Argumento de compilación secreto en formato "--secret-build-arg name[=value]". Se admiten varios pasos "--secret-build-arg name[=value]" varias veces. Este valor de parámetro no aparece en el equipo de ACR y es más adecuado para la información confidencial.

--source-acr-auth-id

Asigne la identidad que se usa para el inicio de sesión del Registro de origen. Use '[llamador]' para la identidad del autor de la llamada.

Propiedad	Valor
Valores aceptados:	[caller], none

--target

Nombre de la fase de compilación de destino.

--timeout

Tiempo de espera en segundos.

<SOURCE_LOCATION>

La ruta de acceso del directorio de código fuente local (por ejemplo, "./src") o la dirección URL a un repositorio git (por ejemplo, "https://github.com/Azure-Samples/acr-build-helloworld-node.git") o un tarball remoto (por ejemplo, "http://server/context.tar.gz") o el repositorio de un artefacto de OCI en un registro de contenedor de Azure (por ejemplo, "oci://myregistry.azurecr.io/myartifact:mytag").

Propiedad	Valor
Grupo de parámetros:	Positional

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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr check-health

Editar

Cambio importante

Quite la validación de la versión del cliente de Notary en la próxima versión con cambios importantes (2.86.0) programada para mayo de 2026. La comprobación de la versión del cliente de Notary ya no se realizará como parte del comando check-health debido a la eliminación de Docker Content Trust. Para obtener más información sobre el cambio importante, visite https://aka.ms/acr/dctdeprecation.

Obtiene información de estado sobre el entorno y, opcionalmente, un registro de destino.

az acr check-health [--acquire-policy-token]
                    [--change-reference]
                    [--ignore-errors]
                    [--name]
                    [--repository]
                    [--vnet]
                    [--yes]

Ejemplos

Obtiene el estado de mantenimiento con el registro de destino "myregistry", omitiendo la confirmación para extraer la imagen.

az acr check-health -n myregistry -y

Obtiene el estado de mantenimiento del entorno, sin detenerlo en el primer error.

az acr check-health --ignore-errors

Obtiene el estado de mantenimiento con el registro de destino "myregistry" y comprueba los permisos permitidos en el repositorio específico "myrepo".

az acr check-health -n myregistry --repository myrepo

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--ignore-errors

Proporcione todas las comprobaciones de estado, incluso si se encuentran errores.

Propiedad	Valor
Valor predeterminado:	False

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

--repository

Nombre del repositorio.

--vnet

Identificador de red virtual para ejecutar este comando dentro de una red virtual para comprobar el enrutamiento dns a puntos de conexión privados.

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr check-name

Editar

Comprueba si un nombre de Azure Container Registry es válido y está disponible para su uso.

az acr check-name --name
                  [--acquire-policy-token]
                  [--change-reference]
                  [--dnl-scope {NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure}]
                  [--resource-group]

Ejemplos

Compruebe si ya existe un nombre del Registro.

az acr check-name -n doesthisnameexist

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--dnl-scope

Vista previa

El ámbito de la etiqueta del nombre de dominio agregará un hash al nombre del recurso. El nombre del servidor de inicio de sesión resultante tendrá el formato registry-name-hash.azurecr-io. El valor predeterminado es No seguro.

Propiedad	Valor
Valor predeterminado:	Unsecure
Valores aceptados:	NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure

--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 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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr create

Editar

Cree un Azure Container Registry.

az acr create --name
              --resource-group
              --sku {Basic, Premium, Standard}
              [--acquire-policy-token]
              [--admin-enabled {false, true}]
              [--allow-exports {false, true}]
              [--allow-metadata-search {false, true}]
              [--allow-trusted-services {false, true}]
              [--change-reference]
              [--default-action {Allow, Deny}]
              [--dnl-scope {NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure}]
              [--identity]
              [--key-encryption-key]
              [--location]
              [--public-network-enabled {false, true}]
              [--role-assignment-mode {rbac, rbac-abac}]
              [--tags]
              [--workspace]
              [--zone-redundancy {Disabled, Enabled}]

Ejemplos

Cree un registro de contenedor administrado con la SKU estándar.

az acr create -n myregistry -g MyResourceGroup --sku Standard

Cree un registro con el permiso de repositorio basado en ABAC habilitado.

az acr create -n myregistry -g MyResourceGroup --sku Standard --role-assignment-mode rbac-abac

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

--resource-group -g

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

--sku

SKU del registro de contenedor.

Propiedad	Valor
Valores aceptados:	Basic, Premium, Standard

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--admin-enabled

Indica si el usuario administrador está habilitado.

Propiedad	Valor
Valor predeterminado:	False
Valores aceptados:	false, true

--allow-exports

Vista previa

Configure exportPolicy para permitir o impedir que los artefactos se exporten desde este registro. Los artefactos se pueden exportar mediante operaciones de importación o transferencia. Para obtener más información, visite https://aka.ms/acr/export-policy.

Propiedad	Valor
Valores aceptados:	false, true

--allow-metadata-search

Vista previa

Habilite o deshabilite la característica de búsqueda de metadatos para el Registro. Si no se especifica, se establece en deshabilitado de forma predeterminada.

Propiedad	Valor
Valores aceptados:	false, true

--allow-trusted-services

Permitir que los servicios de Azure de confianza accedan a registros restringidos a la red. Para obtener más información, visite https://aka.ms/acr/trusted-services. El valor predeterminado es permitir.

Propiedad	Valor
Grupo de parámetros:	Network Rule Arguments
Valores aceptados:	false, true

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--default-action

Acción predeterminada que se aplicará cuando no coincida ninguna regla. Solo se aplica a la SKU Premium.

Propiedad	Valor
Grupo de parámetros:	Network Rule Arguments
Valores aceptados:	Allow, Deny

--dnl-scope

Vista previa

El ámbito de la etiqueta del nombre de dominio agregará un hash al nombre del recurso. El nombre del servidor de inicio de sesión resultante tendrá el formato registryname-hash.azurecr-io. El valor predeterminado es No seguro.

Propiedad	Valor
Valores aceptados:	NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure

--identity

Use el identificador de recurso de identidad administrada asignada o el nombre si se encuentra en el mismo grupo de recursos.

Propiedad	Valor
Grupo de parámetros:	Customer managed key Arguments

--key-encryption-key

URI de clave del almacén de claves. Para habilitar la rotación automatizada, proporcione un URI de clave sin versión. Para la rotación manual, proporcione un URI de clave con versión.

Propiedad	Valor
Grupo de parámetros:	Customer managed key Arguments

--location -l

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

--public-network-enabled

Permitir el acceso a la red pública para el registro de contenedor. El valor predeterminado es permitir.

Propiedad	Valor
Grupo de parámetros:	Network Rule Arguments
Valores aceptados:	false, true

--role-assignment-mode

Modo de asignación de roles del Registro. Para obtener más información sobre esta característica, consulte https://aka.ms/acr/auth/abac. El valor predeterminado es rbac.

Propiedad	Valor
Grupo de parámetros:	Permissions and Role Assignment Arguments
Valores aceptados:	rbac, rbac-abac

--tags

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

--workspace

Vista previa

Nombre o identificador del área de trabajo de Log Analytics a la que enviar registros de diagnóstico del Registro. Todos los eventos se habilitarán. Puede usar "az monitor log-analytics workspace create" para crear uno. Se puede aplicar facturación adicional.

--zone-redundancy

Vista previa

Indica si se debe habilitar o no la redundancia de zona para este registro o replicación. Para obtener más información, como ubicaciones admitidas, visite https://aka.ms/acr/az. No se puede actualizar la redundancia de zona. El valor predeterminado es "Disabled".

Propiedad	Valor
Valores aceptados:	Disabled, Enabled

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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr delete

Editar

Elimina un Azure Container Registry.

az acr delete --name
              [--acquire-policy-token]
              [--change-reference]
              [--resource-group]
              [--yes]

Ejemplos

Elimine un Azure Container Registry.

az acr delete -n myregistry

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--resource-group -g

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

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr import

Editar

Importa una imagen a un Azure Container Registry desde otro registro de contenedor. La importación elimina la necesidad de docker pull, docker tag o docker push. Para imágenes más grandes, considere la posibilidad de usar --no-wait.

az acr import --name
              --source
              [--acquire-policy-token]
              [--change-reference]
              [--force]
              [--image]
              [--no-wait]
              [--password]
              [--registry]
              [--repository]
              [--resource-group]
              [--username]

Ejemplos

Importe una imagen de "sourceregistry" a "myregistry". La imagen hereda su repositorio de origen y sus nombres de etiqueta.

az acr import -n myregistry --source sourceregistry.azurecr.io/sourcerepository:sourcetag

Importe una imagen de un repositorio público en Docker Hub. La imagen usa el repositorio y los nombres de etiqueta especificados.

az acr import -n myregistry --source docker.io/library/hello-world:latest -t targetrepository:targettag

Importe una imagen de un repositorio privado mediante su nombre de usuario y contraseña. Esto también se aplica a los registros fuera de Azure.

az acr import -n myregistry --source myprivateregistry.azurecr.io/hello-world:latest -u username -p password

Importe una imagen desde un registro de contenedor de Azure en otra suscripción.

az acr import -n myregistry --source sourcerepository:sourcetag -t targetrepository:targettag \
    -r /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sourceResourceGroup/providers/Microsoft.ContainerRegistry/registries/sourceRegistry

Importe una imagen sin esperar a que se complete correctamente. Los errores durante la importación no se reflejarán. Ejecute "az acr repository show-tags" para confirmar que la importación se realizó correctamente.

az acr import -n myregistry --source sourceregistry.azurecr.io/sourcerepository:sourcetag --no-wait

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

--source

Nombre de imagen de origen o origen completo que contiene el servidor de inicio de sesión del Registro. Si se usa --registry, --source siempre se interpretará como una imagen de origen, incluso si contiene el servidor de inicio de sesión.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--force

Sobrescriba la etiqueta existente de la imagen que se va a importar.

Propiedad	Valor
Valor predeterminado:	False

--image -t

El nombre y la etiqueta de la imagen con el formato : "-t repo/image:tag". Se admiten varias etiquetas pasando -t varias veces.

--no-wait

No espere a que la importación se complete y vuelva inmediatamente después de poner en cola la importación.

Propiedad	Valor
Valor predeterminado:	False

--password -p

Contraseña del registro de contenedor de origen.

--registry -r

Origen Azure registro de contenedor. Puede ser el nombre, el servidor de inicio de sesión o el identificador de recurso del registro de origen.

--repository

Nombre del repositorio para una copia de solo manifiesto de imágenes. Se admiten varias copias pasando --repository varias veces.

--resource-group -g

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

--username -u

Nombre de usuario del registro de contenedor de origen.

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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr list

Editar

Enumera todos los registros de contenedor de la suscripción actual.

az acr list [--resource-group]

Ejemplos

Enumere los registros de contenedor y muestre los resultados en una tabla, en varios grupos de recursos.

az acr list -o table

Enumere los registros de contenedor en un grupo de recursos y muestre los resultados en una tabla.

az acr list -g MyResourceGroup -o table

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.

--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 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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

Editar

Inicie sesión en un Azure Container Registry a través de la CLI de Docker.

Docker debe estar instalado en la máquina. Una vez hecho esto, use docker logout <registry url> para cerrar sesión. (Si solo necesita un token de actualización y no desea instalar Docker, especifique "--expose-token").

az acr login --name
             [--acquire-policy-token]
             [--change-reference]
             [--expose-token]
             [--password]
             [--resource-group]
             [--suffix]
             [--username]

Iniciar sesión en un Azure Container Registry

az acr login -n myregistry

Obtención de un token de acceso de Azure Container Registry

az acr login -n myregistry --expose-token

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--expose-token -t

Exponga el token de actualización en lugar de iniciar sesión automáticamente a través de la CLI de Docker.

Propiedad	Valor
Valor predeterminado:	False

--password -p

Contraseña usada para iniciar sesión en un registro de contenedor.

--resource-group -g

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

--suffix

Sufijo de inquilino en el servidor de inicio de sesión del Registro. Puede especificar "--suffix tenant" si el servidor de inicio de sesión del Registro tiene el formato "registry-tenant.azurecr.io". Aplicable si tiene acceso al registro desde una suscripción diferente o tiene permiso para acceder a imágenes, pero no al permiso para administrar el recurso del Registro.

--username -u

Nombre de usuario que se usa para iniciar sesión en un registro de contenedor.

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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr query

Consulte el contenido de un ACR mediante el lenguaje de consulta Kusto.

Consulta de artefactos e imágenes en un Azure Container Registry mediante el lenguaje de consulta Kusto. Las propiedades del manifiesto OCI, como resumen, asunto, anotaciones, etc. se pueden usar para consultar, filtrar y ordenar los resultados de la búsqueda.

az acr query --kql-query
             --name
             [--acquire-policy-token]
             [--change-reference]
             [--password]
             [--repository]
             [--skip-token]
             [--username]

Ejemplos

Captura de un único manifiesto

az acr query -n $MyRegistry -q "Manifests | limit 1"

Recuento de todos los manifiestos del repositorio $RepositoryName

az acr query -n $MyRegistry -q "Manifests" -o table

Enumerar todos los manifiestos del repositorio $RepositoryName en orden de creación

az acr query -n $MyRegistry --repository $RepositoryName -q "Manifests | order by createdAt desc"

Consulta de todos los resúmenes firmados por $Signature en el repositorio $RepositoryName

az acr query -n $MyRegistry --repository $RepositoryName -q "Manifests | where annotations['org.cncf.notary.signature.subject'] == $Signature | project createdAt, digest, subject"

Consulta de los resúmenes de un registro mediante un token de omisión y ordenación por resumen (para los resultados con paginación)

az acr query -n $MyRegistry -q "Manifests | project digest | order by digest asc" --skip-token eyAibm8iOiAibHVjayIsICJidXQiOiAibmljZSIsICJ0cnkiOiAiISIgfQ==

Parámetros requeridos

--kql-query -q

Consulta KQL que se va a ejecutar.

--name -n

Nombre del registro de contenedor en el que se ejecuta la consulta.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--password -p

Contraseña del Registro.

--repository

Repositorio en el que se ejecuta la consulta. Si no se proporciona ningún repositorio, la consulta se ejecuta en el nivel del Registro.

--skip-token

Omita el token para obtener la página siguiente de la consulta si procede.

--username -u

Nombre de usuario del Registro.

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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr run

Editar

Pone en cola una ejecución rápida que proporciona registros transmitidos para una Azure Container Registry.

az acr run --registry
           [--acquire-policy-token]
           [--agent-pool]
           [--auth-mode {Default, None}]
           [--change-reference]
           [--cmd]
           [--file]
           [--log-template]
           [--no-format]
           [--no-logs]
           [--no-wait]
           [--platform]
           [--resource-group]
           [--set]
           [--set-secret]
           [--source-acr-auth-id {[caller], none}]
           [--timeout]
           [--values]
           []

Ejemplos

Poner en cola una ejecución para ejecutar un comando de contenedor.

az acr run -r myregistry --cmd '$Registry/myimage' /dev/null

Poner en cola una ejecución con la definición de tarea de la entrada estándar. "Ctrl + Z" (Windows) o "Ctrl + D" (Linux) finaliza el flujo de entrada.

az acr run -r myregistry -f - /dev/null

Poner en cola una ejecución para ejecutar las tareas que se pasan a través de la canalización.

cat task.yaml | az acr run -r myregistry -f - /dev/null

Poner en cola un contexto local, insertado en ACR con registros de streaming.

az acr run -r myregistry -f bash-echo.yaml ./workspace

Poner en cola un contexto de Git remoto con registros de streaming.

az acr run -r myregistry https://github.com/Azure-Samples/acr-tasks.git -f hello-world.yaml

Poner en cola un contexto de Git remoto con registros de streaming y ejecutar la tarea en la plataforma Linux.

az acr run -r myregistry https://github.com/Azure-Samples/acr-tasks.git -f build-hello-world.yaml --platform linux

Poner en cola un contexto de artefacto de OCI remoto y ejecutar la tarea.

az acr run -r myregistry oci://myregistry.azurecr.io/myartifact:mytag -f hello-world.yaml

Poner en cola una ejecución para ejecutar un comando de contenedor en un registro habilitado para el permiso de repositorio basado en ABAC y usar la identidad Entra del autor de la llamada para autenticarse con el registro de origen.

az acr run -r myregistry --cmd '$Registry/myimage' /dev/null --source-acr-auth-id [caller]

Parámetros requeridos

--registry -r

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--agent-pool

Vista previa

Nombre del grupo de agentes.

--auth-mode

Modo de autenticación del registro de origen.

Propiedad	Valor
Valores aceptados:	Default, None

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--cmd

Comandos que se van a ejecutar. Esto también admite parámetros adicionales de ejecución de Docker (https://docs.docker.com/engine/reference/commandline/run/) o incluso otros comandos de Docker (https://docs.docker.com/engine/reference/commandline/docker/).

--file -f

Ruta de acceso del archivo de plantilla o definición de tarea en relación con el contexto de origen. Puede ser "-" para canalizar un archivo desde la entrada estándar.

--log-template

Vista previa

La plantilla de repositorio y etiqueta para ejecutar el artefacto de registro con el formato "log/repo:tag" (por ejemplo, "acr/logs:{{.Run.ID}}"). Solo se aplica al registro habilitado para CMK.

--no-format

Indica si los registros deben mostrarse en formato sin formato.

Propiedad	Valor
Valor predeterminado:	False

--no-logs

No muestre los registros después de poner en cola correctamente la compilación.

Propiedad	Valor
Valor predeterminado:	False

--no-wait

No espere a que se complete la ejecución y vuelva inmediatamente después de poner en cola la ejecución.

Propiedad	Valor
Valor predeterminado:	False

--platform

--resource-group -g

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

--set

Valor en formato 'name[=value]'. Se admiten varias veces al pasar --set varias veces.

--set-secret

Valor secreto en formato "--set name[=value]". Se admiten varias veces al pasar --set varias veces.

--source-acr-auth-id

Asigne la identidad que se usa para el inicio de sesión del Registro de origen. Use '[llamador]' para la identidad del autor de la llamada.

Propiedad	Valor
Valores aceptados:	[caller], none

--timeout

Tiempo de espera en segundos.

--values

La ruta de acceso del archivo de valores de tarea relativa al contexto de origen.

<SOURCE_LOCATION>

La ruta de acceso del directorio de código fuente local (por ejemplo, "./src" o la dirección URL a un repositorio git (por ejemplo, "https://github.com/Azure-Samples/acr-build-helloworld-node.git" o un tarball remoto (por ejemplo, "http://server/context.tar.gz" o el repositorio de un artefacto OCI en un registro de contenedor de Azure (por ejemplo, "oci://myregistry.azurecr.io/myartifact:mytag"). Si se especifica '/dev/null', el valor se establecerá en Ninguno y se omitirá.

Propiedad	Valor
Grupo de parámetros:	Positional

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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr show

Editar

Obtenga los detalles de un Azure Container Registry.

az acr show --name
            [--resource-group]

Ejemplos

Obtenga el servidor de inicio de sesión de un Azure Container Registry.

az acr show -n myregistry --query loginServer

Obtener los detalles de un Azure Container Registry

az acr show --name myregistry --resource-group MyResourceGroup

Compruebe el estado del permiso de repositorio basado en ABAC en un registro.

az acr show --name myregistry --resource-group MyResourceGroup --query roleAssignmentMode

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

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.

--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 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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr show-endpoints

Editar

Mostrar puntos de conexión del Registro.

az acr show-endpoints --name
                      [--acquire-policy-token]
                      [--change-reference]
                      [--resource-group]

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--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 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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr show-usage

Editar

Obtenga el uso del almacenamiento de un Azure Container Registry.

az acr show-usage --name
                  [--acquire-policy-token]
                  [--change-reference]
                  [--resource-group]

Ejemplos

Obtenga el uso del almacenamiento de un Azure Container Registry.

az acr show-usage -n myregistry

Obtenga la cantidad actual de almacenamiento que usa el Registro en función del almacenamiento incluido de su SKU (en bytes).

az acr show-usage -n myregistry --query "value[?name=='Size'] | [0]"

Obtenga la cantidad actual de almacenamiento que usa el Registro y la capacidad de almacenamiento máxima permitida.

az acr show-usage -n myregistry --query "value[?name=='MaximumStorageCapacity'] | [0]"

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--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 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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az acr update

Editar

Actualice un Azure Container Registry.

az acr update --name
              [--acquire-policy-token]
              [--add]
              [--admin-enabled {false, true}]
              [--allow-exports {false, true}]
              [--allow-metadata-search {false, true}]
              [--allow-trusted-services {false, true}]
              [--anonymous-pull-enabled {false, true}]
              [--change-reference]
              [--data-endpoint-enabled {false, true}]
              [--default-action {Allow, Deny}]
              [--force-string]
              [--public-network-enabled {false, true}]
              [--remove]
              [--resource-group]
              [--role-assignment-mode {rbac, rbac-abac}]
              [--set]
              [--sku {Basic, Premium, Standard}]
              [--tags]

Ejemplos

Actualice las etiquetas de un Azure Container Registry.

az acr update -n myregistry --tags key1=value1 key2=value2

Habilite la cuenta de usuario de administrador para un Azure Container Registry.

az acr update -n myregistry --admin-enabled true

Active el permiso de repositorio basado en ABAC en un registro existente.

az acr update -n myregistry --role-assignment-mode rbac-abac

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

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.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--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>.

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--admin-enabled

Indica si el usuario administrador está habilitado.

Propiedad	Valor
Valores aceptados:	false, true

--allow-exports

Vista previa

Propiedad	Valor
Valores aceptados:	false, true

--allow-metadata-search

Vista previa

Habilite o deshabilite la característica de búsqueda de metadatos para el Registro.

Propiedad	Valor
Valores aceptados:	false, true

--allow-trusted-services

Permitir que los servicios de Azure de confianza accedan a registros restringidos a la red. Para obtener más información, visite https://aka.ms/acr/trusted-services.

Propiedad	Valor
Grupo de parámetros:	Network Rule Arguments
Valores aceptados:	false, true

--anonymous-pull-enabled

Habilite la extracción en todo el registro de clientes no autenticados.

Propiedad	Valor
Valores aceptados:	false, true

--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad	Valor
Grupo de parámetros:	Global Policy Arguments

--data-endpoint-enabled

Habilite el punto de conexión de datos dedicado para la configuración del firewall de cliente.

Propiedad	Valor
Grupo de parámetros:	Network Rule Arguments
Valores aceptados:	false, true

--default-action

Acción predeterminada que se aplicará cuando no coincida ninguna regla. Solo se aplica a la SKU Premium.

Propiedad	Valor
Grupo de parámetros:	Network Rule Arguments
Valores aceptados:	Allow, Deny

--force-string

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

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	False

--public-network-enabled

Permitir el acceso a la red pública para el registro de contenedor.

Propiedad	Valor
Grupo de parámetros:	Network Rule Arguments
Valores aceptados:	false, true

--remove

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

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--resource-group -g

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

--role-assignment-mode

Modo de asignación de roles del Registro. Para obtener más información sobre esta característica, consulte https://aka.ms/acr/auth/abac. El valor predeterminado es rbac.

Propiedad	Valor
Grupo de parámetros:	Permissions and Role Assignment Arguments
Valores aceptados:	rbac, rbac-abac

--set

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

Propiedad	Valor
Grupo de parámetros:	Generic Update Arguments
Valor predeterminado:	[]

--sku

SKU del registro de contenedor.

Propiedad	Valor
Valores aceptados:	Basic, Premium, Standard

--tags

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

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.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

Comentarios

¿Le ha resultado útil esta página?

Compartir a través de

az acr

Comandos

az acr build

Ejemplos

Parámetros requeridos

Parámetros opcionales

az acr check-health

Ejemplos

Parámetros opcionales

az acr check-name

Ejemplos

Parámetros requeridos

Parámetros opcionales

az acr create

Ejemplos

Parámetros requeridos

Parámetros opcionales

az acr delete

Ejemplos

Parámetros requeridos

Parámetros opcionales

az acr import

Ejemplos

Parámetros requeridos

Parámetros opcionales

az acr list

Ejemplos

Parámetros opcionales

az acr login

Ejemplos

Parámetros requeridos

Parámetros opcionales

az acr query

Ejemplos

Parámetros requeridos

Parámetros opcionales

az acr run

Ejemplos

Parámetros requeridos

Parámetros opcionales

az acr show

Ejemplos

Parámetros requeridos

Parámetros opcionales

az acr show-endpoints

Parámetros requeridos

Parámetros opcionales

az acr show-usage

Ejemplos

Parámetros requeridos

Parámetros opcionales

az acr update

Ejemplos

Parámetros requeridos

Parámetros opcionales

Comentarios