Partilhar via


az acr repository

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

Comandos

Name Description Tipo Status
az acr repository delete

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

Principal GA
az acr repository list

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

Principal GA
az acr repository list-deleted

Liste repositórios excluídos suavemente em um Registro de Contêiner do Azure.

Principal Pré-visualizar
az acr repository show

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

Principal GA
az acr repository show-manifests

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

Principal Preterido
az acr repository show-tags

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

Principal GA
az acr repository untag

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

Principal GA
az acr repository update

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

Principal GA

az acr repository delete

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

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

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

Exemplos

Exclua um manifesto de imagem por tag. 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 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

--image -t

O nome da imagem. Pode incluir uma tag no formato 'name:tag' ou resumir 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 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.

--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 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

--password -p

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

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

--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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az acr repository list-deleted

Pré-visualizar

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

Liste repositórios excluídos suavemente em um Registro de Contêiner do Azure.

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

Exemplos

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

az acr repository list-deleted -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

--password -p

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 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

--image -t

O nome da imagem. Pode incluir uma tag no formato 'name:tag' ou resumir 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 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.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az acr repository show-manifests

Preterido

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

--repository

O nome do repositório.

Parâmetros Opcionais

--detail

Mostrar informações detalhadas.

Default value: False
--orderby

Ordene os itens nos resultados. Padrão para ordem alfabética de nomes.

Valores aceites: time_asc, time_desc
--password -p

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

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

--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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az acr repository show-tags

Mostrar marcas para 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 tags 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 tags 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 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>.

--repository

O nome do repositório.

Parâmetros Opcionais

--detail

Mostrar informações detalhadas.

Default value: False
--orderby

Ordene os itens nos resultados. Padrão para ordem alfabética de nomes.

Valores aceites: time_asc, time_desc
--password -p

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

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

--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 de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az acr repository untag

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

Este comando não exclui o manifesto referenciado pela tag ou quaisquer dados de camada associados.

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

Exemplos

Desmarque uma imagem de um repositório.

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

Parâmetros Obrigatórios

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

Parâmetros Opcionais

--password -p

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

Aumente a verbosidade do registro. 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 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

--delete-enabled

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

Valores aceites: false, true
--image -t

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

--list-enabled

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

Valores aceites: 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 aceites: false, true
--repository

O nome do repositório.

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

--write-enabled

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

Valores aceites: false, true
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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