Freigeben über


az acr repository

Verwalten von Repositorys (Imagenamen) für Azure Container-Registrierungen.

Befehle

Name Beschreibung Typ Status
az acr repository delete

Löscht ein Repository oder Image in einer Azure Container Registry-Instanz.

Kernspeicher Allgemein verfügbar
az acr repository list

Listet Repositorys in einer Azure Container Registry-Instanz auf.

Kernspeicher Allgemein verfügbar
az acr repository list-deleted

Auflisten vorläufig gelöschter Repositorys in einer Azure-Containerregistrierung.

Kernspeicher Vorschau
az acr repository show

Ruft die Attribute eines Repositorys oder Images in einer Azure Container Registry-Instanz ab.

Kernspeicher Allgemein verfügbar
az acr repository show-manifests

Zeigt Manifeste eines Repositorys in einer Azure Container Registry-Instanz an.

Kernspeicher Als veraltet markiert
az acr repository show-tags

Zeigt Tags für ein Repository in einer Azure Container Registry-Instanz an.

Kernspeicher Allgemein verfügbar
az acr repository untag

Hebt Tags von einem Image in einer Azure Container Registry-Instanz auf.

Kernspeicher Allgemein verfügbar
az acr repository update

Aktualisiert die Attribute eines Repositorys oder Images in einer Azure Container Registry-Instanz.

Kernspeicher Allgemein verfügbar

az acr repository delete

Löscht ein Repository oder Image in einer Azure Container Registry-Instanz.

Mit diesem Befehl werden alle zugeordneten Layerdaten gelöscht, auf die in der Containerregistrierung nicht auf ein anderes Manifest verwiesen wird.

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

Beispiele

Löschen Sie ein Bildmanifest nach Tag. Dadurch wird das Manifest gelöscht, auf das durch "hello-world:latest" verwiesen wird, und alle anderen Tags, die auf dasselbe Manifest verweisen.

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

Löschen Sie ein Bildmanifest anhand des sha256-basierten Manifestdigests. Dadurch wird das durch "hello-world@sha256:abc123" identifizierte Manifest gelöscht, und alle Tags, die auf das Manifest verweisen.

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

Löschen Eines Repositorys aus einer Azure-Containerregistrierung. Dadurch werden alle Manifeste und Tags unter "hello-world" gelöscht.

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

Erforderliche Parameter

--name -n

Der Name der Containerregistrierung. Er sollte in Kleinbuchstaben angegeben werden. Sie können den Standardregistrierungsnamen mithilfe von az configure --defaults acr=<registry name>.

Optionale Parameter

--image -t

Der Name des Bildes. Kann ein Tag im Format "name:tag" oder Digest im Format "name@digest" enthalten.

--password -p

Das Zum Anmelden bei einer Containerregistrierung verwendete Kennwort.

--repository

Der Name des Repositorys.

--suffix

Das Mandantensuffix im Registrierungsanmeldungsserver. Sie können "--Suffix-Mandant" angeben, wenn sich ihr Registrierungsanmeldungsserver im Format "registry-tenant.azurecr.io" befindet. Anwendbar, wenn Sie von einem anderen Abonnement aus auf die Registrierung zugreifen oder über die Berechtigung zum Zugreifen auf Bilder verfügen, aber nicht über die Berechtigung zum Verwalten der Registrierungsressource.

--username -u

Der Benutzername, der zum Anmelden bei einer Containerregistrierung verwendet wird.

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az acr repository list

Listet Repositorys in einer Azure Container Registry-Instanz auf.

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

Beispiele

Auflisten von Repositorys in einer bestimmten Azure-Containerregistrierung.

az acr repository list -n myregistry

Erforderliche Parameter

--name -n

Der Name der Containerregistrierung. Er sollte in Kleinbuchstaben angegeben werden. Sie können den Standardregistrierungsnamen mithilfe von az configure --defaults acr=<registry name>.

Optionale Parameter

--password -p

Das Zum Anmelden bei einer Containerregistrierung verwendete Kennwort.

--suffix

Das Mandantensuffix im Registrierungsanmeldungsserver. Sie können "--Suffix-Mandant" angeben, wenn sich ihr Registrierungsanmeldungsserver im Format "registry-tenant.azurecr.io" befindet. Anwendbar, wenn Sie von einem anderen Abonnement aus auf die Registrierung zugreifen oder über die Berechtigung zum Zugreifen auf Bilder verfügen, aber nicht über die Berechtigung zum Verwalten der Registrierungsressource.

--top

Beschränken Sie die Anzahl der Elemente in den Ergebnissen.

--username -u

Der Benutzername, der zum Anmelden bei einer Containerregistrierung verwendet wird.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az acr repository list-deleted

Vorschau

Dieser Befehl befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Auflisten vorläufig gelöschter Repositorys in einer Azure-Containerregistrierung.

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

Beispiele

Auflisten vorläufig gelöschter Repositorys in einer bestimmten Azure-Containerregistrierung.

az acr repository list-deleted -n myregistry

Erforderliche Parameter

--name -n

Der Name der Containerregistrierung. Er sollte in Kleinbuchstaben angegeben werden. Sie können den Standardregistrierungsnamen mithilfe von az configure --defaults acr=<registry name>.

Optionale Parameter

--password -p

Das Zum Anmelden bei einer Containerregistrierung verwendete Kennwort.

--suffix

Das Mandantensuffix im Registrierungsanmeldungsserver. Sie können "--Suffix-Mandant" angeben, wenn sich ihr Registrierungsanmeldungsserver im Format "registry-tenant.azurecr.io" befindet. Anwendbar, wenn Sie von einem anderen Abonnement aus auf die Registrierung zugreifen oder über die Berechtigung zum Zugreifen auf Bilder verfügen, aber nicht über die Berechtigung zum Verwalten der Registrierungsressource.

--username -u

Der Benutzername, der zum Anmelden bei einer Containerregistrierung verwendet wird.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az acr repository show

Ruft die Attribute eines Repositorys oder Images in einer Azure Container Registry-Instanz ab.

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

Beispiele

Rufen Sie die Attribute des Repositorys "hello-world" ab.

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

Rufen Sie die Attribute des Bilds ab, auf das mit dem Tag "hello-world:latest" verwiesen wird.

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

Rufen Sie die Attribute des Bilds ab, auf das durch den Digest "hello-world@sha256:abc123" verwiesen wird.

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

Erforderliche Parameter

--name -n

Der Name der Containerregistrierung. Er sollte in Kleinbuchstaben angegeben werden. Sie können den Standardregistrierungsnamen mithilfe von az configure --defaults acr=<registry name>.

Optionale Parameter

--image -t

Der Name des Bildes. Kann ein Tag im Format "name:tag" oder Digest im Format "name@digest" enthalten.

--password -p

Das Zum Anmelden bei einer Containerregistrierung verwendete Kennwort.

--repository

Der Name des Repositorys.

--suffix

Das Mandantensuffix im Registrierungsanmeldungsserver. Sie können "--Suffix-Mandant" angeben, wenn sich ihr Registrierungsanmeldungsserver im Format "registry-tenant.azurecr.io" befindet. Anwendbar, wenn Sie von einem anderen Abonnement aus auf die Registrierung zugreifen oder über die Berechtigung zum Zugreifen auf Bilder verfügen, aber nicht über die Berechtigung zum Verwalten der Registrierungsressource.

--username -u

Der Benutzername, der zum Anmelden bei einer Containerregistrierung verwendet wird.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az acr repository show-manifests

Als veraltet markiert

Dieser Befehl ist veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie stattdessen "acr manifest list-metadata".

Zeigt Manifeste eines Repositorys in einer Azure Container Registry-Instanz an.

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

Beispiele

Zeigt Manifeste eines Repositorys in einer Azure Container Registry-Instanz an.

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

Zeigen Sie die neuesten 10 Manifeste an, die nach Zeitstempel eines Repositorys in einer Azure-Containerregistrierung sortiert sind.

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

Zeigen Sie die detaillierten Informationen der neuesten 10 Manifeste an, die nach Zeitstempel eines Repositorys in einer Azure-Containerregistrierung sortiert sind.

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

Erforderliche Parameter

--name -n

Der Name der Containerregistrierung. Er sollte in Kleinbuchstaben angegeben werden. Sie können den Standardregistrierungsnamen mithilfe von az configure --defaults acr=<registry name>.

--repository

Der Name des Repositorys.

Optionale Parameter

--detail

Detaillierte Informationen anzeigen.

Standardwert: False
--orderby

Ordnen Sie die Elemente in den Ergebnissen an. Standardmäßig wird die alphabetische Reihenfolge von Namen verwendet.

Zulässige Werte: time_asc, time_desc
--password -p

Das Zum Anmelden bei einer Containerregistrierung verwendete Kennwort.

--suffix

Das Mandantensuffix im Registrierungsanmeldungsserver. Sie können "--Suffix-Mandant" angeben, wenn sich ihr Registrierungsanmeldungsserver im Format "registry-tenant.azurecr.io" befindet. Anwendbar, wenn Sie von einem anderen Abonnement aus auf die Registrierung zugreifen oder über die Berechtigung zum Zugreifen auf Bilder verfügen, aber nicht über die Berechtigung zum Verwalten der Registrierungsressource.

--top

Beschränken Sie die Anzahl der Elemente in den Ergebnissen.

--username -u

Der Benutzername, der zum Anmelden bei einer Containerregistrierung verwendet wird.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az acr repository show-tags

Zeigt Tags für ein Repository in einer Azure Container Registry-Instanz an.

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

Beispiele

Tags eines Repositorys in einer Azure-Containerregistrierung anzeigen.

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

Zeigen Sie die detaillierten Informationen von Tags eines Repositorys in einer Azure-Containerregistrierung an.

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

Zeigen Sie die detaillierten Informationen der neuesten 10 Tags an, die nach Zeitstempel eines Repositorys in einer Azure-Containerregistrierung sortiert sind.

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

Erforderliche Parameter

--name -n

Der Name der Containerregistrierung. Er sollte in Kleinbuchstaben angegeben werden. Sie können den Standardregistrierungsnamen mithilfe von az configure --defaults acr=<registry name>.

--repository

Der Name des Repositorys.

Optionale Parameter

--detail

Detaillierte Informationen anzeigen.

Standardwert: False
--orderby

Ordnen Sie die Elemente in den Ergebnissen an. Standardmäßig wird die alphabetische Reihenfolge von Namen verwendet.

Zulässige Werte: time_asc, time_desc
--password -p

Das Zum Anmelden bei einer Containerregistrierung verwendete Kennwort.

--suffix

Das Mandantensuffix im Registrierungsanmeldungsserver. Sie können "--Suffix-Mandant" angeben, wenn sich ihr Registrierungsanmeldungsserver im Format "registry-tenant.azurecr.io" befindet. Anwendbar, wenn Sie von einem anderen Abonnement aus auf die Registrierung zugreifen oder über die Berechtigung zum Zugreifen auf Bilder verfügen, aber nicht über die Berechtigung zum Verwalten der Registrierungsressource.

--top

Beschränken Sie die Anzahl der Elemente in den Ergebnissen.

--username -u

Der Benutzername, der zum Anmelden bei einer Containerregistrierung verwendet wird.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az acr repository untag

Hebt Tags von einem Image in einer Azure Container Registry-Instanz auf.

Mit diesem Befehl wird das Manifest, auf das durch das Tag oder alle zugeordneten Layerdaten verwiesen wird, nicht gelöscht.

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

Beispiele

Heben Sie die Markierung eines Bilds aus einem Repository auf.

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

Erforderliche Parameter

--image -t

Der Name des Bildes. Kann ein Tag im Format "name:tag" enthalten.

--name -n

Der Name der Containerregistrierung. Er sollte in Kleinbuchstaben angegeben werden. Sie können den Standardregistrierungsnamen mithilfe von az configure --defaults acr=<registry name>.

Optionale Parameter

--password -p

Das Zum Anmelden bei einer Containerregistrierung verwendete Kennwort.

--suffix

Das Mandantensuffix im Registrierungsanmeldungsserver. Sie können "--Suffix-Mandant" angeben, wenn sich ihr Registrierungsanmeldungsserver im Format "registry-tenant.azurecr.io" befindet. Anwendbar, wenn Sie von einem anderen Abonnement aus auf die Registrierung zugreifen oder über die Berechtigung zum Zugreifen auf Bilder verfügen, aber nicht über die Berechtigung zum Verwalten der Registrierungsressource.

--username -u

Der Benutzername, der zum Anmelden bei einer Containerregistrierung verwendet wird.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az acr repository update

Aktualisiert die Attribute eines Repositorys oder Images in einer Azure Container Registry-Instanz.

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

Beispiele

Aktualisieren Sie die Attribute des Repositorys "hello-world", um den Schreibvorgang zu deaktivieren.

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

Aktualisieren Sie die Attribute des Bilds, auf das durch das Tag "hello-world:latest" verwiesen wird, um den Schreibvorgang zu deaktivieren.

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

Aktualisieren Sie die Attribute des Bilds, auf das durch digest "hello-world@sha256:abc123" verwiesen wird, um den Schreibvorgang zu deaktivieren.

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

Erforderliche Parameter

--name -n

Der Name der Containerregistrierung. Er sollte in Kleinbuchstaben angegeben werden. Sie können den Standardregistrierungsnamen mithilfe von az configure --defaults acr=<registry name>.

Optionale Parameter

--delete-enabled

Gibt an, ob der Löschvorgang zulässig ist.

Zulässige Werte: false, true
--image -t

Der Name des Bildes. Kann ein Tag im Format "name:tag" oder Digest im Format "name@digest" enthalten.

--list-enabled

Gibt an, ob dieses Element in listenvorgangsergebnissen angezeigt wird.

Zulässige Werte: false, true
--password -p

Das Zum Anmelden bei einer Containerregistrierung verwendete Kennwort.

--read-enabled

Gibt an, ob lesevorgang zulässig ist.

Zulässige Werte: false, true
--repository

Der Name des Repositorys.

--suffix

Das Mandantensuffix im Registrierungsanmeldungsserver. Sie können "--Suffix-Mandant" angeben, wenn sich ihr Registrierungsanmeldungsserver im Format "registry-tenant.azurecr.io" befindet. Anwendbar, wenn Sie von einem anderen Abonnement aus auf die Registrierung zugreifen oder über die Berechtigung zum Zugreifen auf Bilder verfügen, aber nicht über die Berechtigung zum Verwalten der Registrierungsressource.

--username -u

Der Benutzername, der zum Anmelden bei einer Containerregistrierung verwendet wird.

--write-enabled

Gibt an, ob schreib- oder löschvorgang zulässig ist.

Zulässige Werte: false, true
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.