az acr repository

Administrar repositorios (nombres de imagen) para Azure Container Registries.

Comandos

Nombre	Description	Tipo	Estado
az acr repository delete	Elimine un repositorio o una imagen en una instancia de Azure Container Registry.	Núcleo	GA
az acr repository list	Enumera los repositorios de una instancia de Azure Container Registry.	Núcleo	GA
az acr repository list-deleted	Enumeración de repositorios eliminados temporalmente en una instancia de Azure Container Registry.	Núcleo	Versión preliminar
az acr repository show	Obtenga los atributos de un repositorio o imagen en una instancia de Azure Container Registry.	Núcleo	GA
az acr repository show-tags	Mostrar etiquetas para un repositorio en una instancia de Azure Container Registry.	Núcleo	GA
az acr repository untag	Anulación de la etiqueta de una imagen en Una instancia de Azure Container Registry.	Núcleo	GA
az acr repository update	Actualice los atributos de un repositorio o imagen en una instancia de Azure Container Registry.	Núcleo	GA

az acr repository delete

Elimine un repositorio o una imagen en una instancia de Azure Container Registry.

Este comando elimina todos los datos de capa asociados a los que no hace referencia ningún otro manifiesto del registro de contenedor.

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

Ejemplos

Elimine un manifiesto de imagen por etiqueta. Esto elimina el manifiesto al que hace referencia "hello-world:latest" y todas las demás etiquetas que hacen referencia al mismo manifiesto.

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

Elimine un manifiesto de imagen mediante el resumen de manifiesto basado en sha256. Esto elimina el manifiesto identificado por "hello-world@sha256:abc123" y todas las etiquetas que hacen referencia al manifiesto.

az acr repository delete -n myregistry --image hello-world@sha256:abc123

Elimine un repositorio de una instancia de Azure Container Registry. Esto elimina todos los manifiestos y etiquetas en "hello-world".

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

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--image -t

Nombre de la imagen. Puede incluir una etiqueta en el formato "name:tag" o resumen en el formato "name@digest".

--password -p

Contraseña usada para iniciar sesión en un registro de contenedor.

--repository

Nombre del repositorio.

--suffix

Sufijo de inquilino en el servidor de inicio de sesión del Registro. Puede especificar "--suffix tenant" si el servidor de inicio de sesión del Registro tiene el formato "registry-tenant.azurecr.io". Aplicable si tiene acceso al registro desde una suscripción diferente o tiene permiso para acceder a imágenes, pero no al permiso para administrar el recurso del Registro.

--username -u

Nombre de usuario que se usa para iniciar sesión en un registro de contenedor.

--yes -y

No solicita confirmación.

Valor predeterminado: False

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

az acr repository list

Enumera los repositorios de una instancia de Azure Container Registry.

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

Ejemplos

Enumera los repositorios de una instancia de Azure Container Registry determinada.

az acr repository list -n myregistry

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--password -p

Contraseña usada para iniciar sesión en un registro de contenedor.

--suffix

Sufijo de inquilino en el servidor de inicio de sesión del Registro. Puede especificar "--suffix tenant" si el servidor de inicio de sesión del Registro tiene el formato "registry-tenant.azurecr.io". Aplicable si tiene acceso al registro desde una suscripción diferente o tiene permiso para acceder a imágenes, pero no al permiso para administrar el recurso del Registro.

--top

Limite el número de elementos de los resultados.

--username -u

Nombre de usuario que se usa para iniciar sesión en un registro de contenedor.

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

az acr repository list-deleted

Vista previa

Este comando está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumeración de repositorios eliminados temporalmente en una instancia de Azure Container Registry.

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

Ejemplos

Enumeración de repositorios eliminados temporalmente en una instancia determinada de Azure Container Registry.

az acr repository list-deleted -n myregistry

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--password -p

Contraseña usada para iniciar sesión en un registro de contenedor.

--suffix

Sufijo de inquilino en el servidor de inicio de sesión del Registro. Puede especificar "--suffix tenant" si el servidor de inicio de sesión del Registro tiene el formato "registry-tenant.azurecr.io". Aplicable si tiene acceso al registro desde una suscripción diferente o tiene permiso para acceder a imágenes, pero no al permiso para administrar el recurso del Registro.

--username -u

Nombre de usuario que se usa para iniciar sesión en un registro de contenedor.

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

az acr repository show

Obtenga los atributos de un repositorio o imagen en una instancia de Azure Container Registry.

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

Ejemplos

Obtenga los atributos del repositorio "hello-world".

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

Obtenga los atributos de la imagen a la que hace referencia la etiqueta "hello-world:latest".

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

Obtenga los atributos de la imagen a la que hace referencia el resumen "hello-world@sha256:abc123".

az acr repository show -n myregistry --image hello-world@sha256:abc123

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--image -t

Nombre de la imagen. Puede incluir una etiqueta en el formato "name:tag" o resumen en el formato "name@digest".

--password -p

Contraseña usada para iniciar sesión en un registro de contenedor.

--repository

Nombre del repositorio.

--suffix

Sufijo de inquilino en el servidor de inicio de sesión del Registro. Puede especificar "--suffix tenant" si el servidor de inicio de sesión del Registro tiene el formato "registry-tenant.azurecr.io". Aplicable si tiene acceso al registro desde una suscripción diferente o tiene permiso para acceder a imágenes, pero no al permiso para administrar el recurso del Registro.

--username -u

Nombre de usuario que se usa para iniciar sesión en un registro de contenedor.

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

az acr repository show-tags

Mostrar etiquetas para un repositorio en una instancia de Azure Container Registry.

az acr repository show-tags --name
                            --repository
                            [--detail]
                            [--orderby {time_asc, time_desc}]
                            [--password]
                            [--suffix]
                            [--top]
                            [--username]

Ejemplos

Mostrar etiquetas de un repositorio en una instancia de Azure Container Registry.

az acr repository show-tags -n myregistry --repository MyRepository

Muestre la información detallada de las etiquetas de un repositorio en una instancia de Azure Container Registry.

az acr repository show-tags -n myregistry --repository MyRepository --detail

Muestre la información detallada de las 10 etiquetas más recientes ordenadas por marca de tiempo de un repositorio en una instancia de Azure Container Registry.

az acr repository show-tags -n myregistry --repository MyRepository --top 10 --orderby time_desc --detail

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

--repository

Nombre del repositorio.

Parámetros opcionales

--detail

Mostrar información detallada.

Valor predeterminado: False

--orderby

Ordene los elementos en los resultados. El valor predeterminado es el orden alfabético de los nombres.

Valores aceptados: time_asc, time_desc

--password -p

Contraseña usada para iniciar sesión en un registro de contenedor.

--suffix

Sufijo de inquilino en el servidor de inicio de sesión del Registro. Puede especificar "--suffix tenant" si el servidor de inicio de sesión del Registro tiene el formato "registry-tenant.azurecr.io". Aplicable si tiene acceso al registro desde una suscripción diferente o tiene permiso para acceder a imágenes, pero no al permiso para administrar el recurso del Registro.

--top

Limite el número de elementos de los resultados.

--username -u

Nombre de usuario que se usa para iniciar sesión en un registro de contenedor.

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

az acr repository untag

Anulación de la etiqueta de una imagen en Una instancia de Azure Container Registry.

Este comando no elimina el manifiesto al que hace referencia la etiqueta ni los datos de capa asociados.

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

Ejemplos

Anulación de la etiqueta de una imagen de un repositorio.

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

Parámetros requeridos

--image -t

Nombre de la imagen. Puede incluir una etiqueta con el formato "name:tag".

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--password -p

Contraseña usada para iniciar sesión en un registro de contenedor.

--suffix

Sufijo de inquilino en el servidor de inicio de sesión del Registro. Puede especificar "--suffix tenant" si el servidor de inicio de sesión del Registro tiene el formato "registry-tenant.azurecr.io". Aplicable si tiene acceso al registro desde una suscripción diferente o tiene permiso para acceder a imágenes, pero no al permiso para administrar el recurso del Registro.

--username -u

Nombre de usuario que se usa para iniciar sesión en un registro de contenedor.

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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

az acr repository update

Actualice los atributos de un repositorio o imagen en una instancia de Azure Container Registry.

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}]

Ejemplos

Actualice los atributos del repositorio "hello-world" para deshabilitar la operación de escritura.

az acr repository update -n myregistry --repository hello-world --write-enabled false

Actualice los atributos de la imagen a la que hace referencia la etiqueta "hello-world:latest" para deshabilitar la operación de escritura.

az acr repository update -n myregistry --image hello-world:latest --write-enabled false

Actualice los atributos de la imagen a la que hace referencia el resumen "hello-world@sha256:abc123" para deshabilitar la operación de escritura.

az acr repository update -n myregistry --image hello-world@sha256:abc123 --write-enabled false

Parámetros requeridos

--name -n

Nombre del registro de contenedor. Debe especificarse en minúsculas. Puede configurar el nombre del Registro predeterminado mediante az configure --defaults acr=<registry name>.

Parámetros opcionales

--delete-enabled

Indica si se permite la operación de eliminación.

Valores aceptados: false, true

--image -t

Nombre de la imagen. Puede incluir una etiqueta en el formato "name:tag" o resumen en el formato "name@digest".

--list-enabled

Indica si este elemento se muestra en los resultados de la operación de lista.

Valores aceptados: false, true

--password -p

Contraseña usada para iniciar sesión en un registro de contenedor.

--read-enabled

Indica si se permite la operación de lectura.

Valores aceptados: false, true

--repository

Nombre del repositorio.

--suffix

Sufijo de inquilino en el servidor de inicio de sesión del Registro. Puede especificar "--suffix tenant" si el servidor de inicio de sesión del Registro tiene el formato "registry-tenant.azurecr.io". Aplicable si tiene acceso al registro desde una suscripción diferente o tiene permiso para acceder a imágenes, pero no al permiso para administrar el recurso del Registro.

--username -u

Nombre de usuario que se usa para iniciar sesión en un registro de contenedor.

--write-enabled

Indica si se permite la operación de escritura o eliminación.

Valores aceptados: false, true

Parámetros globales

--debug

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

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

--output -o

Formato de salida.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc

Valor predeterminado: json

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