Teilen über

az acr webhook

  • Referenz

Verwalten von Webhooks für Azure-Containerregistrierungen.

Befehle

Name Beschreibung Typ Status
az acr webhook create

Erstellen Sie einen Webhook für eine Azure-Containerregistrierung.

 Kern GA
az acr webhook delete

Löschen eines Webhooks aus einer Azure-Containerregistrierung.

 Kern GA
az acr webhook get-config

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

 Kern GA
az acr webhook list

Listet alle Webhooks für eine Azure-Containerregistrierung auf.

 Kern GA
az acr webhook list-events

Aktuelle Ereignisse für einen Webhook auflisten.

 Kern GA
az acr webhook ping

Auslösen eines Pingereignisses für einen Webhook.

 Kern GA
az acr webhook show

Rufen Sie die Details eines Webhooks ab.

 Kern GA
az acr webhook update

Aktualisieren eines Webhooks.

 Kern GA

az acr webhook create

Bearbeiten

Erstellen Sie einen Webhook für eine Azure-Containerregistrierung.

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

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

Ort. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von 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

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

Bearbeiten

Löschen eines Webhooks aus einer Azure-Containerregistrierung.

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

Beispiele

Löschen eines Webhooks aus einer Azure-Containerregistrierung.

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

Optionale Parameter

--resource-group -g

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

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

Bearbeiten

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

Optionale Parameter

--resource-group -g

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

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

Bearbeiten

Listet alle Webhooks für eine Azure-Containerregistrierung 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>konfigurieren.

Optionale Parameter

--resource-group -g

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

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

Bearbeiten

Aktuelle Ereignisse für einen Webhook auflisten.

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

Beispiele

Aktuelle Ereignisse für einen Webhook auflisten.

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

Optionale Parameter

--resource-group -g

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

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

Bearbeiten

Auslösen eines Pingereignisses für einen Webhook.

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

Beispiele

Auslösen eines Pingereignisses für einen Webhook.

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

Optionale Parameter

--resource-group -g

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

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

Bearbeiten

Rufen Sie die Details eines Webhooks ab.

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

Beispiele

Rufen Sie die Details eines Webhooks 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>konfigurieren.

Optionale Parameter

--resource-group -g

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

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

Bearbeiten

Aktualisieren eines Webhooks.

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

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

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.