az acr repository

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

Comandos

Nombre	Description	Tipo	Estado
az acr repository delete	Elimina un repositorio o una imagen de una instancia de Azure Container Registry.	Principal	GA
az acr repository list	Enumera los repositorios de una instancia de Azure Container Registry.	Principal	GA
az acr repository list-deleted	Enumeración de repositorios eliminados temporalmente en una instancia de Azure Container Registry.	Principal	Vista previa
az acr repository show	Obtiene los atributos de un repositorio o una imagen en una instancia de Azure Container Registry.	Principal	GA
az acr repository show-manifests	Muestra los manifiestos de un repositorio en una instancia de Azure Container Registry.	Principal	Obsoleto
az acr repository show-tags	Muestra las etiquetas de un repositorio en una instancia de Azure Container Registry.	Principal	GA
az acr repository untag	Quita la etiqueta de una imagen en una instancia de Azure Container Registry.	Principal	GA
az acr repository update	Actualiza los atributos de un repositorio o una imagen en una instancia de Azure Container Registry.	Principal	GA

az acr repository delete

Elimina un repositorio o una imagen de 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

El 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az acr repository show

Obtiene los atributos de un repositorio o una 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

El 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az acr repository show-manifests

Obsoleto

Este comando ha quedado en desuso y se quitará en una versión futura. Use "acr manifest list-metadata" en su lugar.

Muestra los manifiestos de un repositorio en una instancia de Azure Container Registry.

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

Ejemplos

Muestra los manifiestos de un repositorio en una instancia de Azure Container Registry.

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

Muestre los últimos 10 manifiestos ordenados por marca de tiempo de un repositorio en una instancia de Azure Container Registry.

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

Muestre la información detallada de los últimos 10 manifiestos ordenados por marca de tiempo de un repositorio en una instancia de Azure Container Registry.

az acr repository show-manifests -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

El 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az acr repository show-tags

Muestra las etiquetas de 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

El 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az acr repository untag

Quita 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az acr repository update

Actualiza los atributos de un repositorio o una 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

El 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Valor predeterminado: json

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.