az acr

Note

Este grupo de comandos tem comandos definidos tanto no CLI do Azure como em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Saiba mais sobre extensões.

Gerencie registos privados com Azure Container Registries.

Comandos

Name	Description	Tipo	Status
az acr agentpool	Gerir pools privados de agentes Tasks com Azure Container Registries.	Core	Preview
az acr agentpool create	Criar um pool de agentes para um Azure Container Registry.	Core	Preview
az acr agentpool delete	Exclua um pool de agentes.	Core	Preview
az acr agentpool list	List the agent pools for an Azure Container Registry.	Core	Preview
az acr agentpool show	Obtenha as propriedades de um pool de agentes especificado para um Azure Container Registry.	Core	Preview
az acr agentpool update	Atualize um pool de agentes para um Azure Container Registry.	Core	Preview
az acr artifact-streaming	Gerencie o streaming de artefatos para quaisquer repositórios ou imagens suportadas em um ACR.	Core	Preview
az acr artifact-streaming create	Crie um artefato de streaming de referência para uma imagem específica em um ACR.	Core	Preview
az acr artifact-streaming operation	Gerencie as operações de criação de artefatos de streaming para o ACR.	Core	Preview
az acr artifact-streaming operation cancel	Cancele a operação de artefato de streaming fornecida para ACR.	Core	Preview
az acr artifact-streaming operation show	Verifique o status da operação para streaming de artefatos em um ACR.	Core	Preview
az acr artifact-streaming show	Mostrar se o streaming de artefactos está ativado num repositório para um Azure Container Registry.	Core	Preview
az acr artifact-streaming update	Habilite ou desabilite a criação automática de artefatos de streaming para imagens recém-enviadas em um determinado registro.	Core	Preview
az acr build	Coloca uma compilação rápida, fornecendo registos de streaming para um Azure Container Registry.	Core	disponibilidade geral
az acr cache	Gerir regras de cache no Azure Container Registries.	Core	disponibilidade geral
az acr cache create	Crie uma regra de cache.	Core	disponibilidade geral
az acr cache delete	Exclua uma regra de cache.	Core	disponibilidade geral
az acr cache list	Listar as regras de cache num Azure Container Registry.	Core	disponibilidade geral
az acr cache show	Mostrar uma regra de cache.	Core	disponibilidade geral
az acr cache update	Atualize o conjunto de credenciais em uma regra de cache.	Core	disponibilidade geral
az acr check-health	Obtém informações de integridade sobre o ambiente e, opcionalmente, um registro de destino.	Core	disponibilidade geral
az acr check-name	Verifica se um nome do Azure Container Registry é válido e está disponível para uso.	Core	disponibilidade geral
az acr config	Configure políticas para Azure Container Registries.	Core	disponibilidade geral
az acr config authentication-as-arm	Gerir a política 'Azure AD authenticate as ARM' para Azure Container Registries.	Core	Preview
az acr config authentication-as-arm show	Mostrar a política configurada 'Azure AD authenticate as ARM' para um Azure Container Registry.	Core	Preview
az acr config authentication-as-arm update	Atualize a política 'Azure AD authenticate as ARM' para um Azure Container Registry.	Core	Preview
az acr config content-trust	Manage content-trust policy for Azure Container Registries.	Core	Deprecated
az acr config content-trust show	Mostrar a política de content-trust configurada para um Azure Container Registry.	Core	Deprecated
az acr config content-trust update	Update content-trust policy for an Azure Container Registry.	Core	disponibilidade geral
az acr config retention	Manage retention policy for Azure Container Registries.	Core	Preview
az acr config retention show	Mostrar a política de retenção configurada para um Azure Container Registry.	Core	Preview
az acr config retention update	Update retention policy for an Azure Container Registry.	Core	Preview
az acr config soft-delete	Gerenciar a política de soft-delete para os Registos de Contentores do Azure.	Core	Preview
az acr config soft-delete show	Mostrar a política de soft-delete configurada para um Azure Container Registry.	Core	Preview
az acr config soft-delete update	Atualizar a política de soft-delete para um Azure Container Registry.	Core	Preview
az acr connected-registry	Gerir recursos de registos ligados com Azure Container Registries.	Core	disponibilidade geral
az acr connected-registry create	Criar um registo conectado para um Azure Container Registry.	Core	disponibilidade geral
az acr connected-registry deactivate	Desative um registo conectado do Azure Container Registry.	Core	disponibilidade geral
az acr connected-registry delete	Eliminar um registo conectado do Azure Container Registry.	Core	disponibilidade geral
az acr connected-registry get-settings	Recupere as informações necessárias para ativar um registro conectado e cria ou gira as credenciais do token de sincronização.	Core	disponibilidade geral
az acr connected-registry list	Listar todos os registros conectados no registro pai atual.	Core	disponibilidade geral
az acr connected-registry list-client-tokens	Liste todos os tokens de cliente associados a um registro conectado específico.	Core	disponibilidade geral
az acr connected-registry permissions	Gerencie as permissões do repositório em vários registros conectados. Consulte https://aka.ms/acr/connected-registry para obter mais informações.	Core	disponibilidade geral
az acr connected-registry permissions show	Mostrar as informações do mapa do escopo de sincronização do Registro conectado.	Core	disponibilidade geral
az acr connected-registry permissions update	Adicione e remova permissões de repositório em todos os mapas de escopo de sincronização de registro conectados necessários.	Core	disponibilidade geral
az acr connected-registry show	Mostrar detalhes do registro conectado.	Core	disponibilidade geral
az acr connected-registry update	Atualize um registo conectado para um Azure Container Registry.	Core	disponibilidade geral
az acr create	Create an Azure Container Registry.	Core	disponibilidade geral
az acr credential	Gerir credenciais de login para Azure Container Registries.	Core	disponibilidade geral
az acr credential-set	Manage credential sets in Azure Container Registries.	Core	disponibilidade geral
az acr credential-set create	Crie um conjunto de credenciais.	Core	disponibilidade geral
az acr credential-set delete	Exclua um conjunto de credenciais.	Core	disponibilidade geral
az acr credential-set list	List the credential sets in an Azure Container Registry.	Core	disponibilidade geral
az acr credential-set show	Mostrar um conjunto de credenciais.	Core	disponibilidade geral
az acr credential-set update	Atualize o nome de utilizador ou palavra-passe do Azure Key Vault secret ID num conjunto de credenciais.	Core	disponibilidade geral
az acr credential renew	Regenerate login credentials for an Azure Container Registry.	Core	disponibilidade geral
az acr credential show	Obtenha as credenciais de login para um Azure Container Registry.	Core	disponibilidade geral
az acr delete	Deletes an Azure Container Registry.	Core	disponibilidade geral
az acr encryption	Gerencie a criptografia do registro do contêiner.	Core	disponibilidade geral
az acr encryption rotate-key	Gire (atualize) a chave de criptografia do registro do contêiner.	Core	disponibilidade geral
az acr encryption show	Mostrar os detalhes de criptografia do registro de contêiner.	Core	disponibilidade geral
az acr export-pipeline	Gerencie pipelines de exportação ACR.	Extension	Preview
az acr export-pipeline create	Crie um pipeline de exportação.	Extension	Preview
az acr export-pipeline delete	Exclua um pipeline de exportação.	Extension	Preview
az acr export-pipeline list	Listar pipelines de exportação em um Registro de Contêiner.	Extension	Preview
az acr export-pipeline show	Mostrar um pipeline de exportação em detalhes.	Extension	Preview
az acr helm	Gerencie os helm charts para Azure Container Registries.	Core	Deprecated
az acr helm delete	Delete a helm chart version in an Azure Container Registry.	Core	Deprecated
az acr helm install-cli	Baixe e instale a ferramenta de linha de comando Helm.	Core	Pré-visualização e preterido
az acr helm list	Liste todos os gráficos helm num Azure Container Registry.	Core	Deprecated
az acr helm push	Empurrar um pacote de helm chart para um Azure Container Registry.	Core	Deprecated
az acr helm repo	Manage helm chart repositories for Azure Container Registries.	Core	Deprecated
az acr helm repo add	Adicione um repositório de gráficos de Helm a partir de um Azure Container Registry através da CLI de Helm.	Core	Deprecated
az acr helm show	Descreva um helm chart num Azure Container Registry.	Core	Deprecated
az acr identity	Gerencie identidades de serviço (gerenciadas) para um registro de contêiner.	Core	disponibilidade geral
az acr identity assign	Atribua uma identidade gerenciada a um registro de contêiner.	Core	disponibilidade geral
az acr identity remove	Remova uma identidade gerenciada de um registro de contêiner.	Core	disponibilidade geral
az acr identity show	Mostrar os detalhes de identidade do registro de contêiner.	Core	disponibilidade geral
az acr import	Importa uma imagem para um Azure Container Registry a partir de outro Container Registry. A importação elimina a necessidade de docker pull, docker tag, docker push. Para imagens maiores, considere usar `--no-wait`.	Core	disponibilidade geral
az acr import-pipeline	Gerencie pipelines de importação ACR.	Extension	Preview
az acr import-pipeline create	Crie um pipeline de importação.	Extension	Preview
az acr import-pipeline delete	Exclua um pipeline de importação.	Extension	Preview
az acr import-pipeline list	Listar pipelines de importação em um Registro de Contêiner.	Extension	Preview
az acr import-pipeline show	Mostrar um pipeline de importação em detalhes.	Extension	Preview
az acr list	Lista todos os registros de contêiner sob a assinatura atual.	Core	disponibilidade geral
az acr login	Inicie sessão num Azure Container Registry através da CLI do Docker.	Core	disponibilidade geral
az acr manifest	Gerir manifestos de artefactos no Azure Container Registries.	Core	Preview
az acr manifest delete	Delete a manifest in an Azure Container Registry.	Core	Preview
az acr manifest list	Liste os manifestos num repositório num Azure Container Registry.	Core	Preview
az acr manifest list-deleted	Liste os manifestos apagados suavemente num repositório num Azure Container Registry.	Core	Preview
az acr manifest list-deleted-tags	Liste as etiquetas soft-deleted num repositório num Azure Container Registry.	Core	Preview
az acr manifest list-metadata	Liste os metadados dos manifestos num repositório num Azure Container Registry.	Core	Preview
az acr manifest list-referrers	Listar os referentes a um manifesto num Azure Container Registry.	Core	Preview
az acr manifest restore	Restaurar um artefacto e etiqueta apagados de forma suave num Azure Container Registry.	Core	Preview
az acr manifest show	Obtenha um manifesto num Azure Container Registry.	Core	Preview
az acr manifest show-metadata	Obtenha os metadados de um artefacto num Azure Container Registry.	Core	Preview
az acr manifest update-metadata	Atualize os metadados manifestos de um artefacto num Azure Container Registry.	Core	Preview
az acr network-rule	Gerir regras de rede para Azure Container Registries.	Core	disponibilidade geral
az acr network-rule add	Adicione uma regra de rede.	Core	disponibilidade geral
az acr network-rule list	Listar regras de rede.	Core	disponibilidade geral
az acr network-rule remove	Remova uma regra de rede.	Core	disponibilidade geral
az acr pack	Gerir tarefas do Azure Container Registry que utilizam Cloud Native Buildpacks.	Core	Preview
az acr pack build	Coloca uma tarefa de build rápida que cria uma aplicação e a coloca num Azure Container Registry.	Core	Preview
az acr pipeline-run	Gerencie as execuções de pipeline de importação e exportação do ACR.	Extension	Preview
az acr pipeline-run clean	Exclua todas as execuções de pipeline com falha no Registro.	Extension	Preview
az acr pipeline-run create	Crie um pipeline-run.	Extension	Preview
az acr pipeline-run delete	Exclua uma execução de pipeline.	Extension	Preview
az acr pipeline-run list	Listar execuções de pipeline de todos os pipelines em um registro de contêiner.	Extension	Preview
az acr pipeline-run show	Mostrar uma execução de pipeline em detalhes.	Extension	Preview
az acr private-endpoint-connection	Gerencie conexões de ponto de extremidade privado do registro de contêiner.	Core	disponibilidade geral
az acr private-endpoint-connection approve	Aprovar uma solicitação de conexão de ponto de extremidade privado para um registro de contêiner.	Core	disponibilidade geral
az acr private-endpoint-connection delete	Exclua uma solicitação de conexão de ponto de extremidade privado para um registro de contêiner.	Core	disponibilidade geral
az acr private-endpoint-connection list	Liste todas as conexões de ponto de extremidade privado para um registro de contêiner.	Core	disponibilidade geral
az acr private-endpoint-connection reject	Rejeitar uma solicitação de conexão de ponto de extremidade privado para um registro de contêiner.	Core	disponibilidade geral
az acr private-endpoint-connection show	Mostrar detalhes da conexão de ponto de extremidade privada de um registro de contêiner.	Core	disponibilidade geral
az acr private-link-resource	Gerencie recursos de link privado do registro.	Core	disponibilidade geral
az acr private-link-resource list	Liste os recursos de link privado suportados para um registro.	Core	disponibilidade geral
az acr query	Consulte o conteúdo em um ACR usando a linguagem de consulta Kusto.	Extension	disponibilidade geral
az acr replication	Gerir regiões geo-replicadas dos Registos de Contentores do Azure.	Core	disponibilidade geral
az acr replication create	Crie uma região replicada para um Azure Container Registry.	Core	disponibilidade geral
az acr replication delete	Eliminar uma região replicada de um Azure Container Registry.	Core	disponibilidade geral
az acr replication list	Liste todas as regiões para um Azure Container Registry geo-replicado.	Core	disponibilidade geral
az acr replication show	Obtenha os detalhes de uma região replicada.	Core	disponibilidade geral
az acr replication update	Atualiza uma replicação.	Core	disponibilidade geral
az acr repository	Gerenciar repositórios (nomes de imagem) para Azure Container Registries.	Core	disponibilidade geral
az acr repository delete	Apagar um repositório ou imagem num Azure Container Registry.	Core	disponibilidade geral
az acr repository list	List repositories in an Azure Container Registry.	Core	disponibilidade geral
az acr repository list-deleted	List soft-deleted repositories in an Azure Container Registry.	Core	Preview
az acr repository show	Obtenha os atributos de um repositório ou imagem num Azure Container Registry.	Core	disponibilidade geral
az acr repository show-tags	Mostrar tags para um repositório num Azure Container Registry.	Core	disponibilidade geral
az acr repository untag	Desetiquetar uma imagem num Azure Container Registry.	Core	disponibilidade geral
az acr repository update	Atualize os atributos de um repositório ou imagem num Azure Container Registry.	Core	disponibilidade geral
az acr run	Filas rápidas que fornecem logs streamed para um Azure Container Registry.	Core	disponibilidade geral
az acr scope-map	Gerir mapas de acesso ao âmbito para registos de contentores do Azure.	Core	disponibilidade geral
az acr scope-map create	Crie um scope map para um Azure Container Registry.	Core	disponibilidade geral
az acr scope-map delete	Delete a scope map for an Azure Container Registry.	Core	disponibilidade geral
az acr scope-map list	Liste todos os scope maps para um Azure Container Registry.	Core	disponibilidade geral
az acr scope-map show	Mostrar detalhes e atributos de um mapa de âmbito para um Azure Container Registry.	Core	disponibilidade geral
az acr scope-map update	Atualize um scope map para um Azure Container Registry.	Core	disponibilidade geral
az acr show	Obtenha os detalhes de um Azure Container Registry.	Core	disponibilidade geral
az acr show-endpoints	Exibir pontos de extremidade do Registro.	Core	disponibilidade geral
az acr show-usage	Obtenha o uso de armazenamento para um Azure Container Registry.	Core	disponibilidade geral
az acr supply-chain	Comandos para gerenciar recursos da cadeia de suprimentos acr.	Extension	Preview
az acr supply-chain workflow	Comandos para gerenciar fluxos de trabalho da cadeia de suprimentos acr.	Extension	Preview
az acr supply-chain workflow cancel-run	Cancele o fluxo de trabalho da cadeia de suprimentos em execução no momento.	Extension	Preview
az acr supply-chain workflow create	Crie um fluxo de trabalho da cadeia de suprimentos acr.	Extension	Preview
az acr supply-chain workflow delete	Exclua o fluxo de trabalho da cadeia de suprimentos acr.	Extension	Preview
az acr supply-chain workflow list	Listar o status das imagens do fluxo de trabalho da cadeia de suprimentos acr.	Extension	Preview
az acr supply-chain workflow show	Mostrar tarefas de fluxo de trabalho da cadeia de suprimentos acr.	Extension	Preview
az acr supply-chain workflow update	Atualizar o fluxo de trabalho da cadeia de suprimentos acr.	Extension	Preview
az acr task	Gerir um conjunto de passos para construção, teste e sistema operativo & Atualização de imagens de contentores do framework usando Azure Container Registries.	Core	disponibilidade geral
az acr task cancel-run	Cancelar uma execução especificada de um Azure Container Registry.	Core	disponibilidade geral
az acr task create	Crie uma série de etapas para criar, testar e corrigir contêineres do OS & Framework. As tarefas suportam gatilhos de confirmações git e atualizações de imagem base.	Core	disponibilidade geral
az acr task credential	Gerencie credenciais para uma tarefa. Consulte https://aka.ms/acr/tasks/cross-registry-authentication para obter mais informações.	Core	disponibilidade geral
az acr task credential add	Adicione uma credencial de login do Registro personalizada à tarefa.	Core	disponibilidade geral
az acr task credential list	Liste todas as credenciais de registro personalizadas para a tarefa.	Core	disponibilidade geral
az acr task credential remove	Remova a credencial de uma tarefa.	Core	disponibilidade geral
az acr task credential update	Atualize a credencial de login do Registro para uma tarefa.	Core	disponibilidade geral
az acr task delete	Delete a task from an Azure Container Registry.	Core	disponibilidade geral
az acr task identity	Identidades gerenciadas para tarefas. Consulte https://aka.ms/acr/tasks/task-create-managed-identity para obter mais informações.	Core	disponibilidade geral
az acr task identity assign	Atualize a identidade gerenciada para uma tarefa.	Core	disponibilidade geral
az acr task identity remove	Remova identidades gerenciadas para uma tarefa.	Core	disponibilidade geral
az acr task identity show	Exiba as identidades gerenciadas para a tarefa.	Core	disponibilidade geral
az acr task list	List the tasks for an Azure Container Registry.	Core	disponibilidade geral
az acr task list-runs	Liste todas as execuções executadas para um Azure Container Registry, com a capacidade de filtrar por uma Tarefa específica.	Core	disponibilidade geral
az acr task logs	Mostrar logs para uma execução específica. Se nenhum run-id for fornecido, mostre os logs da última execução criada.	Core	disponibilidade geral
az acr task run	Acione manualmente uma tarefa que, de outra forma, poderia estar aguardando confirmações do git ou gatilhos de atualização de imagem base.	Core	disponibilidade geral
az acr task show	Obtenha as propriedades de uma tarefa nomeada para um Azure Container Registry.	Core	disponibilidade geral
az acr task show-run	Obtenha as propriedades de uma execução especificada de uma Azure Container Registry Task.	Core	disponibilidade geral
az acr task timer	Gerencie gatilhos de timer para uma tarefa.	Core	disponibilidade geral
az acr task timer add	Adicione um gatilho de temporizador a uma tarefa.	Core	disponibilidade geral
az acr task timer list	Liste todos os gatilhos de temporizador para uma tarefa.	Core	disponibilidade geral
az acr task timer remove	Remova um gatilho de temporizador de uma tarefa.	Core	disponibilidade geral
az acr task timer update	Atualize o gatilho do temporizador para uma tarefa.	Core	disponibilidade geral
az acr task update	Atualizar uma tarefa para um Azure Container Registry.	Core	disponibilidade geral
az acr task update-run	Corrige as propriedades de execução de uma tarefa do Azure Container Registry.	Core	disponibilidade geral
az acr taskrun	Gerir tarefas de execução usando Azure Container Registries.	Core	Preview
az acr taskrun delete	Delete a taskrun from an Azure Container Registry.	Core	Preview
az acr taskrun list	List the taskruns for an Azure Container Registry.	Core	Preview
az acr taskrun logs	Mostrar logs de execução para uma execução de tarefa específica.	Core	Preview
az acr taskrun show	Obtenha as propriedades de uma taskrun nomeada para um Azure Container Registry.	Core	Preview
az acr token	Manage tokens for an Azure Container Registry.	Core	disponibilidade geral
az acr token create	Crie um token associado a um scope map para um Azure Container Registry.	Core	disponibilidade geral
az acr token credential	Manage credentials of a token for an Azure Container Registry.	Core	disponibilidade geral
az acr token credential delete	Exclua uma credencial de token.	Core	disponibilidade geral
az acr token credential generate	Gerar ou substituir uma ou ambas as palavras-passe de um token para um Azure Container Registry. Para usar token e senha para acessar um registro de contêiner, consulte https://aka.ms/acr/repo-permissions.	Core	disponibilidade geral
az acr token delete	Delete a token for an Azure Container Registry.	Core	disponibilidade geral
az acr token list	List all tokens for an Azure Container Registry.	Core	disponibilidade geral
az acr token show	Mostrar detalhes e atributos de um token para um Azure Container Registry.	Core	disponibilidade geral
az acr token update	Atualize um token (substitua o scope map associado) para um Azure Container Registry.	Core	disponibilidade geral
az acr update	Update an Azure Container Registry.	Core	disponibilidade geral
az acr webhook	Manage webhooks for Azure Container Registries.	Core	disponibilidade geral
az acr webhook create	Criar um webhook para um Azure Container Registry.	Core	disponibilidade geral
az acr webhook delete	Delete a webhook de um Azure Container Registry.	Core	disponibilidade geral
az acr webhook get-config	Obtenha o URI de serviço e cabeçalhos personalizados para o webhook.	Core	disponibilidade geral
az acr webhook list	Lista todos os webhooks para um Azure Container Registry.	Core	disponibilidade geral
az acr webhook list-events	Listar eventos recentes para um webhook.	Core	disponibilidade geral
az acr webhook ping	Acione um evento ping para um webhook.	Core	disponibilidade geral
az acr webhook show	Obtenha os detalhes de um webhook.	Core	disponibilidade geral
az acr webhook update	Atualize um webhook.	Core	disponibilidade geral

az acr build

Editar

Coloca uma compilação rápida, fornecendo registos de streaming para um 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]
             []

Exemplos

Enfileire um contexto local como uma compilação do Linux, marque-o e envie-o por push para o registro.

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

Enfileire um contexto local como uma compilação do Linux, marque-o e envie-o por push para o registro sem logs de streaming.

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

Enfileire um contexto local como uma compilação do Linux sem enviá-lo para o registro.

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

Enfileire um contexto local como uma compilação do Linux sem enviá-lo para o registro.

az acr build -r myregistry .

Coloca um contexto remoto do GitHub em fila como uma build do Windows, etiqueta-o e envia-o para o registo.

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

Enfileire uma compilação remota de contexto de artefato OCI.

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

Enfileire um contexto local como uma compilação do Linux na arquitetura arm/v7, marque-o e envie-o por push para o registro.

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

Enfileire um contexto local como uma compilação do Linux, marque-o e envie-o por push para o registro habilitado para permissão de repositório baseado em ABAC e use a identidade Entra do chamador para autenticar com o registro de origem.

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

Parâmetros Obrigatórios

--registry -r

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--agent-pool

Pré-visualizar

O nome do pool de agentes.

--auth-mode

Modo de autenticação do registro de origem.

Propriedade	Valor
Valores aceites:	Default, None

--build-arg

Argumento build no formato '--build-arg name[=value]'. Múltiplos são suportados passando '--build-arg name[=value]' várias vezes. IMPORTANTE: Este parâmetro não deve incluir senhas, tokens de acesso ou informações confidenciais de qualquer tipo. Esse valor de parâmetro será visível para a equipe ACR para fins de depuração.

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--file -f

O caminho relativo do arquivo docker para a pasta raiz do código-fonte. O padrão é 'Dockerfile'.

--image -t

O nome e a tag da imagem usando o formato: '-t repo/image:tag'. Várias tags são suportadas passando -t várias vezes.

--log-template

Pré-visualizar

O repositório e o modelo de tag para executar o artefato de log usando o formato: 'log/repo:tag' (por exemplo, 'acr/logs:{{.Run.ID}}'). Aplicável apenas ao registro habilitado para CMK.

--no-format

Indica se os logs devem ser exibidos em formato bruto.

Propriedade	Valor
Default value:	False

--no-logs

Não mostre logs depois de enfileirar com êxito a compilação.

Propriedade	Valor
Default value:	False

--no-push

Indica se a imagem criada deve ser enviada por push para o registro.

Propriedade	Valor
Default value:	False

--no-wait

Não espere que a compilação seja concluída e retorne imediatamente após enfileirar a compilação.

Propriedade	Valor
Default value:	False

--platform

A plataforma onde build/task é executado, por exemplo, 'windows' e 'linux'. Quando é usado em comandos build, também pode ser especificado no formato 'os/arch/variant' para a imagem resultante. Por exemplo, linux/arm/v7. As partes «arco» e «variante» são opcionais.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--secret-build-arg

Argumento de construção secreto no formato '--secret-build-arg name[=value]'. Múltiplos são suportados passando '--secret-build-arg name[=value]' várias vezes. Esse valor de parâmetro não é exibido para a equipe ACR e é mais adequado para informações confidenciais.

--source-acr-auth-id

Atribua a identidade usada para o login do registro de origem. Use '[chamador]' para a identidade do chamador.

Propriedade	Valor
Valores aceites:	[caller], none

--target

O nome do estágio de construção de destino.

--timeout

O tempo limite em segundos.

<SOURCE_LOCATION>

O caminho do diretório do código-fonte local (por exemplo, './src'), ou o URL para um repositório git (por exemplo, 'https://github.com/Azure-Samples/acr-build-helloworld-node.git') ou um tarball remoto (por exemplo, 'http://server/context.tar.gz'), ou o repositório de um artefacto OCI num registo de contentores Azure (por exemplo, 'oci://myregistry.azurecr.io/myartifact:mytag').

Propriedade	Valor
Grupo de parâmetros:	Positional

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr check-health

Editar

Alteração interruptiva

Remover a validação da versão do cliente Notary na próxima versão de alteração urgente (2.86.0) agendada para maio de 2026. A verificação da versão do cliente Notary deixará de ser realizada como parte do comando *check-health* devido à descontinuação do Docker Content Trust. Para obter mais informações sobre a "Breaking Change", visite https://aka.ms/acr/dctdeprecation.

Obtém informações de integridade sobre o ambiente e, opcionalmente, um registro de destino.

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

Exemplos

Obtém o estado de integridade com o registro de destino 'myregistry', ignorando a confirmação para extrair a imagem.

az acr check-health -n myregistry -y

Obtém o estado de integridade do ambiente, sem parar no primeiro erro.

az acr check-health --ignore-errors

Obtém o estado de integridade com o registro de destino 'myregistry' e verifica as permissões permitidas para o repositório específico 'myrepo'.

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

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--ignore-errors

Forneça todas as verificações de integridade, mesmo se forem encontrados erros.

Propriedade	Valor
Default value:	False

--name -n

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

--repository

O nome do repositório.

--vnet

ID de rede virtual para executar este comando dentro de uma VNET para verificar o roteamento DNS para pontos de extremidade privados.

--yes -y

Não solicite confirmação.

Propriedade	Valor
Default value:	False

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr check-name

Editar

Verifica se um nome do Azure Container Registry é válido e está disponível para uso.

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

Exemplos

Verifique se já existe um nome de registo.

az acr check-name -n doesthisnameexist

Parâmetros Obrigatórios

--name -n

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--dnl-scope

Pré-visualizar

O escopo do rótulo do nome de domínio adicionará um hash ao nome do recurso. O nome do servidor de login resultante estará no formato registry-name-hash.azurecr-io. O padrão é Unsecure.

Propriedade	Valor
Default value:	Unsecure
Valores aceites:	NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr create

Editar

Create an 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}]

Exemplos

Crie um registro de contêiner gerenciado com a SKU padrão.

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

Crie um registro com a permissão de repositório baseada em ABAC habilitada.

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

Parâmetros Obrigatórios

--name -n

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--sku

A SKU do registro de contêiner.

Propriedade	Valor
Valores aceites:	Basic, Premium, Standard

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--admin-enabled

Indica se o usuário administrador está habilitado.

Propriedade	Valor
Default value:	False
Valores aceites:	false, true

--allow-exports

Pré-visualizar

Configure exportPolicy para permitir/não permitir que artefatos sejam exportados deste Registro. Os artefatos podem ser exportados por meio de operações de importação ou transferência. Para mais informações, visite https://aka.ms/acr/export-policy.

Propriedade	Valor
Valores aceites:	false, true

--allow-metadata-search

Pré-visualizar

Habilite ou desabilite o recurso de pesquisa de metadados para o Registro. Se não for especificado, isso será definido como desabilitado por padrão.

Propriedade	Valor
Valores aceites:	false, true

--allow-trusted-services

Permitir que Serviços Azure confiáveis acedam a registos restritos à rede. Para mais informações, visite https://aka.ms/acr/trusted-services. O padrão é permitir.

Propriedade	Valor
Grupo de parâmetros:	Network Rule Arguments
Valores aceites:	false, true

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--default-action

Ação padrão a ser aplicada quando nenhuma regra corresponder. Aplicável apenas a SKU Premium.

Propriedade	Valor
Grupo de parâmetros:	Network Rule Arguments
Valores aceites:	Allow, Deny

--dnl-scope

Pré-visualizar

O escopo do rótulo do nome de domínio adicionará um hash ao nome do recurso. O nome do servidor de login resultante estará no formato registryname-hash.azurecr-io. O padrão é Unsecure.

Propriedade	Valor
Valores aceites:	NoReuse, ResourceGroupReuse, SubscriptionReuse, TenantReuse, Unsecure

--identity

Use o ID ou nome do recurso de identidade gerenciado atribuído se estiver no mesmo grupo de recursos.

Propriedade	Valor
Grupo de parâmetros:	Customer managed key Arguments

--key-encryption-key

Uri da chave do cofre da chave. Para habilitar a rotação automatizada, forneça um uri de chave sem versão. Para rotação manual, forneça um uri de chave versionado.

Propriedade	Valor
Grupo de parâmetros:	Customer managed key Arguments

--location -l

Location. Valores de: az account list-locations. Você pode configurar o local padrão usando az configure --defaults location=<location>.

--public-network-enabled

Permitir acesso à rede pública para o registro de contêiner. O padrão é permitir.

Propriedade	Valor
Grupo de parâmetros:	Network Rule Arguments
Valores aceites:	false, true

--role-assignment-mode

Modo de atribuição de função do Registro. Para obter mais informações sobre esse recurso, consulte https://aka.ms/acr/auth/abac. O padrão é rbac.

Propriedade	Valor
Grupo de parâmetros:	Permissions and Role Assignment Arguments
Valores aceites:	rbac, rbac-abac

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

--workspace

Pré-visualizar

Nome ou ID do espaço de trabalho Log Analytics para enviar registos de diagnóstico. Todos os eventos serão ativados. Você pode usar "az monitor log-analytics workspace create" para criar um. Pode ser aplicada uma faturação adicional.

--zone-redundancy

Pré-visualizar

Indica se a redundância de zona deve ou não ser habilitada para este registro ou replicação. Para obter mais informações, como locais suportados, visite https://aka.ms/acr/az. A redundância de zona não pode ser atualizada. O padrão é 'Desativado'.

Propriedade	Valor
Valores aceites:	Disabled, Enabled

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr delete

Editar

Deletes an Azure Container Registry.

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

Exemplos

Delete an Azure Container Registry.

az acr delete -n myregistry

Parâmetros Obrigatórios

--name -n

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--yes -y

Não solicite confirmação.

Propriedade	Valor
Default value:	False

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr import

Editar

Importa uma imagem para um Azure Container Registry a partir de outro Container Registry. A importação elimina a necessidade de docker pull, docker tag, docker push. Para imagens maiores, considere usar --no-wait.

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

Exemplos

Importe uma imagem de 'sourceregistry' para 'myregistry'. A imagem herda seus nomes de repositório de origem e tag.

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

Importa uma imagem de um repositório público no Docker Hub. A imagem usa o repositório especificado e os nomes das tags.

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

Importe uma imagem de um repositório privado usando seu nome de usuário e senha. Isto aplica-se também a registos fora do Azure.

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

Importa uma imagem de um registo de contentores do Azure numa subscrição diferente.

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 uma imagem sem esperar pela conclusão bem-sucedida. Falhas durante a importação não serão refletidas. Execute 'az acr repository show-tags' para confirmar que a importação foi bem-sucedida.

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

Parâmetros Obrigatórios

--name -n

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

--source

Nome da imagem de origem ou fonte totalmente qualificada que contém o servidor de login do registro. Se --registry for usado, --source sempre será interpretado como uma imagem de origem, mesmo que contenha o servidor de login.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--force

Substitua a tag existente da imagem a ser importada.

Propriedade	Valor
Default value:	False

--image -t

O nome e a tag da imagem usando o formato: '-t repo/image:tag'. Várias tags são suportadas passando -t várias vezes.

--no-wait

Não espere que a importação seja concluída e retorne imediatamente após a fila da importação.

Propriedade	Valor
Default value:	False

--password -p

A senha do registro do contêiner de origem.

--registry -r

O registo de contentores do Azure de origem. Pode ser nome, servidor de login ou ID de recurso do registro de origem.

--repository

O nome do repositório para uma cópia somente manifesto de imagens. Várias cópias suportadas passando --repository várias vezes.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--username -u

O nome de usuário do registro do contêiner de origem.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr list

Editar

Lista todos os registros de contêiner sob a assinatura atual.

az acr list [--resource-group]

Exemplos

Liste registros de contêiner e mostre os resultados em uma tabela, em vários grupos de recursos.

az acr list -o table

Liste registros de contêiner em um grupo de recursos e mostre os resultados em uma tabela.

az acr list -g MyResourceGroup -o table

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

Editar

Inicie sessão num Azure Container Registry através da CLI do Docker.

O Docker deve estar instalado na sua máquina. Uma vez feito, use docker logout <registry url> para sair. (Se você só precisa de um token de atualização e não deseja instalar o Docker, especifique '--expose-token').

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

az acr login -n myregistry

Get an Azure Container Registry access token

az acr login -n myregistry --expose-token

--name -n

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--expose-token -t

Exponha o token de atualização em vez de efetuar login automaticamente por meio da CLI do Docker.

Propriedade	Valor
Default value:	False

--password -p

A senha usada para fazer logon em um registro de contêiner.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--suffix

O sufixo locatário no servidor de login do Registro. Você pode especificar '--suffix tenant' se o seu servidor de login do registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se estiver a aceder ao registo a partir de uma subscrição diferente ou se tiver permissão para aceder a imagens, mas não a permissão para gerir o recurso de registo.

--username -u

O nome de usuário usado para fazer logon em um registro de contêiner.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr query

Consulte o conteúdo em um ACR usando a linguagem de consulta Kusto.

Consulte artefactos e imagens num Azure Container Registry usando a Linguagem de Consulta Kusto. As propriedades de manifesto OCI, como resumo, assunto, anotações, etc., podem ser usadas para consultar, filtrar e ordenar os resultados da pesquisa.

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

Exemplos

Obter um único manifesto

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

Contar todos os manifestos no repositório $RepositoryName

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

Listar todos os manifestos no repositório $RepositoryName por ordem de data de criação

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

Consulta de todos os resumos assinados por $Signature no repositório $RepositoryName

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

Consultar os resumos em um registro usando um token de pulo e classificar por resumo (para resultados com paginação)

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

Parâmetros Obrigatórios

--kql-query -q

A consulta KQL a ser executada.

--name -n

O nome do registro de contêiner contra o qual a consulta é executada.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--password -p

Senha do registro.

--repository

O repositório contra o qual a consulta é executada. Se nenhum repositório for fornecido, a consulta será executada no nível do Registro.

--skip-token

Ignore o token para obter a próxima página da consulta, se aplicável.

--username -u

Nome de utilizador do registo.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr run

Editar

Filas rápidas que fornecem logs streamed para um 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]
           []

Exemplos

Enfileire uma execução para executar um comando de contêiner.

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

Enfileire uma execução com a definição da tarefa a partir da entrada padrão. Ou 'Ctrl + Z' (Windows) ou 'Ctrl + D' (Linux) termina o fluxo de entrada.

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

Enfileire uma execução para executar as tarefas passadas pelo pipe.

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

Enfileire um contexto local, enviado por push para ACR com logs de streaming.

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

Enfileire um contexto git remoto com logs de streaming.

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

Enfileire um contexto git remoto com logs de streaming e execute a tarefa na plataforma Linux.

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

Enfileire um contexto de artefato OCI remoto e execute a tarefa.

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

Enfileire uma execução para executar um comando container em um registro habilitado para Permissão de Repositório baseado em ABAC e use a identidade Entra do chamador para autenticar com o registro de origem.

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

Parâmetros Obrigatórios

--registry -r

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--agent-pool

Pré-visualizar

O nome do pool de agentes.

--auth-mode

Modo de autenticação do registro de origem.

Propriedade	Valor
Valores aceites:	Default, None

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--cmd

Comandos a executar. Isso também suporta parâmetros adicionais de execução do docker (https://docs.docker.com/engine/reference/commandline/run/) ou até mesmo outros comandos do docker (https://docs.docker.com/engine/reference/commandline/docker/).

--file -f

O caminho do arquivo de modelo/definição de tarefa relativo ao contexto de origem. Pode ser '-' para canalizar um arquivo a partir da entrada padrão.

--log-template

Pré-visualizar

O repositório e o modelo de tag para executar o artefato de log usando o formato: 'log/repo:tag' (por exemplo, 'acr/logs:{{.Run.ID}}'). Aplicável apenas ao registro habilitado para CMK.

--no-format

Indica se os logs devem ser exibidos em formato bruto.

Propriedade	Valor
Default value:	False

--no-logs

Não mostre logs depois de enfileirar com êxito a compilação.

Propriedade	Valor
Default value:	False

--no-wait

Não espere que a execução seja concluída e retorne imediatamente após a enfileiramento da corrida.

Propriedade	Valor
Default value:	False

--platform

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--set

Valor no formato 'name[=value]'. Múltiplos suportados pela passagem --set várias vezes.

--set-secret

Valor secreto no formato '--set name[=value]'. Múltiplos suportados pela passagem --set várias vezes.

--source-acr-auth-id

Atribua a identidade usada para o login do registro de origem. Use '[chamador]' para a identidade do chamador.

Propriedade	Valor
Valores aceites:	[caller], none

--timeout

O tempo limite em segundos.

--values

A tarefa valoriza o caminho do arquivo em relação ao contexto de origem.

<SOURCE_LOCATION>

O caminho do diretório do código-fonte local (por exemplo, './src'), ou o URL de um repositório git (por exemplo, 'https://github.com/Azure-Samples/acr-build-helloworld-node.git'), ou um tarball remoto (por exemplo, 'http://server/context.tar.gz'), ou o repositório de um artefacto OCI num registo de contentores Azure (por exemplo, 'oci://myregistry.azurecr.io/myartifact:mytag'). Se '/dev/null' for especificado, o valor será definido como Nenhum e ignorado.

Propriedade	Valor
Grupo de parâmetros:	Positional

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr show

Editar

Obtenha os detalhes de um Azure Container Registry.

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

Exemplos

Obtenha o servidor de login para um Azure Container Registry.

az acr show -n myregistry --query loginServer

Get the details of an Azure Container Registry

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

Verifique o status da permissão de repositório baseada em ABAC em um registro.

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

Parâmetros Obrigatórios

--name -n

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr show-endpoints

Editar

Exibir pontos de extremidade do Registro.

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

Parâmetros Obrigatórios

--name -n

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr show-usage

Editar

Obtenha o uso de armazenamento para um Azure Container Registry.

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

Exemplos

Obtenha o uso de armazenamento para um Azure Container Registry.

az acr show-usage -n myregistry

Obtenha a quantidade atual de armazenamento usada pelo registro com base no armazenamento incluído de sua SKU (em bytes).

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

Obtenha a quantidade atual de armazenamento usada pelo registro e a capacidade máxima de armazenamento permitida.

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

Parâmetros Obrigatórios

--name -n

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

az acr update

Editar

Update an 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]

Exemplos

Update tags for an Azure Container Registry.

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

Ativa a conta de utilizador de administrador para um Azure Container Registry.

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

Ative a Permissão de repositório baseada em ABAC em um registro existente.

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

Parâmetros Obrigatórios

--name -n

O nome do registro de contêiner. Deve ser especificado em minúsculas. Você pode configurar o nome do Registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem tornar-se necessários para que o comando seja executado com êxito.

--acquire-policy-token

Aquisição automática de um token Azure Policy para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string or JSON string>.

Propriedade	Valor
Grupo de parâmetros:	Generic Update Arguments
Default value:	[]

--admin-enabled

Indica se o usuário administrador está habilitado.

Propriedade	Valor
Valores aceites:	false, true

--allow-exports

Pré-visualizar

Propriedade	Valor
Valores aceites:	false, true

--allow-metadata-search

Pré-visualizar

Habilite ou desabilite o recurso de pesquisa de metadados para o Registro.

Propriedade	Valor
Valores aceites:	false, true

--allow-trusted-services

Permitir que Serviços Azure confiáveis acedam a registos restritos à rede. Para mais informações, visite https://aka.ms/acr/trusted-services.

Propriedade	Valor
Grupo de parâmetros:	Network Rule Arguments
Valores aceites:	false, true

--anonymous-pull-enabled

Habilite o pull em todo o Registro de clientes não autenticados.

Propriedade	Valor
Valores aceites:	false, true

--change-reference

O ID de referência de alteração relacionado para esta operação de recurso.

Propriedade	Valor
Grupo de parâmetros:	Global Policy Arguments

--data-endpoint-enabled

Habilite o ponto de extremidade de dados dedicado para a configuração do firewall do cliente.

Propriedade	Valor
Grupo de parâmetros:	Network Rule Arguments
Valores aceites:	false, true

--default-action

Ação padrão a ser aplicada quando nenhuma regra corresponder. Aplicável apenas a SKU Premium.

Propriedade	Valor
Grupo de parâmetros:	Network Rule Arguments
Valores aceites:	Allow, Deny

--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

Propriedade	Valor
Grupo de parâmetros:	Generic Update Arguments
Default value:	False

--public-network-enabled

Permitir acesso à rede pública para o registro de contêiner.

Propriedade	Valor
Grupo de parâmetros:	Network Rule Arguments
Valores aceites:	false, true

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list <indexToRemove> OU --remove propertyToRemove.

Propriedade	Valor
Grupo de parâmetros:	Generic Update Arguments
Default value:	[]

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--role-assignment-mode

Modo de atribuição de função do Registro. Para obter mais informações sobre esse recurso, consulte https://aka.ms/acr/auth/abac. O padrão é rbac.

Propriedade	Valor
Grupo de parâmetros:	Permissions and Role Assignment Arguments
Valores aceites:	rbac, rbac-abac

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=<value>.

Propriedade	Valor
Grupo de parâmetros:	Generic Update Arguments
Default value:	[]

--sku

A SKU do registro de contêiner.

Propriedade	Valor
Valores aceites:	Basic, Premium, Standard

--tags

Tags separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar tags existentes.

Parâmetros de Globais

--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

Propriedade	Valor
Default value:	False

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Default value:	False

--output -o

Formato de saída.

Propriedade	Valor
Default value:	json
Valores aceites:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

Propriedade	Valor
Default value:	False

Comentários

Esta página foi útil?

Partilhar via

az acr

Comandos

az acr build

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr check-health

Exemplos

Parâmetros Opcionais

az acr check-name

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr create

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr delete

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr import

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr list

Exemplos

Parâmetros Opcionais

az acr login

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr query

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr run

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr show

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr show-endpoints

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr show-usage

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

az acr update

Exemplos

Parâmetros Obrigatórios

Parâmetros Opcionais

Comentários