Freigeben über

az acr repository

  • Referenz

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

Befehle

Name Beschreibung Typ Status
az acr repository delete

Löschen Eines Repositorys oder Images in einer Azure-Containerregistrierung.

 Kern GA
az acr repository list

Auflisten von Repositorys in einer Azure-Containerregistrierung.

 Kern GA
az acr repository list-deleted

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

 Kern Vorschau
az acr repository show

Rufen Sie die Attribute eines Repositorys oder Images in einer Azure-Containerregistrierung ab.

 Kern GA
az acr repository show-tags

Anzeigen von Tags für ein Repository in einer Azure-Containerregistrierung.

 Kern GA
az acr repository untag

Heben Sie die Markierung eines Images in einer Azure-Containerregistrierung auf.

 Kern GA
az acr repository update

Aktualisieren Sie die Attribute eines Repositorys oder Images in einer Azure-Containerregistrierung.

 Kern GA

az acr repository delete

Bearbeiten

Löschen Eines Repositorys oder Images in einer Azure-Containerregistrierung.

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

Optionale Parameter

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

Standardwert: False
Globale Parameter
--debug

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

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.

az acr repository list

Bearbeiten

Auflisten von Repositorys in einer Azure-Containerregistrierung.

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

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

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

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.

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

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

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

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.

az acr repository show

Bearbeiten

Rufen Sie die Attribute eines Repositorys oder Images in einer Azure-Containerregistrierung 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

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

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.

az acr repository show-tags

Bearbeiten

Anzeigen von Tags für ein Repository in einer Azure-Containerregistrierung.

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

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

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

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.

az acr repository untag

Bearbeiten

Heben Sie die Markierung eines Images in einer Azure-Containerregistrierung 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 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

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

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.

az acr repository update

Bearbeiten

Aktualisieren Sie die Attribute eines Repositorys oder Images in einer Azure-Containerregistrierung.

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

Optionale Parameter

--delete-enabled

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

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.

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

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

--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, 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

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.