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.

 Core GA
az acr repository list

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

 Core GA
az acr repository list-deleted

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

 Core Preview
az acr repository show

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

 Core GA
az acr repository show-tags

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

 Core GA
az acr repository untag

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

 Core GA
az acr repository update

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

 Core GA

az acr repository delete

Editar

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

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

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

Exclua um manifesto de imagem por resumo de manifesto baseado em sha256. Isso exclui o manifesto identificado por 'hello-world@sha256:abc123' e todas as marcas 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 marcas em 'hello-world'.

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

Parâmetros Exigidos

--name -n

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--image -t

O nome da imagem. Pode incluir uma marca no formato 'name:tag' ou digest 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 de locatário no servidor de logon do Registro. Você poderá especificar '--locatário do sufixo' se o servidor de logon do registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o registro de uma assinatura diferente ou 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.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr repository list

Editar

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. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--password -p

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

--suffix

O sufixo de locatário no servidor de logon do Registro. Você poderá especificar '--locatário do sufixo' se o servidor de logon do registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o registro de uma assinatura diferente ou 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr repository list-deleted

Editar
Versão Prévia

Esse comando está em versão prévia e em desenvolvimento. Níveis de referência e suporte: https://aka.ms/CLI_refstatus

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

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

Exemplos

Listar repositórios excluídos suavemente 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. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--password -p

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

--suffix

O sufixo de locatário no servidor de logon do Registro. Você poderá especificar '--locatário do sufixo' se o servidor de logon do registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o registro de uma assinatura diferente ou 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr repository show

Editar

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 referenciada pela marca '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. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--image -t

O nome da imagem. Pode incluir uma marca no formato 'name:tag' ou digest 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 de locatário no servidor de logon do Registro. Você poderá especificar '--locatário do sufixo' se o servidor de logon do registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o registro de uma assinatura diferente ou 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr repository show-tags

Editar

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

Mostre 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

Mostre as informações detalhadas das 10 marcas mais recentes ordenadas pelo 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. Ele deve ser especificado em letras 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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detail

Mostrar informações detalhadas.

Propriedade Valor
Valor padrão: False
--orderby

Peça os itens nos resultados. Padrão para ordem alfabética de nomes.

Propriedade Valor
Valores aceitos: time_asc, time_desc
--password -p

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

--suffix

O sufixo de locatário no servidor de logon do Registro. Você poderá especificar '--locatário do sufixo' se o servidor de logon do registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o registro de uma assinatura diferente ou 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr repository untag

Editar

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

Esse comando não exclui o manifesto referenciado pela marca ou pelos 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 Exigidos

--image -t

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

--name -n

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

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--password -p

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

--suffix

O sufixo de locatário no servidor de logon do Registro. Você poderá especificar '--locatário do sufixo' se o servidor de logon do registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o registro de uma assinatura diferente ou 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 a verbosidade de log para mostrar todos os logs de depuração.

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False

az acr repository update

Editar

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 desabilitar 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 marca 'hello-world:latest' para desabilitar 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 desabilitar 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. Ele deve ser especificado em letras minúsculas. Você pode configurar o nome do registro padrão usando az configure --defaults acr=<registry name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--delete-enabled

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

Propriedade Valor
Valores aceitos: false, true
--image -t

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

--list-enabled

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

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

Propriedade Valor
Valores aceitos: false, true
--repository

O nome do repositório.

--suffix

O sufixo de locatário no servidor de logon do Registro. Você poderá especificar '--locatário do sufixo' se o servidor de logon do registro estiver no formato 'registry-tenant.azurecr.io'. Aplicável se você estiver acessando o registro de uma assinatura diferente ou 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.

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

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

Propriedade Valor
Valor padrão: False
--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade Valor
Valor padrão: False
--output -o

Formato de saída.

Propriedade Valor
Valor padrão: json
Valores aceitos: 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 assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

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

Propriedade Valor
Valor padrão: False