az acr repository

  • Riferimento

Gestire i repository (nomi di immagini) per i registri contenitori di Azure.

Comandi

Nome Descrizione Tipo Status
az acr repository delete

Eliminare un repository o un'immagine in un Registro Azure Container.

 Memoria centrale Disponibilità generale
az acr repository list

Elencare i repository in un Registro Azure Container.

 Memoria centrale Disponibilità generale
az acr repository list-deleted

Elencare i repository eliminati soft-delete in un Registro Azure Container.

 Memoria centrale Anteprima
az acr repository show

Ottenere gli attributi di un repository o di un'immagine in un Registro Azure Container.

 Memoria centrale Disponibilità generale
az acr repository show-manifests

Visualizzare i manifesti di un repository in un Registro Azure Container.

 Memoria centrale Deprecato
az acr repository show-tags

Visualizzare i tag per un repository in un Registro Azure Container.

 Memoria centrale Disponibilità generale
az acr repository untag

Annullare il tag di un'immagine in un Registro Azure Container.

 Memoria centrale Disponibilità generale
az acr repository update

Aggiornare gli attributi di un repository o di un'immagine in un Registro Azure Container.

 Memoria centrale Disponibilità generale

az acr repository delete

Modifica

Eliminare un repository o un'immagine in un Registro Azure Container.

Questo comando elimina tutti i dati del livello associati a cui non fa riferimento alcun altro manifesto nel registro contenitori.

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

Esempio

Eliminare un manifesto dell'immagine in base al tag. Questo elimina il manifesto a cui fa riferimento 'hello-world:latest' e tutti gli altri tag che fanno riferimento allo stesso manifesto.

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

Eliminare un manifesto dell'immagine in base al digest del manifesto basato su sha256. Questo elimina il manifesto identificato da 'hello-world@sha256:abc123' e tutti i tag che fanno riferimento al manifesto.

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

Eliminare un repository da un Registro Azure Container. In questo modo vengono eliminati tutti i manifesti e i tag in "hello-world".

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

Parametri necessari

--name -n

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--image -t

Nome dell'immagine. Può includere un tag nel formato 'name:tag' o digest nel formato 'name@digest'.

--password -p

Password usata per accedere a un registro contenitori.

--repository

Nome del repository.

--suffix

Suffisso tenant nel server di accesso del Registro di sistema. È possibile specificare "--suffisso tenant" se il server di accesso del Registro di sistema è nel formato "registry-tenant.azurecr.io". Applicabile se si accede al Registro di sistema da una sottoscrizione diversa o si dispone dell'autorizzazione per accedere alle immagini, ma non l'autorizzazione per gestire la risorsa del Registro di sistema.

--username -u

Nome utente usato per accedere a un registro contenitori.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr repository list

Modifica

Elencare i repository in un Registro Azure Container.

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

Esempio

Elencare i repository in un determinato Registro Azure Container.

az acr repository list -n myregistry

Parametri necessari

--name -n

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--password -p

Password usata per accedere a un registro contenitori.

--suffix

Suffisso tenant nel server di accesso del Registro di sistema. È possibile specificare "--suffisso tenant" se il server di accesso del Registro di sistema è nel formato "registry-tenant.azurecr.io". Applicabile se si accede al Registro di sistema da una sottoscrizione diversa o si dispone dell'autorizzazione per accedere alle immagini, ma non l'autorizzazione per gestire la risorsa del Registro di sistema.

--top

Limitare il numero di elementi nei risultati.

--username -u

Nome utente usato per accedere a un registro contenitori.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr repository list-deleted

Modifica
Anteprima

Questo comando è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare i repository eliminati soft-delete in un Registro Azure Container.

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

Esempio

Elencare i repository eliminati soft in un determinato Registro Azure Container.

az acr repository list-deleted -n myregistry

Parametri necessari

--name -n

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--password -p

Password usata per accedere a un registro contenitori.

--suffix

Suffisso tenant nel server di accesso del Registro di sistema. È possibile specificare "--suffisso tenant" se il server di accesso del Registro di sistema è nel formato "registry-tenant.azurecr.io". Applicabile se si accede al Registro di sistema da una sottoscrizione diversa o si dispone dell'autorizzazione per accedere alle immagini, ma non l'autorizzazione per gestire la risorsa del Registro di sistema.

--username -u

Nome utente usato per accedere a un registro contenitori.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr repository show

Modifica

Ottenere gli attributi di un repository o di un'immagine in un Registro Azure Container.

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

Esempio

Ottenere gli attributi del repository 'hello-world'.

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

Ottenere gli attributi dell'immagine a cui fa riferimento il tag 'hello-world:latest'.

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

Ottenere gli attributi dell'immagine a cui fa riferimento il digest 'hello-world@sha256:abc123'.

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

Parametri necessari

--name -n

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--image -t

Nome dell'immagine. Può includere un tag nel formato 'name:tag' o digest nel formato 'name@digest'.

--password -p

Password usata per accedere a un registro contenitori.

--repository

Nome del repository.

--suffix

Suffisso tenant nel server di accesso del Registro di sistema. È possibile specificare "--suffisso tenant" se il server di accesso del Registro di sistema è nel formato "registry-tenant.azurecr.io". Applicabile se si accede al Registro di sistema da una sottoscrizione diversa o si dispone dell'autorizzazione per accedere alle immagini, ma non l'autorizzazione per gestire la risorsa del Registro di sistema.

--username -u

Nome utente usato per accedere a un registro contenitori.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr repository show-manifests

Modifica
Deprecato

Questo comando è stato deprecato e verrà rimosso in una versione futura. Usare invece 'acr manifest list-metadata'.

Visualizzare i manifesti di un repository in un Registro Azure Container.

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

Esempio

Visualizzare i manifesti di un repository in un Registro Azure Container.

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

Visualizzare i 10 manifesti più recenti ordinati in base al timestamp di un repository in un Registro Azure Container.

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

Visualizzare le informazioni dettagliate dei 10 manifesti più recenti ordinati in base al timestamp di un repository in un Registro Azure Container.

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

Parametri necessari

--name -n

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

--repository

Nome del repository.

Parametri facoltativi

--detail

Mostra informazioni dettagliate.

Valore predefinito: False
--orderby

Ordinare gli elementi nei risultati. L'impostazione predefinita è l'ordine alfabetico dei nomi.

Valori accettati: time_asc, time_desc
--password -p

Password usata per accedere a un registro contenitori.

--suffix

Suffisso tenant nel server di accesso del Registro di sistema. È possibile specificare "--suffisso tenant" se il server di accesso del Registro di sistema è nel formato "registry-tenant.azurecr.io". Applicabile se si accede al Registro di sistema da una sottoscrizione diversa o si dispone dell'autorizzazione per accedere alle immagini, ma non l'autorizzazione per gestire la risorsa del Registro di sistema.

--top

Limitare il numero di elementi nei risultati.

--username -u

Nome utente usato per accedere a un registro contenitori.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr repository show-tags

Modifica

Visualizzare i tag per un repository in un Registro Azure Container.

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

Esempio

Visualizzare i tag di un repository in un Registro Azure Container.

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

Visualizzare le informazioni dettagliate sui tag di un repository in un Registro Azure Container.

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

Visualizzare le informazioni dettagliate dei 10 tag più recenti ordinati in base al timestamp di un repository in un Registro Azure Container.

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

Parametri necessari

--name -n

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

--repository

Nome del repository.

Parametri facoltativi

--detail

Mostra informazioni dettagliate.

Valore predefinito: False
--orderby

Ordinare gli elementi nei risultati. L'impostazione predefinita è l'ordine alfabetico dei nomi.

Valori accettati: time_asc, time_desc
--password -p

Password usata per accedere a un registro contenitori.

--suffix

Suffisso tenant nel server di accesso del Registro di sistema. È possibile specificare "--suffisso tenant" se il server di accesso del Registro di sistema è nel formato "registry-tenant.azurecr.io". Applicabile se si accede al Registro di sistema da una sottoscrizione diversa o si dispone dell'autorizzazione per accedere alle immagini, ma non l'autorizzazione per gestire la risorsa del Registro di sistema.

--top

Limitare il numero di elementi nei risultati.

--username -u

Nome utente usato per accedere a un registro contenitori.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr repository untag

Modifica

Annullare il tag di un'immagine in un Registro Azure Container.

Questo comando non elimina il manifesto a cui fa riferimento il tag o i dati del livello associati.

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

Esempio

Annullare il tag di un'immagine da un repository.

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

Parametri necessari

--image -t

Nome dell'immagine. Può includere un tag nel formato 'name:tag'.

--name -n

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--password -p

Password usata per accedere a un registro contenitori.

--suffix

Suffisso tenant nel server di accesso del Registro di sistema. È possibile specificare "--suffisso tenant" se il server di accesso del Registro di sistema è nel formato "registry-tenant.azurecr.io". Applicabile se si accede al Registro di sistema da una sottoscrizione diversa o si dispone dell'autorizzazione per accedere alle immagini, ma non l'autorizzazione per gestire la risorsa del Registro di sistema.

--username -u

Nome utente usato per accedere a un registro contenitori.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az acr repository update

Modifica

Aggiornare gli attributi di un repository o di un'immagine in un Registro Azure Container.

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

Esempio

Aggiornare gli attributi del repository 'hello-world' per disabilitare l'operazione di scrittura.

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

Aggiornare gli attributi dell'immagine a cui fa riferimento il tag 'hello-world:latest' per disabilitare l'operazione di scrittura.

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

Aggiornare gli attributi dell'immagine a cui fa riferimento il digest 'hello-world@sha256:abc123' per disabilitare l'operazione di scrittura.

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

Parametri necessari

--name -n

Nome del registro contenitori. Deve essere specificato in lettere minuscole. È possibile configurare il nome predefinito del Registro di sistema usando az configure --defaults acr=<registry name>.

Parametri facoltativi

--delete-enabled

Indica se l'operazione di eliminazione è consentita.

Valori accettati: false, true
--image -t

Nome dell'immagine. Può includere un tag nel formato 'name:tag' o digest nel formato 'name@digest'.

--list-enabled

Indica se l'elemento viene visualizzato nei risultati dell'operazione elenco.

Valori accettati: false, true
--password -p

Password usata per accedere a un registro contenitori.

--read-enabled

Indica se l'operazione di lettura è consentita.

Valori accettati: false, true
--repository

Nome del repository.

--suffix

Suffisso tenant nel server di accesso del Registro di sistema. È possibile specificare "--suffisso tenant" se il server di accesso del Registro di sistema è nel formato "registry-tenant.azurecr.io". Applicabile se si accede al Registro di sistema da una sottoscrizione diversa o si dispone dell'autorizzazione per accedere alle immagini, ma non l'autorizzazione per gestire la risorsa del Registro di sistema.

--username -u

Nome utente usato per accedere a un registro contenitori.

--write-enabled

Indica se è consentita l'operazione di scrittura o eliminazione.

Valori accettati: false, true
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.