Compartilhar via


az acr connected-registry

Gerenciar recursos de registro conectados com Registros de Contêiner do Azure.

Comandos

Nome Description Tipo Status
az acr connected-registry create

Crie um registro conectado para um Registro de Contêiner do Azure.

Core GA
az acr connected-registry deactivate

Desativar um registro conectado do Registro de Contêiner do Azure.

Core GA
az acr connected-registry delete

Exclua um registro conectado do Registro de Contêiner do Azure.

Core GA
az acr connected-registry get-settings

Recupere as informações necessárias para ativar um registro conectado e crie ou gire as credenciais de token de sincronização.

Core GA
az acr connected-registry list

Liste todos os registros conectados no registro pai atual.

Core GA
az acr connected-registry list-client-tokens

Liste todos os tokens de cliente associados a um registro conectado específico.

Core GA
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 GA
az acr connected-registry permissions show

Mostrar as informações do mapa de escopo de sincronização do Registro conectado.

Core GA
az acr connected-registry permissions update

Adicione e remova permissões de repositório em todos os mapas de escopo de sincronização do Registro conectado necessários.

Core GA
az acr connected-registry show

Mostrar detalhes do registro conectado.

Core GA
az acr connected-registry update

Atualize um registro conectado para um Registro de Contêiner do Azure.

Core GA

az acr connected-registry create

Crie um registro conectado para um Registro de Contêiner do Azure.

az acr connected-registry create --name
                                 --registry
                                 [--client-tokens]
                                 [--gc-enabled {false, true}]
                                 [--gc-schedule]
                                 [--log-level]
                                 [--mode {ReadOnly, ReadWrite}]
                                 [--notifications]
                                 [--parent]
                                 [--repository]
                                 [--resource-group]
                                 [--sync-message-ttl]
                                 [--sync-schedule]
                                 [--sync-token]
                                 [--sync-window]
                                 [--yes]

Exemplos

Crie um registro conectado no modo de registro com acesso ao aplicativo repositório/hello-world e service/mycomponent. Ele criará um token de sincronização e um mapa de escopo com as permissões de repositório corretas.

az acr connected-registry create --registry mycloudregistry --name myconnectedregistry \
    --repository "app/hello-world" "service/mycomponent"

Criar um registro conectado somente leitura com permissões de leitura e passar o token de sincronização

az acr connected-registry create --registry mycloudregistry  --name myreadonlyacr \
    --mode readonly --parent myconnectedregistry --sync-token mySyncTokenName

Crie um registro conectado somente leitura com tokens de cliente, que é sincronizado todos os dias na janela midninght e sincronização de 4 horas.

az acr connected-registry create -r mycloudregistry -n myreadonlyacr -p myconnectedregistry \
    --repository "app/mycomponent" -m ReadOnly -s "0 12 * * *" -w PT4H \
    --client-tokens myTokenName1 myTokenName2

Parâmetros Exigidos

--name -n

Nome do registro conectado. O nome deve ter entre 5 a 40 caracteres, começar com uma letra e conter apenas caracteres alfanuméricos (incluindo '_' ou '-'). O nome deve ser exclusivo na hierarquia do ACR de Nuvem.

--registry -r

O servidor de logon do registro do Cloud ACR. Deve ser o FQDN para dar suporte também ao Azure Stack.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--client-tokens

Especifique o acesso do cliente aos repositórios no registro conectado. Pode estar no formato [TOKEN_NAME01] [TOKEN_NAME02]...

--gc-enabled

Indique se a coleta de lixo está habilitada. Ele é habilitado por padrão.

Propriedade Valor
Valor padrão: true
Valores aceitos: false, true
--gc-schedule

Usado para determinar o agendamento de coleta de lixo. Usa a expressão cron para determinar o agendamento. Se não for especificado, a coleta de lixo será definida para ser executada uma vez por dia.

Propriedade Valor
Valor padrão: 0 0 * * *
--log-level

Defina o nível de log para fazer logon na instância. Os níveis de log aceitos são Depuração, Informações, Aviso, Erro e Nenhum.

Propriedade Valor
Valor padrão: Information
--mode -m

Determine o acesso que ele terá quando sincronizado.

Propriedade Valor
Valor padrão: ReadOnly
Valores aceitos: ReadOnly, ReadWrite
--notifications

Lista do padrão de artefato para o qual as notificações precisam ser geradas. Use o formato "--notifications [PATTERN1 PATTERN2 ...]".

--parent -p

O nome do registro conectado pai.

--repository

Especifique os repositórios que precisam ser sincronizados com o registro conectado. Pode estar no formato [REPO01] [REPO02]...

--resource-group -g

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

--sync-message-ttl

Determine por quanto tempo as mensagens de sincronização serão mantidas na nuvem. Usa o formato de duração ISO 8601.

Propriedade Valor
Valor padrão: P2D
--sync-schedule -s

Parâmetro opcional para definir o agendamento de sincronização. Usa a expressão cron para determinar o agendamento. Se não for especificado, a instância será considerada sempre online e tentará sincronizar a cada minuto.

Propriedade Valor
Valor padrão: * * * * *
--sync-token

Especifica o token de sincronização usado para sincronizar o registro conectado com seu pai. Ele tem apenas permissões de repositório e pelo menos as ações necessárias para seu modo. Ele pode incluir acesso para vários repositórios.

--sync-window -w

Parâmetro necessário se --sync-schedule estiver presente. Usado para determinar a duração do agendamento. Usa o formato de duração ISO 8601.

--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 connected-registry deactivate

Desativar um registro conectado do Registro de Contêiner do Azure.

az acr connected-registry deactivate --name
                                     --registry
                                     [--resource-group]
                                     [--yes]

Exemplos

Desativar um registro conectado 'myconnectedregistry'.

az acr connected-registry deactivate -r mycloudregistry -n myconnectedregistry

Parâmetros Exigidos

--name -n

Nome do registro conectado. O nome deve ter entre 5 a 40 caracteres, começar com uma letra e conter apenas caracteres alfanuméricos (incluindo '_' ou '-'). O nome deve ser exclusivo na hierarquia do ACR de Nuvem.

--registry -r

O servidor de logon do registro do Cloud ACR. Deve ser o FQDN para dar suporte também ao Azure Stack.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--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
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 connected-registry delete

Exclua um registro conectado do Registro de Contêiner do Azure.

az acr connected-registry delete --name
                                 --registry
                                 [--cleanup]
                                 [--resource-group]
                                 [--yes]

Exemplos

Exclua um registro conectado somente leitura 'myconnectedregistry' do registro pai 'mycloudregistry'.

az acr connected-registry delete --registry mycloudregistry --name myconnectedregistry

Exclua um registro conectado somente leitura 'myconnectedregistry' e seu token de sincronização e mapa de escopo do registro pai 'mycloudregistry'.

az acr connected-registry delete -r mycloudregistry -n myconnectedregistry --cleanup

Parâmetros Exigidos

--name -n

Nome do registro conectado. O nome deve ter entre 5 a 40 caracteres, começar com uma letra e conter apenas caracteres alfanuméricos (incluindo '_' ou '-'). O nome deve ser exclusivo na hierarquia do ACR de Nuvem.

--registry -r

O servidor de logon do registro do Cloud ACR. Deve ser o FQDN para dar suporte também ao Azure Stack.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--cleanup

Ele excluirá o token de sincronização e os recursos do mapa de escopo.

Propriedade Valor
Valor padrão: False
--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
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 connected-registry get-settings

Recupere as informações necessárias para ativar um registro conectado e crie ou gire as credenciais de token de sincronização.

az acr connected-registry get-settings --name
                                       --parent-protocol {http, https}
                                       --registry
                                       [--generate-password {1, 2}]
                                       [--resource-group]
                                       [--yes]

Exemplos

Obtenha as informações de configurações necessárias para instalar um registro conectado sem a senha.

az acr connected-registry get-settings -r mycloudregistry -n myconnectedregistry --parent-protocol http

Gere uma nova senha de token de sincronização 1 ou gire a senha se ela já existir e obtém as informações de configurações necessárias para instalar um registro conectado.

az acr connected-registry get-settings -r mycloudregistry -n myconnectedregistry --generate-password 1 --parent-protocol https

Parâmetros Exigidos

--name -n

Nome do registro conectado. O nome deve ter entre 5 a 40 caracteres, começar com uma letra e conter apenas caracteres alfanuméricos (incluindo '_' ou '-'). O nome deve ser exclusivo na hierarquia do ACR de Nuvem.

--parent-protocol

Especifique o protocolo usado para se comunicar com seu pai.

Propriedade Valor
Valores aceitos: http, https
--registry -r

O servidor de logon do registro do Cloud ACR. Deve ser o FQDN para dar suporte também ao Azure Stack.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--generate-password

Selecione qual senha você deseja gerar e é necessário recuperar a senha do token de sincronização.

Propriedade Valor
Valores aceitos: 1, 2
--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
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 connected-registry list

Liste todos os registros conectados no registro pai atual.

az acr connected-registry list --registry
                               [--no-children]
                               [--parent]
                               [--resource-group]

Exemplos

Liste todos os registros conectados de 'mycloudregistry' no formato de tabela.

az acr connected-registry list --registry mycloudregistry --output table

Liste apenas os filhos inmediatados de 'mycloudregistry' em forma expandida em uma tabela.

az acr connected-registry list --registry mycloudregistry --no-children --output table

Liste todos os descendentes de "myconnectedregistry" em forma expandida dentro de uma tabela.

az acr connected-registry list -r mycloudregistry -p myconnectedregistry --output table

Parâmetros Exigidos

--registry -r

O servidor de logon do registro do Cloud ACR. Deve ser o FQDN para dar suporte também ao Azure Stack.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-children

Usado para remover todos os filhos da lista.

Propriedade Valor
Valor padrão: False
--parent -p

O nome do registro conectado pai.

--resource-group -g

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

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 connected-registry list-client-tokens

Liste todos os tokens de cliente associados a um registro conectado específico.

az acr connected-registry list-client-tokens --name
                                             --registry
                                             [--resource-group]

Exemplos

Listar todos os tokens de cliente de 'myreadonlyacr'.

az acr connected-registry list-client-tokens -r mycloudregistry -n myreadonlyacr -o table

Parâmetros Exigidos

--name -n

Nome do registro conectado. O nome deve ter entre 5 a 40 caracteres, começar com uma letra e conter apenas caracteres alfanuméricos (incluindo '_' ou '-'). O nome deve ser exclusivo na hierarquia do ACR de Nuvem.

--registry -r

O servidor de logon do registro do Cloud ACR. Deve ser o FQDN para dar suporte também ao Azure Stack.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

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

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 connected-registry show

Mostrar detalhes do registro conectado.

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

Exemplos

Mostre todos os detalhes do registro 'myreadonlyacr' no formulário de tabela.

az acr connected-registry show --registry mycloudregistry --name myreadonlyacr --output table

Parâmetros Exigidos

--name -n

Nome do registro conectado. O nome deve ter entre 5 a 40 caracteres, começar com uma letra e conter apenas caracteres alfanuméricos (incluindo '_' ou '-'). O nome deve ser exclusivo na hierarquia do ACR de Nuvem.

--registry -r

O servidor de logon do registro do Cloud ACR. Deve ser o FQDN para dar suporte também ao Azure Stack.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--resource-group -g

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

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 connected-registry update

Atualize um registro conectado para um Registro de Contêiner do Azure.

az acr connected-registry update --name
                                 --registry
                                 [--add-client-tokens]
                                 [--add-notifications]
                                 [--gc-enabled {false, true}]
                                 [--gc-schedule]
                                 [--log-level]
                                 [--remove-client-tokens]
                                 [--remove-notifications]
                                 [--resource-group]
                                 [--sync-message-ttl]
                                 [--sync-schedule]
                                 [--sync-window]

Exemplos

Atualize os Tokens de cliente do Registro conectado.

az acr connected-registry update --registry mycloudregistry --name myconnectedregistry \
    --remove-client-tokens myTokenName1 --add-client-tokens myTokenName2 myTokenName3

Atualize a sincronização e a hora da janela de um registro conectado.

az acr connected-registry update --registry mycloudregistry --name myreadonlyacr \
    --sync-schedule "0 12 * * *" --sync-window PT4H

Parâmetros Exigidos

--name -n

Nome do registro conectado. O nome deve ter entre 5 a 40 caracteres, começar com uma letra e conter apenas caracteres alfanuméricos (incluindo '_' ou '-'). O nome deve ser exclusivo na hierarquia do ACR de Nuvem.

--registry -r

O servidor de logon do registro do Cloud ACR. Deve ser o FQDN para dar suporte também ao Azure Stack.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--add-client-tokens

Tokens de cliente a serem adicionados. Use o formato "--add-client-tokens [TOKEN_NAME1 TOKEN_NAME2 ...]" por id de token.

--add-notifications

Lista de padrões de artefato a serem adicionados à lista de notificações. Use o formato "--add-notifications [PATTERN1 PATTERN2 ...]".

--gc-enabled

Indique se a coleta de lixo está habilitada. Ele é habilitado por padrão.

Propriedade Valor
Valores aceitos: false, true
--gc-schedule

Usado para determinar o agendamento de coleta de lixo. Usa a expressão cron para determinar o agendamento. Se não for especificado, a coleta de lixo será definida para ser executada uma vez por dia.

--log-level

Defina o nível de log para fazer logon na instância. Os níveis de log aceitos são Depuração, Informações, Aviso, Erro e Nenhum.

--remove-client-tokens

Tokens de cliente a serem removidos. Use o formato "--remove-client-tokens [TOKEN_NAME1 TOKEN_NAME2 ...]" por id de token.

--remove-notifications

Lista de padrões de artefato a serem removidos da lista de notificações. Use o formato "--remove-notifications [PATTERN1 PATTERN2 ...]".

--resource-group -g

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

--sync-message-ttl

Determine por quanto tempo as mensagens de sincronização serão mantidas na nuvem. Usa o formato de duração ISO 8601.

--sync-schedule -s

Parâmetro opcional para definir o agendamento de sincronização. Usa a expressão cron para determinar o agendamento. Se não for especificado, a instância será considerada sempre online e tentará sincronizar a cada minuto.

--sync-window -w

Usado para determinar a duração do agendamento. Usa o formato de duração ISO 8601.

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