Freigeben über


az acr webhook

Verwalten von Webhooks für Azure-Containerregistrierungen.

Befehle

Name Beschreibung Typ Status
az acr webhook create

Erstellt einen Webhook für eine Azure Container Registry-Instanz.

Core Allgemein verfügbar
az acr webhook delete

Löscht einen Webhook aus einer Azure Container Registry-Instanz.

Core Allgemein verfügbar
az acr webhook get-config

Ruft den Dienst-URI und benutzerdefinierte Header für den Webhook ab.

Core Allgemein verfügbar
az acr webhook list

Listet alle Webhooks für eine Azure Container Registry-Instanz auf.

Core Allgemein verfügbar
az acr webhook list-events

Listet aktuelle Ereignisse für einen Webhook auf.

Core Allgemein verfügbar
az acr webhook ping

Löst ein Pingereignis für einen Webhook aus.

Core Allgemein verfügbar
az acr webhook show

Ruft die Details zu einem Webhook ab.

Core Allgemein verfügbar
az acr webhook update

Aktualisiert einen Webhook.

Core Allgemein verfügbar

az acr webhook create

Erstellt einen Webhook für eine Azure Container Registry-Instanz.

az acr webhook create --actions {chart_delete, chart_push, delete, push, quarantine}
                      --name
                      --registry
                      --uri
                      [--headers]
                      [--location]
                      [--resource-group]
                      [--scope]
                      [--status {disabled, enabled}]
                      [--tags]

Beispiele

Erstellen Sie einen Webhook für eine Azure-Containerregistrierung, die Docker-Push- und Löschereignisse an einen Dienst-URI liefert.

az acr webhook create -n mywebhook -r myregistry --uri http://myservice.com --actions push delete

Erstellen Sie einen Webhook für eine Azure-Containerregistrierung, die Docker-Pushereignisse an einen Dienst-URI mit einem Standardauthentifizierungsheader bereitstellt.

az acr webhook create -n mywebhook -r myregistry --uri http://myservice.com --actions push --headers "Authorization=Basic 000000"

Erstellen Sie einen Webhook für eine Azure-Containerregistrierung, die Steuerdiagramm-Push- und Löschereignisse an einen Dienst-URI liefert.

az acr webhook create -n mywebhook -r myregistry --uri http://myservice.com --actions chart_push chart_delete

Erforderliche Parameter

--actions

Durch Leerzeichen getrennte Liste von Aktionen, die den Webhook auslösen, um Benachrichtigungen zu posten.

Zulässige Werte: chart_delete, chart_push, delete, push, quarantine
--name -n

Der Name des Webhooks.

--registry -r

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

--uri

Der Dienst-URI für den Webhook zum Bereitstellen von Benachrichtigungen.

Optionale Parameter

--headers

Leerzeichentrennte benutzerdefinierte Header im Format "key[=value]", die den Webhook-Benachrichtigungen hinzugefügt werden. Verwenden Sie "", um vorhandene Kopfzeilen zu löschen.

--location -l

Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--scope

Der Umfang der Repositorys, in denen das Ereignis ausgelöst werden kann. Beispielsweise bedeutet "foo:*" Ereignisse für alle Tags unter Repository "foo". "foo:bar" bedeutet nur Ereignisse für 'foo:bar'. 'foo' entspricht 'foo:latest'. Leer bedeutet Ereignisse für alle Repositorys.

--status

Gibt an, ob der Webhook aktiviert ist.

Zulässige Werte: disabled, enabled
Standardwert: enabled
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

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

Löscht einen Webhook aus einer Azure Container Registry-Instanz.

az acr webhook delete --name
                      --registry
                      [--resource-group]

Beispiele

Löscht einen Webhook aus einer Azure Container Registry-Instanz.

az acr webhook delete -n mywebhook -r myregistry

Erforderliche Parameter

--name -n

Der Name des Webhooks.

--registry -r

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

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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 webhook get-config

Ruft den Dienst-URI und benutzerdefinierte Header für den Webhook ab.

az acr webhook get-config --name
                          --registry
                          [--resource-group]

Beispiele

Rufen Sie die Konfigurationsinformationen für einen Webhook ab.

az acr webhook get-config -n mywebhook -r myregistry

Erforderliche Parameter

--name -n

Der Name des Webhooks.

--registry -r

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

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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

Listet alle Webhooks für eine Azure Container Registry-Instanz auf.

az acr webhook list --registry
                    [--resource-group]

Beispiele

Listen Sie Webhooks auf, und zeigen Sie die Ergebnisse in einer Tabelle an.

az acr webhook list -r myregistry -o table

Erforderliche Parameter

--registry -r

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

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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 webhook list-events

Listet aktuelle Ereignisse für einen Webhook auf.

az acr webhook list-events --name
                           --registry
                           [--resource-group]

Beispiele

Listet aktuelle Ereignisse für einen Webhook auf.

az acr webhook list-events -n mywebhook -r myregistry

Erforderliche Parameter

--name -n

Der Name des Webhooks.

--registry -r

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

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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

Löst ein Pingereignis für einen Webhook aus.

az acr webhook ping --name
                    --registry
                    [--resource-group]

Beispiele

Löst ein Pingereignis für einen Webhook aus.

az acr webhook ping -n mywebhook -r myregistry

Erforderliche Parameter

--name -n

Der Name des Webhooks.

--registry -r

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

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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

Ruft die Details zu einem Webhook ab.

az acr webhook show --name
                    --registry
                    [--resource-group]

Beispiele

Ruft die Details zu einem Webhook ab.

az acr webhook show -n mywebhook -r myregistry

Erforderliche Parameter

--name -n

Der Name des Webhooks.

--registry -r

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

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

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

Aktualisiert einen Webhook.

az acr webhook update --name
                      --registry
                      [--actions {chart_delete, chart_push, delete, push, quarantine}]
                      [--add]
                      [--force-string]
                      [--headers]
                      [--remove]
                      [--resource-group]
                      [--scope]
                      [--set]
                      [--status {disabled, enabled}]
                      [--tags]
                      [--uri]

Beispiele

Aktualisieren von Headern für einen Webhook.

az acr webhook update -n mywebhook -r myregistry --headers "Authorization=Basic 000000"

Aktualisieren Sie den Dienst-URI und die Aktionen für einen Webhook.

az acr webhook update -n mywebhook -r myregistry --uri http://myservice.com --actions push delete

Deaktivieren Sie einen Webhook.

az acr webhook update -n mywebhook -r myregistry --status disabled

Erforderliche Parameter

--name -n

Der Name des Webhooks.

--registry -r

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

--actions

Durch Leerzeichen getrennte Liste von Aktionen, die den Webhook auslösen, um Benachrichtigungen zu posten.

Zulässige Werte: chart_delete, chart_push, delete, push, quarantine
--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []
--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False
--headers

Leerzeichentrennte benutzerdefinierte Header im Format "key[=value]", die den Webhook-Benachrichtigungen hinzugefügt werden. Verwenden Sie "", um vorhandene Kopfzeilen zu löschen.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--scope

Der Umfang der Repositorys, in denen das Ereignis ausgelöst werden kann. Beispielsweise bedeutet "foo:*" Ereignisse für alle Tags unter Repository "foo". "foo:bar" bedeutet nur Ereignisse für 'foo:bar'. 'foo' entspricht 'foo:latest'. Leer bedeutet Ereignisse für alle Repositorys.

--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
--status

Gibt an, ob der Webhook aktiviert ist.

Zulässige Werte: disabled, enabled
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

--uri

Der Dienst-URI für den Webhook zum Bereitstellen von Benachrichtigungen.

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.