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
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.
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.
Especifique el acceso de cliente a los repositorios del registro conectado. Puede estar en el formato [TOKEN_NAME01] [TOKEN_NAME02]...
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 |
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 * * * |
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 |
Determine el acceso que tendrá cuando se sincronice.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | ReadOnly |
| Valores aceptados: | ReadOnly, ReadWrite |
Lista de patrones de artefactos para los que se deben generar las notificaciones. Use el formato "--notifications [PATTERN1 PATTERN2 ...]".
Nombre del registro conectado primario.
Especifique los repositorios que deben sincronizarse con el registro conectado. Puede estar en el formato [REPO01] [REPO02]...
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
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 |
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: | * * * * * |
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.
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.
No solicita confirmación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
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.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
No solicita confirmación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
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.
Eliminará el token de sincronización y los recursos de asignación de ámbito.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
No solicita confirmación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
Especifique el protocolo usado para comunicarse con su elemento primario.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | http, https |
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.
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 |
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
No solicita confirmación.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
Se usa para quitar todos los elementos secundarios de la lista.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Nombre del registro conectado primario.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
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.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
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.
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
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
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.
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.
Tokens de cliente que se van a agregar. Use el formato "--add-client-tokens [TOKEN_NAME1 TOKEN_NAME2 ...]" por identificador de token.
Lista de patrones de artefacto que se van a agregar a la lista de notificaciones. Use el formato "--add-notifications [PATTERN1 PATTERN2 ...]".
Indica si la recolección de elementos no utilizados está habilitada. Está habilitada de forma predeterminada.
| Propiedad | Valor |
|---|---|
| Valores aceptados: | false, true |
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.
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.
Tokens de cliente que se van a quitar. Use el formato "--remove-client-tokens [TOKEN_NAME1 TOKEN_NAME2 ...]" por identificador de token.
Lista de patrones de artefacto que se van a quitar de la lista de notificaciones. Use el formato "--remove-notifications [PATTERN1 PATTERN2 ...]".
Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.
Determine cuánto tiempo se conservarán los mensajes de sincronización en la nube. Usa el formato de duración ISO 8601.
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.
Se usa para determinar la duración de la programación. Usa el formato de duración ISO 8601.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |
Formato de salida.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | json |
| Valores aceptados: | json, jsonc, none, table, tsv, yaml, yamlc |
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
| Propiedad | Valor |
|---|---|
| Valor predeterminado: | False |