Freigeben über

az acr repository

Verwalten Sie Repositorys (Imagenamen) für Azure Containerregistries.

Befehle

Name Beschreibung Typ Status
az acr repository delete

Löschen Eines Repositorys oder Bilds in einem Azure Container Registry.

 Core GA
az acr repository list

Auflisten von Repositorys in einem Azure Container Registry.

 Core GA
az acr repository list-deleted

Auflisten vorläufig gelöschter Repositorys in einem Azure Container Registry.

 Core Preview
az acr repository show

Rufen Sie die Attribute eines Repositorys oder Bilds in einem Azure Container Registry ab.

 Core GA
az acr repository show-tags

Anzeigen von Tags für ein Repository in einem Azure Container Registry.

 Core GA
az acr repository untag

Heben Sie die Markierung eines Bilds in einem Azure Container Registry auf.

 Core GA
az acr repository update

Aktualisieren Sie die Attribute eines Repositorys oder Bilds in einem Azure Container Registry.

 Core GA

az acr repository delete

Bearbeiten

Löschen Eines Repositorys oder Bilds in einem Azure Container Registry.

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
                         [--acquire-policy-token]
                         [--change-reference]
                         [--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 einem Azure Container Registry. 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>konfigurieren.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--image -t

Der Name des Bilds. 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

Zur Bestätigung nicht auffordern.

Eigenschaft Wert
Standardwert: False
Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az acr repository list

Bearbeiten

Auflisten von Repositorys in einem Azure Container Registry.

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

Beispiele

Auflisten von Repositorys in einem bestimmten Azure Container Registry.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az acr repository list-deleted

Bearbeiten
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 einem Azure Container Registry.

az acr repository list-deleted --name
                               [--acquire-policy-token]
                               [--change-reference]
                               [--password]
                               [--suffix]
                               [--username]

Beispiele

Auflisten vorläufig gelöschter Repositorys in einem bestimmten Azure Container Registry.

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

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az acr repository show

Bearbeiten

Rufen Sie die Attribute eines Repositorys oder Bilds in einem Azure Container Registry 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>konfigurieren.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--image -t

Der Name des Bilds. 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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az acr repository show-tags

Bearbeiten

Anzeigen von Tags für ein Repository in einem Azure Container Registry.

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

Beispiele

Anzeigen von Tags eines Repositorys in einem Azure Container Registry.

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

Zeigen Sie die detaillierten Informationen von Tags eines Repositorys in einem Azure Container Registry 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 Container Registry 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>konfigurieren.

--repository

Der Name des Repositorys.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--detail

Detaillierte Informationen anzeigen.

Eigenschaft Wert
Standardwert: False
--orderby

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

Eigenschaft Wert
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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az acr repository untag

Bearbeiten

Heben Sie die Markierung eines Bilds in einem Azure Container Registry 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
                        [--acquire-policy-token]
                        [--change-reference]
                        [--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 Bilds. 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>konfigurieren.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False

az acr repository update

Bearbeiten

Aktualisieren Sie die Attribute eines Repositorys oder Bilds in einem Azure Container Registry.

az acr repository update --name
                         [--acquire-policy-token]
                         [--change-reference]
                         [--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>konfigurieren.

Optionale Parameter

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--acquire-policy-token

Automatisches Abrufen eines Azure Policy Tokens für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--change-reference

Die zugehörige Änderungsreferenz-ID für diesen Ressourcenvorgang.

Eigenschaft Wert
Parametergruppe: Global Policy Arguments
--delete-enabled

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

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

Der Name des Bilds. 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.

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

Das Zum Anmelden bei einer Containerregistrierung verwendete Kennwort.

--read-enabled

Gibt an, ob lesevorgang zulässig ist.

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

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

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

Eigenschaft Wert
Standardwert: False