Compartir a través de


az acr connected-registry

Administre los recursos del registro conectados con Azure Container Registries.

Comandos

Nombre Description Tipo Estado
az acr connected-registry create

Cree un registro conectado para una instancia de Azure Container Registry.

Core GA
az acr connected-registry deactivate

Desactive un registro conectado desde Azure Container Registry.

Core GA
az acr connected-registry delete

Elimine un registro conectado de Azure Container Registry.

Core GA
az acr connected-registry get-settings

Recupere la información necesaria para activar un registro conectado y cree o rota las credenciales del token de sincronización.

Core GA
az acr connected-registry list

Enumere todos los registros conectados en el registro primario actual.

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

Enumere todos los tokens de cliente asociados a registros conectados específicos.

Core GA
az acr connected-registry permissions

Administre los permisos del repositorio en varios registros conectados. Consulte https://aka.ms/acr/connected-registry para obtener más información.

Core GA
az acr connected-registry permissions show

Muestra la información del mapa del ámbito de sincronización del registro conectado.

Core GA
az acr connected-registry permissions update

Agregue y quite permisos de repositorio en todas las asignaciones de ámbito de sincronización del registro conectadas necesarias.

Core GA
az acr connected-registry show

Mostrar los detalles del registro conectados.

Core GA
az acr connected-registry update

Actualice un registro conectado para una instancia de Azure Container Registry.

Core GA

az acr connected-registry create

Cree un registro conectado para una instancia de Azure Container Registry.

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]

Ejemplos

Cree un registro conectado en modo registro con acceso a repositorios app/hello-world y service/mycomponent. Creará un token de sincronización y un mapa de ámbito con los permisos de repositorio adecuados.

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

Crear un registro conectado de solo lectura con permisos de lectura y pasar el token de sincronización

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

Cree un registro conectado de solo lectura con tokens de cliente, que se sincronice todos los días a mediados del día y la ventana de sincronización 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 requeridos

--name -n

Nombre del registro conectado. El nombre debe tener entre 5 y 40 caracteres, empezar con una letra y contener solo caracteres alfanuméricos (incluido '_' o '-'). El nombre debe ser único en la jerarquía de ACR en la nube.

--registry -r

Servidor de inicio de sesión del registro de ACR en la nube. Debe ser el FQDN para admitir también Azure Stack.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--client-tokens

Especifique el acceso de cliente a los repositorios del registro conectado. Puede estar en el formato [TOKEN_NAME01] [TOKEN_NAME02]...

--gc-enabled

Indica si la recolección de elementos no utilizados está habilitada. Está habilitada de forma predeterminada.

Propiedad Valor
Valor predeterminado: true
Valores aceptados: false, true
--gc-schedule

Se usa para determinar la programación de recolección de elementos no utilizados. Usa la expresión cron para determinar la programación. Si no se especifica, la recolección de elementos no utilizados se establece para ejecutarse una vez al día.

Propiedad Valor
Valor predeterminado: 0 0 * * *
--log-level

Establezca el nivel de registro para iniciar sesión en la instancia. Los niveles de registro aceptados son Depuración, Información, Advertencia, Error y Ninguno.

Propiedad Valor
Valor predeterminado: Information
--mode -m

Determine el acceso que tendrá cuando se sincronice.

Propiedad Valor
Valor predeterminado: ReadOnly
Valores aceptados: ReadOnly, ReadWrite
--notifications

Lista de patrones de artefactos para los que se deben generar las notificaciones. Use el formato "--notifications [PATTERN1 PATTERN2 ...]".

--parent -p

Nombre del registro conectado primario.

--repository

Especifique los repositorios que deben sincronizarse con el registro conectado. Puede estar en el formato [REPO01] [REPO02]...

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sync-message-ttl

Determine cuánto tiempo se conservarán los mensajes de sincronización en la nube. Usa el formato de duración ISO 8601.

Propiedad Valor
Valor predeterminado: P2D
--sync-schedule -s

Parámetro opcional para definir la programación de sincronización. Usa la expresión cron para determinar la programación. Si no se especifica, la instancia se considera siempre en línea e intenta sincronizarse cada minuto.

Propiedad Valor
Valor predeterminado: * * * * *
--sync-token

Especifica el token de sincronización usado para sincronizar el registro conectado con su elemento primario. La mayoría solo tiene permisos de repositorio y al menos las acciones necesarias para su modo. Puede incluir acceso para varios repositorios.

--sync-window -w

Parámetro obligatorio si --sync-schedule está presente. Se usa para determinar la duración de la programación. Usa el formato de duración ISO 8601.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az acr connected-registry deactivate

Desactive un registro conectado desde Azure Container Registry.

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

Ejemplos

Desactive un registro conectado "myconnectedregistry".

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

Parámetros requeridos

--name -n

Nombre del registro conectado. El nombre debe tener entre 5 y 40 caracteres, empezar con una letra y contener solo caracteres alfanuméricos (incluido '_' o '-'). El nombre debe ser único en la jerarquía de ACR en la nube.

--registry -r

Servidor de inicio de sesión del registro de ACR en la nube. Debe ser el FQDN para admitir también Azure Stack.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az acr connected-registry delete

Elimine un registro conectado de Azure Container Registry.

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

Ejemplos

Elimine un registro conectado de solo lectura "myconnectedregistry" del registro primario "mycloudregistry".

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

Elimine un registro conectado de solo lectura "myconnectedregistry" y el token de sincronización y el mapa de ámbito del registro primario "mycloudregistry".

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

Parámetros requeridos

--name -n

Nombre del registro conectado. El nombre debe tener entre 5 y 40 caracteres, empezar con una letra y contener solo caracteres alfanuméricos (incluido '_' o '-'). El nombre debe ser único en la jerarquía de ACR en la nube.

--registry -r

Servidor de inicio de sesión del registro de ACR en la nube. Debe ser el FQDN para admitir también Azure Stack.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--cleanup

Eliminará el token de sincronización y los recursos de asignación de ámbito.

Propiedad Valor
Valor predeterminado: False
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az acr connected-registry get-settings

Recupere la información necesaria para activar un registro conectado y cree o rota las credenciales del token de sincronización.

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

Ejemplos

Obtenga la información de configuración necesaria para instalar un registro conectado sin la contraseña.

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

Genere una nueva contraseña de token de sincronización 1 o gire la contraseña si ya existe y obtiene la información de configuración necesaria para instalar un registro conectado.

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

Parámetros requeridos

--name -n

Nombre del registro conectado. El nombre debe tener entre 5 y 40 caracteres, empezar con una letra y contener solo caracteres alfanuméricos (incluido '_' o '-'). El nombre debe ser único en la jerarquía de ACR en la nube.

--parent-protocol

Especifique el protocolo usado para comunicarse con su elemento primario.

Propiedad Valor
Valores aceptados: http, https
--registry -r

Servidor de inicio de sesión del registro de ACR en la nube. Debe ser el FQDN para admitir también Azure Stack.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--generate-password

Seleccione la contraseña que desea generar y es necesario recuperar la contraseña del token de sincronización.

Propiedad Valor
Valores aceptados: 1, 2
--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az acr connected-registry list

Enumere todos los registros conectados en el registro primario actual.

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

Ejemplos

Enumere todos los registros conectados de "mycloudregistry" en formato de tabla.

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

Enumere solo los elementos secundarios correctos de "mycloudregistry" en forma expandida en una tabla.

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

Enumere todos los descendientes de "myconnectedregistry" en forma expandida dentro de una tabla.

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

Parámetros requeridos

--registry -r

Servidor de inicio de sesión del registro de ACR en la nube. Debe ser el FQDN para admitir también Azure Stack.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--no-children

Se usa para quitar todos los elementos secundarios de la lista.

Propiedad Valor
Valor predeterminado: False
--parent -p

Nombre del registro conectado primario.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az acr connected-registry list-client-tokens

Enumere todos los tokens de cliente asociados a registros conectados específicos.

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

Ejemplos

Enumere todos los tokens de cliente de "myreadonlyacr".

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

Parámetros requeridos

--name -n

Nombre del registro conectado. El nombre debe tener entre 5 y 40 caracteres, empezar con una letra y contener solo caracteres alfanuméricos (incluido '_' o '-'). El nombre debe ser único en la jerarquía de ACR en la nube.

--registry -r

Servidor de inicio de sesión del registro de ACR en la nube. Debe ser el FQDN para admitir también Azure Stack.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az acr connected-registry show

Mostrar los detalles del registro conectados.

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

Ejemplos

Muestre todos los detalles del registro "myreadonlyacr" en el formulario de tabla.

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

Parámetros requeridos

--name -n

Nombre del registro conectado. El nombre debe tener entre 5 y 40 caracteres, empezar con una letra y contener solo caracteres alfanuméricos (incluido '_' o '-'). El nombre debe ser único en la jerarquía de ACR en la nube.

--registry -r

Servidor de inicio de sesión del registro de ACR en la nube. Debe ser el FQDN para admitir también Azure Stack.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az acr connected-registry update

Actualice un registro conectado para una instancia de Azure Container Registry.

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]

Ejemplos

Actualice los tokens de cliente del Registro conectados.

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

Actualice la sincronización y la hora de ventana de un registro conectado.

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

Parámetros requeridos

--name -n

Nombre del registro conectado. El nombre debe tener entre 5 y 40 caracteres, empezar con una letra y contener solo caracteres alfanuméricos (incluido '_' o '-'). El nombre debe ser único en la jerarquía de ACR en la nube.

--registry -r

Servidor de inicio de sesión del registro de ACR en la nube. Debe ser el FQDN para admitir también Azure Stack.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--add-client-tokens

Tokens de cliente que se van a agregar. Use el formato "--add-client-tokens [TOKEN_NAME1 TOKEN_NAME2 ...]" por identificador de token.

--add-notifications

Lista de patrones de artefacto que se van a agregar a la lista de notificaciones. Use el formato "--add-notifications [PATTERN1 PATTERN2 ...]".

--gc-enabled

Indica si la recolección de elementos no utilizados está habilitada. Está habilitada de forma predeterminada.

Propiedad Valor
Valores aceptados: false, true
--gc-schedule

Se usa para determinar la programación de recolección de elementos no utilizados. Usa la expresión cron para determinar la programación. Si no se especifica, la recolección de elementos no utilizados se establece para ejecutarse una vez al día.

--log-level

Establezca el nivel de registro para iniciar sesión en la instancia. Los niveles de registro aceptados son Depuración, Información, Advertencia, Error y Ninguno.

--remove-client-tokens

Tokens de cliente que se van a quitar. Use el formato "--remove-client-tokens [TOKEN_NAME1 TOKEN_NAME2 ...]" por identificador de token.

--remove-notifications

Lista de patrones de artefacto que se van a quitar de la lista de notificaciones. Use el formato "--remove-notifications [PATTERN1 PATTERN2 ...]".

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--sync-message-ttl

Determine cuánto tiempo se conservarán los mensajes de sincronización en la nube. Usa el formato de duración ISO 8601.

--sync-schedule -s

Parámetro opcional para definir la programación de sincronización. Usa la expresión cron para determinar la programación. Si no se especifica, la instancia se considera siempre en línea e intenta sincronizarse cada minuto.

--sync-window -w

Se usa para determinar la duración de la programación. Usa el formato de duración ISO 8601.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False