Partager via

az acr webhook

  • Référence

Gérer les webhooks pour les registres de conteneurs Azure.

Commandes

Nom Description Type Statut
az acr webhook create

Crée un webhook pour un registre de conteneurs Azure.

 Core GA
az acr webhook delete

Supprime un webhook dans un registre de conteneurs Azure.

 Core GA
az acr webhook get-config

Obtient l’URI de service et les en-têtes personnalisés du webhook.

 Core GA
az acr webhook list

Liste tous les webhooks d’un registre de conteneurs Azure.

 Core GA
az acr webhook list-events

Liste les événements récents d’un webhook.

 Core GA
az acr webhook ping

Déclenche un événement ping pour un webhook.

 Core GA
az acr webhook show

Obtient les détails d’un webhook.

 Core GA
az acr webhook update

Met à jour un webhook.

 Core GA

az acr webhook create

Modifier

Crée un webhook pour un registre de conteneurs Azure.

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

Exemples

Créez un webhook pour un Registre de conteneurs Azure qui fournira des événements Docker Push et supprime des événements à un URI de service.

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

Créez un webhook pour un Azure Container Registry qui fournira des événements Docker Push à un URI de service avec un en-tête d’authentification de base.

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

Créez un webhook pour un Azure Container Registry qui fournira des événements push et suppression de graphique helm à un URI de service.

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

Paramètres obligatoires

--actions

Liste d’actions séparées par l’espace qui déclenchent le webhook pour publier des notifications.

valeurs acceptées: chart_delete, chart_push, delete, push, quarantine
--name -n

Nom du webhook.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

--uri

URI de service pour le webhook à publier des notifications.

Paramètres facultatifs

--headers

En-têtes personnalisés séparés par l’espace au format « key[=value] » qui seront ajoutés aux notifications de webhook. Utilisez « » pour effacer les en-têtes existants.

--location -l

Emplacement. Valeurs provenant de : az account list-locations. Vous pouvez configurer le lieu par défaut en utilisant az configure --defaults location=<location>.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--scope

Étendue des référentiels où l’événement peut être déclenché. Par exemple, « foo :* » signifie des événements pour toutes les balises sous le dépôt « foo ». 'foo :bar' signifie les événements pour 'foo :bar' uniquement. 'foo' équivaut à 'foo :latest'. Vide signifie que les événements de tous les référentiels sont vides.

--status

Indique si le webhook est activé.

valeurs acceptées: disabled, enabled
valeur par défaut: enabled
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr webhook delete

Modifier

Supprime un webhook dans un registre de conteneurs Azure.

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

Exemples

Supprime un webhook dans un registre de conteneurs Azure.

az acr webhook delete -n mywebhook -r myregistry

Paramètres obligatoires

--name -n

Nom du webhook.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr webhook get-config

Modifier

Obtient l’URI de service et les en-têtes personnalisés du webhook.

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

Exemples

Obtenez les informations de configuration d’un webhook.

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

Paramètres obligatoires

--name -n

Nom du webhook.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr webhook list

Modifier

Liste tous les webhooks d’un registre de conteneurs Azure.

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

Exemples

Répertoriez les webhooks et affichez les résultats d’une table.

az acr webhook list -r myregistry -o table

Paramètres obligatoires

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr webhook list-events

Modifier

Liste les événements récents d’un webhook.

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

Exemples

Liste les événements récents d’un webhook.

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

Paramètres obligatoires

--name -n

Nom du webhook.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr webhook ping

Modifier

Déclenche un événement ping pour un webhook.

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

Exemples

Déclenche un événement ping pour un webhook.

az acr webhook ping -n mywebhook -r myregistry

Paramètres obligatoires

--name -n

Nom du webhook.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr webhook show

Modifier

Obtient les détails d’un webhook.

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

Exemples

Obtient les détails d’un webhook.

az acr webhook show -n mywebhook -r myregistry

Paramètres obligatoires

--name -n

Nom du webhook.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az acr webhook update

Modifier

Met à jour un 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]

Exemples

Mettez à jour les en-têtes d’un webhook.

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

Mettez à jour l’URI et les actions du service pour un webhook.

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

Désactivez un webhook.

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

Paramètres obligatoires

--name -n

Nom du webhook.

--registry -r

Nom du registre de conteneurs. Elle doit être spécifiée en minuscules. Vous pouvez configurer le nom de Registre par défaut à l’aide az configure --defaults acr=<registry name>de .

Paramètres facultatifs

--actions

Liste d’actions séparées par l’espace qui déclenchent le webhook pour publier des notifications.

valeurs acceptées: chart_delete, chart_push, delete, push, quarantine
--add

Ajoutez un objet à une liste d’objets en spécifiant un chemin d’accès et des paires clé-valeur. Exemple : --add property.listProperty <key=value, string or JSON string>.

valeur par défaut: []
--force-string

Lorsque vous utilisez « set » ou « add », conservez les littéraux de chaîne au lieu de tenter de convertir en JSON.

valeur par défaut: False
--headers

En-têtes personnalisés séparés par l’espace au format « key[=value] » qui seront ajoutés aux notifications de webhook. Utilisez « » pour effacer les en-têtes existants.

--remove

Supprimez une propriété ou un élément d’une liste. Exemple : --remove property.list <indexToRemove> OR --remove propertyToRemove.

valeur par défaut: []
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--scope

Étendue des référentiels où l’événement peut être déclenché. Par exemple, « foo :* » signifie des événements pour toutes les balises sous le dépôt « foo ». 'foo :bar' signifie les événements pour 'foo :bar' uniquement. 'foo' équivaut à 'foo :latest'. Vide signifie que les événements de tous les référentiels sont vides.

--set

Mettez à jour un objet en spécifiant un chemin d’accès et une valeur de propriété à définir. Exemple : --set property1.property2=<value>.

valeur par défaut: []
--status

Indique si le webhook est activé.

valeurs acceptées: disabled, enabled
--tags

Balises séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les balises existantes.

--uri

URI de service pour le webhook à publier des notifications.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.