Compartilhar via


az acr repository

Gerenciar repositórios (nomes de imagem) para Registros de Contêiner do Azure.

Comandos

Nome Description Tipo Status
az acr repository delete

Exclua um repositório ou imagem em um Registro de Contêiner do Azure.

Núcleo GA
az acr repository list

Listar repositórios em um Registro de Contêiner do Azure.

Núcleo GA
az acr repository list-deleted

Listar repositórios excluídos por software em um Registro de Contêiner do Azure.

Núcleo Versão Prévia
az acr repository show

Obtenha os atributos de um repositório ou imagem em um Registro de Contêiner do Azure.

Núcleo GA
az acr repository show-manifests

Mostrar manifestos de um repositório em um Registro de Contêiner do Azure.

Núcleo Preterido
az acr repository show-tags

Mostrar marcas de um repositório em um Registro de Contêiner do Azure.

Núcleo GA
az acr repository untag

Desmarcar uma imagem em um Registro de Contêiner do Azure.

Núcleo GA
az acr repository update

Atualize os atributos de um repositório ou imagem em um Registro de Contêiner do Azure.

Núcleo GA

az acr repository delete

Exclua um repositório ou imagem em um Registro de Contêiner do Azure.

Esse comando exclui todos os dados de camada associados que não são referenciados por nenhum outro manifesto no registro de contêiner.

az acr repository delete --name
                         [--image]
                         [--password]
                         [--repository]
                         [--suffix]
                         [--username]
                         [--yes]

Exemplos

Excluir um manifesto de imagem por marca. Isso exclui o manifesto referenciado por 'hello-world:latest' e todas as outras tags que fazem referência ao mesmo manifesto.

az acr repository delete -n myregistry --image hello-world:latest

Exclua um manifesto de imagem pelo resumo de manifesto baseado em sha256. Isso exclui o manifesto identificado por 'hello-world@sha256:abc123' e todas as tags que fazem referência ao manifesto.

az acr repository delete -n myregistry --image hello-world@sha256:abc123

Exclua um repositório de um Registro de Contêiner do Azure. Isso exclui todos os manifestos e tags em 'hello-world'.

az acr repository delete -n myregistry --repository hello-world

Parâmetros Exigidos

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

Parâmetros Opcionais

--image -t

O nome da imagem. Pode incluir uma tag no formato 'name:tag' ou resumo no formato 'name@digest'.

--password -p

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

--repository

O nome do repositório.

--suffix

O sufixo do locatário no servidor de logon do Registro. Você pode especificar '--locatário sufixo' se o servidor de login do Registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o Registro a partir de uma assinatura diferente ou se tiver permissão para acessar imagens, mas não a permissão para gerenciar o recurso do Registro.

--username -u

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

--yes -y

Não solicite confirmação.

Valor padrão: False
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az acr repository list

Listar repositórios em um Registro de Contêiner do Azure.

az acr repository list --name
                       [--password]
                       [--suffix]
                       [--top]
                       [--username]

Exemplos

Listar repositórios em um determinado Registro de Contêiner do Azure.

az acr repository list -n myregistry

Parâmetros Exigidos

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

Parâmetros Opcionais

--password -p

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

--suffix

O sufixo do locatário no servidor de logon do Registro. Você pode especificar '--locatário sufixo' se o servidor de login do Registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o Registro a partir de uma assinatura diferente ou se tiver permissão para acessar imagens, mas não a permissão para gerenciar o recurso do Registro.

--top

Limite o número de itens nos resultados.

--username -u

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az acr repository list-deleted

Versão Prévia

Este comando está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

Listar repositórios excluídos por software em um Registro de Contêiner do Azure.

az acr repository list-deleted --name
                               [--password]
                               [--suffix]
                               [--username]

Exemplos

Listar repositórios excluídos por software em um determinado Registro de Contêiner do Azure.

az acr repository list-deleted -n myregistry

Parâmetros Exigidos

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

Parâmetros Opcionais

--password -p

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

--suffix

O sufixo do locatário no servidor de logon do Registro. Você pode especificar '--locatário sufixo' se o servidor de login do Registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o Registro a partir de uma assinatura diferente ou se tiver permissão para acessar imagens, mas não a permissão para gerenciar o recurso do Registro.

--username -u

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az acr repository show

Obtenha os atributos de um repositório ou imagem em um Registro de Contêiner do Azure.

az acr repository show --name
                       [--image]
                       [--password]
                       [--repository]
                       [--suffix]
                       [--username]

Exemplos

Obtenha os atributos do repositório 'hello-world'.

az acr repository show -n myregistry --repository hello-world

Obtenha os atributos da imagem referenciados pela tag 'hello-world:latest'.

az acr repository show -n myregistry --image hello-world:latest

Obtenha os atributos da imagem referenciada pelo resumo 'hello-world@sha256:abc123'.

az acr repository show -n myregistry --image hello-world@sha256:abc123

Parâmetros Exigidos

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

Parâmetros Opcionais

--image -t

O nome da imagem. Pode incluir uma tag no formato 'name:tag' ou resumo no formato 'name@digest'.

--password -p

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

--repository

O nome do repositório.

--suffix

O sufixo do locatário no servidor de logon do Registro. Você pode especificar '--locatário sufixo' se o servidor de login do Registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o Registro a partir de uma assinatura diferente ou se tiver permissão para acessar imagens, mas não a permissão para gerenciar o recurso do Registro.

--username -u

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az acr repository show-manifests

Preterido

Esse comando foi preterido e será removido em uma versão futura. Em vez disso, use 'acr manifest list-metadata'.

Mostrar manifestos de um repositório em um Registro de Contêiner do Azure.

az acr repository show-manifests --name
                                 --repository
                                 [--detail]
                                 [--orderby {time_asc, time_desc}]
                                 [--password]
                                 [--suffix]
                                 [--top]
                                 [--username]

Exemplos

Mostrar manifestos de um repositório em um Registro de Contêiner do Azure.

az acr repository show-manifests -n myregistry --repository MyRepository

Mostrar os 10 manifestos mais recentes ordenados por carimbo de data/hora de um repositório em um Registro de Contêiner do Azure.

az acr repository show-manifests -n myregistry --repository MyRepository --top 10 --orderby time_desc

Mostrar as informações detalhadas dos 10 manifestos mais recentes ordenados por carimbo de data/hora de um repositório em um Registro de Contêiner do Azure.

az acr repository show-manifests -n myregistry --repository MyRepository --top 10 --orderby time_desc --detail

Parâmetros Exigidos

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

--repository

O nome do repositório.

Parâmetros Opcionais

--detail

Mostrar informações detalhadas.

Valor padrão: False
--orderby

Ordene os itens nos resultados. O padrão é a ordem alfabética dos nomes.

Valores aceitos: time_asc, time_desc
--password -p

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

--suffix

O sufixo do locatário no servidor de logon do Registro. Você pode especificar '--locatário sufixo' se o servidor de login do Registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o Registro a partir de uma assinatura diferente ou se tiver permissão para acessar imagens, mas não a permissão para gerenciar o recurso do Registro.

--top

Limite o número de itens nos resultados.

--username -u

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az acr repository show-tags

Mostrar marcas de um repositório em um Registro de Contêiner do Azure.

az acr repository show-tags --name
                            --repository
                            [--detail]
                            [--orderby {time_asc, time_desc}]
                            [--password]
                            [--suffix]
                            [--top]
                            [--username]

Exemplos

Mostrar marcas de um repositório em um Registro de Contêiner do Azure.

az acr repository show-tags -n myregistry --repository MyRepository

Mostrar as informações detalhadas de marcas de um repositório em um Registro de Contêiner do Azure.

az acr repository show-tags -n myregistry --repository MyRepository --detail

Mostrar as informações detalhadas das 10 marcas mais recentes ordenadas por carimbo de data/hora de um repositório em um Registro de Contêiner do Azure.

az acr repository show-tags -n myregistry --repository MyRepository --top 10 --orderby time_desc --detail

Parâmetros Exigidos

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

--repository

O nome do repositório.

Parâmetros Opcionais

--detail

Mostrar informações detalhadas.

Valor padrão: False
--orderby

Ordene os itens nos resultados. O padrão é a ordem alfabética dos nomes.

Valores aceitos: time_asc, time_desc
--password -p

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

--suffix

O sufixo do locatário no servidor de logon do Registro. Você pode especificar '--locatário sufixo' se o servidor de login do Registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o Registro a partir de uma assinatura diferente ou se tiver permissão para acessar imagens, mas não a permissão para gerenciar o recurso do Registro.

--top

Limite o número de itens nos resultados.

--username -u

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az acr repository untag

Desmarcar uma imagem em um Registro de Contêiner do Azure.

Esse comando não exclui o manifesto referenciado pela marca ou quaisquer dados de camada associados.

az acr repository untag --image
                        --name
                        [--password]
                        [--suffix]
                        [--username]

Exemplos

Desmarcar uma imagem de um repositório.

az acr repository untag -n myregistry --image hello-world:latest

Parâmetros Exigidos

--image -t

O nome da imagem. Pode incluir uma tag no formato 'name:tag'.

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

Parâmetros Opcionais

--password -p

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

--suffix

O sufixo do locatário no servidor de logon do Registro. Você pode especificar '--locatário sufixo' se o servidor de login do Registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o Registro a partir de uma assinatura diferente ou se tiver permissão para acessar imagens, mas não a permissão para gerenciar o recurso do Registro.

--username -u

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

Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az acr repository update

Atualize os atributos de um repositório ou imagem em um Registro de Contêiner do Azure.

az acr repository update --name
                         [--delete-enabled {false, true}]
                         [--image]
                         [--list-enabled {false, true}]
                         [--password]
                         [--read-enabled {false, true}]
                         [--repository]
                         [--suffix]
                         [--username]
                         [--write-enabled {false, true}]

Exemplos

Atualize os atributos do repositório 'hello-world' para desativar a operação de gravação.

az acr repository update -n myregistry --repository hello-world --write-enabled false

Atualize os atributos da imagem referenciada pela tag 'hello-world:latest' para desativar a operação de gravação.

az acr repository update -n myregistry --image hello-world:latest --write-enabled false

Atualize os atributos da imagem referenciada pelo resumo 'hello-world@sha256:abc123' para desativar a operação de gravação.

az acr repository update -n myregistry --image hello-world@sha256:abc123 --write-enabled false

Parâmetros Exigidos

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

Parâmetros Opcionais

--delete-enabled

Indica se a operação de exclusão é permitida.

Valores aceitos: false, true
--image -t

O nome da imagem. Pode incluir uma tag no formato 'name:tag' ou resumo no formato 'name@digest'.

--list-enabled

Indica se esse item é exibido nos resultados da operação de lista.

Valores aceitos: false, true
--password -p

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

--read-enabled

Indica se a operação de leitura é permitida.

Valores aceitos: false, true
--repository

O nome do repositório.

--suffix

O sufixo do locatário no servidor de logon do Registro. Você pode especificar '--locatário sufixo' se o servidor de login do Registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o Registro a partir de uma assinatura diferente ou se tiver permissão para acessar imagens, mas não a permissão para gerenciar o recurso do Registro.

--username -u

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

--write-enabled

Indica se a operação de gravação ou exclusão é permitida.

Valores aceitos: false, true
Parâmetros Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc
Valor padrão: json
--query

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

--subscription

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

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.