az eventgrid event-subscription

Remarque

Ce groupe de commandes a des commandes définies dans Azure CLI et au moins une extension. Installez chaque extension pour bénéficier de ses fonctionnalités étendues. En savoir plus sur les extensions.

Gérer les abonnements aux événements.

Gérez les abonnements aux événements pour une rubrique Event Grid, un domaine, une rubrique de domaine, un abonnement Azure, un groupe de ressources ou toute autre ressource Azure prenant en charge les notifications d’événements.

Commandes

Nom Description Type État
az eventgrid event-subscription create

Créez un abonnement aux événements.

Core GA
az eventgrid event-subscription create (eventgrid extension)

Créez un abonnement aux événements.

Extension Aperçu
az eventgrid event-subscription delete

Supprimer un abonnement à un événement.

Core GA
az eventgrid event-subscription delete (eventgrid extension)

Supprimer un abonnement à un événement.

Extension Aperçu
az eventgrid event-subscription list

Répertorier les abonnements aux événements.

Core GA
az eventgrid event-subscription list (eventgrid extension)

Répertorier les abonnements aux événements.

Extension Aperçu
az eventgrid event-subscription show

Obtenez les détails d’un abonnement aux événements.

Core GA
az eventgrid event-subscription show (eventgrid extension)

Obtenez les détails d’un abonnement aux événements.

Extension Aperçu
az eventgrid event-subscription update

Mettez à jour un abonnement aux événements.

Core GA
az eventgrid event-subscription update (eventgrid extension)

Mettez à jour un abonnement aux événements.

Extension Aperçu

az eventgrid event-subscription create

Créez un abonnement aux événements.

az eventgrid event-subscription create --name
                                       [--aad-tenant-id]
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
                                       [--event-ttl]
                                       [--expiration-date]
                                       [--included-event-types]
                                       [--labels]
                                       [--max-delivery-attempts]
                                       [--max-events-per-batch]
                                       [--preferred-batch-size-in-kilobytes]
                                       [--qttl]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Exemples

Créez un abonnement aux événements pour une rubrique Event Grid à l’aide de filtres par défaut.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements pour un abonnement Azure à l’aide de filtres par défaut.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements pour un groupe de ressources à l’aide de filtres par défaut.

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements pour un compte de stockage à l’aide de filtres par défaut.

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements pour un compte de stockage à l’aide de filtres avancés.

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Créez un abonnement aux événements pour un abonnement Azure, avec un filtre spécifiant un préfixe d’objet.

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Créez un abonnement aux événements pour un groupe de ressources, avec un filtre spécifiant un suffixe d’objet.

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

Créez un abonnement aux événements pour un abonnement Azure, à l’aide de filtres par défaut et d’un EventHub comme destination.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

Créez un abonnement aux événements pour un abonnement Azure, à l’aide de filtres par défaut et d’une file d’attente Stockage Azure en tant que destination.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

Créez un abonnement aux événements pour un abonnement Azure, à l’aide de filtres par défaut et d’azure ServiceBusQueue comme destination.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

Créez un abonnement aux événements pour un domaine Event Grid, en utilisant des filtres par défaut et CloudEvent V 1.0 comme schéma de remise.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Créez un abonnement aux événements pour un compte de stockage, avec une destination deadletter et une stratégie de nouvelle tentative personnalisée de 10 tentatives de remise maximales et une durée de vie d’événement de 2 heures (selon ce qui se produit précédemment).

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120

Créez un abonnement aux événements pour une rubrique de domaine.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements (pour un compte de stockage) avec une date d’expiration.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

Créez un abonnement aux événements pour une rubrique Event Grid à l’aide du Webhook activé par Azure Active Directory comme destination.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Créez un abonnement aux événements pour une rubrique Event Grid à l’aide d’Azure Function en tant que destination.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Créer un abonnement aux événements pour une rubrique Event Grid, à l’aide d’Eventhub avec l’identité MSI attribuée par le système comme destination et avec deadletter avec l’identité MSI

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

Créer un abonnement aux événements pour une rubrique Event Grid à l’aide de Stockage File d’attente en tant que destination avec la durée de vie du message à 5 minutes

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Créer un abonnement aux événements pour une rubrique Event Grid à l’aide de Stockage Queue avec l’identité MSI attribuée par le système comme destination

az eventgrid event-subscription create -n {EventSubscriptionName} --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type StorageQueue --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Créer un abonnement aux événements pour une rubrique Event Grid avec filtrage avancé activé sur les tableaux

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Paramètres obligatoires

--name -n

Nom de l’abonnement aux événements.

Paramètres facultatifs

--aad-tenant-id --azure-active-directory-tenant-id

ID de locataire Azure Active Directory pour obtenir le jeton d’accès qui sera inclus en tant que jeton du porteur dans les demandes de remise. Applicable uniquement pour le webhook comme destination.

--advanced-filter

Un filtre avancé permet de filtrer les événements en fonction d’une propriété d’événement spécifique.

Utilisation : --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn : --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn : --advanced-filter data. Color StringNotIn Blue Red Orange StringContains : --advanced-filter subject StringContains Blue Red StringNotContains : --advanced-filter subject StringNotContains Blue Red StringBeginsWith : --advanced-filter subject StringBeginsWithsWith : --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith : --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith : --advanced-filter subject StringNotEndsWith img png numberIn : --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn : --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange : --advanced-filter data.property2 NumberNotInInRange 100 110 200 210 300 310 NumberLessThan : --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals : --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan : --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals : --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals : --advanced-filter data.property3 BoolEquals true IsNullOrUndefined : --advanced-filter data.property3 IsNullOrUndefined IsNotNull : --advanced-filter data.property3 IsNotNull Plusieurs filtres avancés peuvent être spécifiés à l’aide de plusieurs --advanced-filter arguments.

--azure-active-directory-application-id-or-uri

ID d’application Azure Active Directory ou URI pour obtenir le jeton d’accès qui sera inclus en tant que jeton du porteur dans les demandes de remise. Applicable uniquement pour le webhook comme destination.

--deadletter-endpoint

ID de ressource Azure d’une destination de conteneur d’objets blob Stockage Azure où EventGrid doit annuler la remise des événements pour cet abonnement d’événements.

Exemple : --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft. Stockage/storageAccounts/sa1/blobServices/default/containers/containerName.

--deadletter-identity
Préversion

Type d’identité de la ressource de destination deadletter.

Valeurs acceptées: systemassigned
--deadletter-identity-endpoint

ID de ressource Azure d’une destination de conteneur d’objets blob Stockage Azure avec l’identité où EventGrid doit annuler la remise des événements pour cet abonnement d’événements.

--delivery-attribute-mapping

Ajoutez le mappage d’attributs de remise pour envoyer des informations supplémentaires via des en-têtes HTTP lors de la remise d’événements. Cet attribut est valide pour tous les types de destination, sauf Stockage Queue. Plusieurs attributs peuvent être spécifiés à l’aide --delivery-attribute-mapping de plusieurs arguments.

Utilisation : --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Mappage d’attribut statique : --delivery-attribute-mapping somename static somevalue Static Attribute Mapping : --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping : --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping : --delivery-attribute-mapping dynamic somevalue both Static and Dynamic : -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Préversion

Type d’identité de la ressource de destination de remise (par exemple, file d’attente de stockage ou eventhub).

Valeurs acceptées: systemassigned
--delivery-identity-endpoint
Préversion

Point de terminaison avec identité où EventGrid doit remettre des événements correspondant à cet abonnement d’événements. Pour le type de point de terminaison webhook, il doit s’agir de l’URL de webhook correspondante. Pour les autres types de points de terminaison, il doit s’agir de l’identificateur de ressource Azure du point de terminaison.

--delivery-identity-endpoint-type
Préversion

Type du point de terminaison de destination avec l’identité de ressource.

Valeurs acceptées: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Permet aux filtres avancés d’être évalués par rapport à un tableau de valeurs au lieu d’attendre une valeur singulière.

Valeurs acceptées: false, true
--endpoint

Point de terminaison où EventGrid doit remettre des événements correspondant à cet abonnement d’événements. Pour le type de point de terminaison webhook, il doit s’agir de l’URL de webhook correspondante. Pour les autres types de points de terminaison, il doit s’agir de l’identificateur de ressource Azure du point de terminaison. Il est prévu que le point de terminaison de destination soit déjà créé et disponible pour une utilisation avant d’exécuter une commande Event Grid.

--endpoint-type

Type du point de terminaison de destination.

Valeur par défaut: webhook
--event-delivery-schema

Schéma dans lequel les événements doivent être remis pour cet abonnement d’événements. Par défaut, les événements sont remis dans le même schéma dans lequel ils sont publiés (en fonction du schéma d’entrée de la rubrique correspondante).

Valeurs acceptées: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Heure de vie de l’événement (en minutes). Doit être un nombre compris entre 1 et 1440.

Valeur par défaut: 1440
--expiration-date

Date ou datetime (en UTC, par exemple « 2018-11-30T11 :59 :59+00 :00 » ou « 2018-11-30 ») après quoi l’abonnement à l’événement expire. Par défaut, il n’y a pas d’expiration pour l’abonnement à l’événement.

--included-event-types

Liste séparée par l’espace des types d’événements (par exemple, Microsoft.Stockage. BlobCreated et Microsoft. Stockage. BlobDeleted). Pour vous abonner à tous les types d’événements par défaut, ne spécifiez aucune valeur pour cet argument. Pour les rubriques Event Grid, les types d’événements sont définis par le client. Pour les événements Azure, par exemple, Stockage Comptes, IoT Hub, etc., vous pouvez interroger leurs types d’événements à l’aide de cette commande CLI « az eventgrid topic-type list-event-types ».

--labels

Liste d’étiquettes séparées par un espace à associer à cet abonnement d’événements.

--max-delivery-attempts

Nombre maximal de tentatives de remise. Doit être un nombre compris entre 1 et 30.

Valeur par défaut: 30
--max-events-per-batch

Nombre maximal d’événements dans un lot. Doit être un nombre compris entre 1 et 5000.

--preferred-batch-size-in-kilobytes

Taille de lot préférée en kilo-octets. Doit être un nombre compris entre 1 et 1024.

--qttl --storage-queue-msg-ttl

Stockage délai de vie des messages de file d’attente en secondes.

--source-resource-id

Identificateur complet de la ressource Azure à laquelle l’abonnement aux événements doit être créé.

Utilisation : --source-resource-id Azure-Resource-ID pour l’abonnement Azure : --source-resource-id /subscriptions/{SubID} pour le groupe de ressources : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 pour la rubrique EventGrid : --source-resource -id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Pour le compte de stockage : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Stockage/storageaccounts/sa1 Pour le domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Pour la rubrique de domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Chaîne facultative permettant de filtrer les événements d’un abonnement aux événements en fonction d’un préfixe. Les caractères génériques ne sont pas pris en charge.

--subject-case-sensitive

Spécifiez pour indiquer si les champs d’objet doivent être comparés de manière sensible à la casse. True si l’indicateur est présent.

Valeurs acceptées: false, true
Valeur par défaut: False
--subject-ends-with

Chaîne facultative pour filtrer les événements d’un abonnement aux événements en fonction d’un suffixe. Les caractères génériques ne sont pas pris en charge.

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 eventgrid event-subscription create (eventgrid extension)

Préversion

Le groupe de commandes « az eventgrid » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Créez un abonnement aux événements.

az eventgrid event-subscription create --name
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--azure-active-directory-tenant-id]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--endpoint]
                                       [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
                                       [--event-ttl]
                                       [--expiration-date]
                                       [--included-event-types]
                                       [--labels]
                                       [--max-delivery-attempts]
                                       [--max-events-per-batch]
                                       [--preferred-batch-size-in-kilobytes]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Exemples

Créez un abonnement aux événements pour une rubrique Event Grid à l’aide de filtres par défaut.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements pour un abonnement à un abonnement Azure à l’aide de filtres par défaut.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements pour un groupe de ressources à l’aide de filtres par défaut.

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements pour un compte de stockage à l’aide de filtres par défaut.

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements pour un compte de stockage à l’aide de filtres avancés.

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Créez un abonnement aux événements pour un abonnement Azure, avec un filtre spécifiant un préfixe d’objet.

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Créez un abonnement aux événements pour un groupe de ressources, avec un filtre spécifiant un suffixe d’objet.

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

Créez un abonnement aux événements pour un abonnement Azure, à l’aide de filtres par défaut et d’un EventHub comme destination.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

Créez un abonnement aux événements pour un abonnement Azure, à l’aide de filtres par défaut et d’une file d’attente Stockage Azure en tant que destination.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

Créez un abonnement aux événements pour un abonnement Azure, à l’aide de filtres par défaut et d’azure ServiceBusQueue comme destination.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

Créez un abonnement aux événements pour un domaine Event Grid, en utilisant des filtres par défaut et CloudEvent V 1.0 comme schéma de remise.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Créez un abonnement aux événements pour un compte de stockage, avec une destination deadletter et une stratégie de nouvelle tentative personnalisée de 10 tentatives de remise maximales et une durée de vie d’événement de 2 heures (selon ce qui se produit précédemment).

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120

Créez un abonnement aux événements pour une rubrique de domaine.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements (pour un compte de stockage) avec une date d’expiration.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

Créez un abonnement aux événements pour une rubrique Event Grid à l’aide du Webhook activé par Azure Active Directory comme destination.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Créez un abonnement aux événements pour une rubrique Event Grid à l’aide d’Azure Function en tant que destination.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Créer un abonnement aux événements pour une rubrique Event Grid, à l’aide d’Eventhub avec l’identité MSI attribuée par le système comme destination et avec deadletter avec l’identité MSI

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

Paramètres obligatoires

--name -n

Nom de l’abonnement aux événements.

Paramètres facultatifs

--advanced-filter

Un filtre avancé permet de filtrer les événements en fonction d’une propriété d’événement spécifique.

Utilisation : --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn : --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn : --advanced-filter data. Color StringNotIn Blue Red Orange StringContains : --advanced-filter subject StringContains Blue Red StringBeginsWith : --advanced-filter subject StringBeginsWith Blue Red StringEndsWith : --advanced-filter subject StringEndsWith img png NumberIn : --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn : --advanced-filter data.property2 NumberNotIn 100 200 300 NumberLessThan : --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals : --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan : --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals : --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals : --advanced-filter data.property3 BoolEquals true Plusieurs filtres avancés peuvent être spécifiés à l’aide de plusieurs --advanced-filter arguments.

--azure-active-directory-application-id-or-uri

ID d’application Azure Active Directory ou URI pour obtenir le jeton d’accès qui sera inclus en tant que jeton du porteur dans les demandes de remise. Applicable uniquement pour le webhook comme destination.

--azure-active-directory-tenant-id

ID de locataire Azure Active Directory pour obtenir le jeton d’accès qui sera inclus en tant que jeton du porteur dans les demandes de remise. Applicable uniquement pour le webhook comme destination.

--deadletter-endpoint

ID de ressource Azure d’une destination de conteneur d’objets blob Stockage Azure où EventGrid doit annuler la remise des événements pour cet abonnement d’événements.

Exemple : --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft. Stockage/storageAccounts/sa1/blobServices/default/containers/containerName.

--deadletter-identity

Type d’identité de la ressource de destination deadletter.

Valeurs acceptées: systemassigned
--deadletter-identity-endpoint

ID de ressource Azure d’une destination de conteneur d’objets blob Stockage Azure avec l’identité où EventGrid doit annuler la remise des événements pour cet abonnement d’événements.

--delivery-identity

Type d’identité de la ressource de destination de remise (par exemple, file d’attente de stockage ou eventhub).

Valeurs acceptées: systemassigned
--delivery-identity-endpoint

Point de terminaison avec identité où EventGrid doit remettre des événements correspondant à cet abonnement d’événements. Pour le type de point de terminaison webhook, il doit s’agir de l’URL de webhook correspondante. Pour les autres types de points de terminaison, il doit s’agir de l’identificateur de ressource Azure du point de terminaison.

--delivery-identity-endpoint-type

Type du point de terminaison de destination avec l’identité de ressource.

Valeurs acceptées: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Point de terminaison où EventGrid doit remettre des événements correspondant à cet abonnement d’événements. Pour le type de point de terminaison webhook, il doit s’agir de l’URL de webhook correspondante. Pour les autres types de points de terminaison, il doit s’agir de l’identificateur de ressource Azure du point de terminaison.

--endpoint-type

Type du point de terminaison de destination.

Valeurs acceptées: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Valeur par défaut: webhook
--event-delivery-schema

Schéma dans lequel les événements doivent être remis pour cet abonnement d’événements. Par défaut, les événements sont remis dans le même schéma dans lequel ils sont publiés (en fonction du schéma d’entrée de la rubrique correspondante).

Valeurs acceptées: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Heure de vie de l’événement (en minutes). Doit être un nombre compris entre 1 et 1440.

Valeur par défaut: 1440
--expiration-date

Date ou datetime (en UTC, par exemple « 2018-11-30T11 :59 :59+00 :00 » ou « 2018-11-30 ») après quoi l’abonnement à l’événement expire. Par défaut, il n’y a pas d’expiration pour l’abonnement à l’événement.

--included-event-types

Liste séparée par un espace des types d’événements. Exemple : Microsoft. Stockage. BlobCreated Microsoft. Stockage. BlobDeleted. Pour vous abonner à tous les types d’événements par défaut, ne spécifiez aucune valeur pour cet argument.

--labels

Liste d’étiquettes séparées par un espace à associer à cet abonnement d’événements.

--max-delivery-attempts

Nombre maximal de tentatives de remise. Doit être un nombre compris entre 1 et 30.

Valeur par défaut: 30
--max-events-per-batch

Nombre maximal d’événements dans un lot. Doit être un nombre compris entre 1 et 5000.

--preferred-batch-size-in-kilobytes

Taille de lot préférée en kilo-octets. Doit être un nombre compris entre 1 et 1024.

--source-resource-id

Identificateur complet de la ressource Azure à laquelle l’abonnement aux événements doit être créé.

Utilisation : --source-resource-id Azure-Resource-ID pour l’abonnement Azure : --source-resource-id /subscriptions/{SubID} pour le groupe de ressources : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 pour la rubrique EventGrid : --source-resource -id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Pour le compte de stockage : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Stockage/storageaccounts/sa1 Pour le domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Pour la rubrique de domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Chaîne facultative permettant de filtrer les événements d’un abonnement aux événements en fonction d’un préfixe. Les caractères génériques ne sont pas pris en charge.

--subject-case-sensitive

Spécifiez pour indiquer si les champs d’objet doivent être comparés de manière sensible à la casse. True si l’indicateur est présent.

Valeurs acceptées: false, true
Valeur par défaut: False
--subject-ends-with

Chaîne facultative pour filtrer les événements d’un abonnement aux événements en fonction d’un suffixe. Les caractères génériques ne sont pas pris en charge.

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 eventgrid event-subscription delete

Supprimer un abonnement à un événement.

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Exemples

Supprimez un abonnement aux événements pour une rubrique Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Supprimez un abonnement aux événements pour une rubrique de domaine Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Supprimez un abonnement aux événements pour un domaine Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Supprimez un abonnement à un événement pour un abonnement Azure.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

Supprimez un abonnement à un événement pour un groupe de ressources.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Supprimez un abonnement aux événements pour un compte de stockage.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

Paramètres obligatoires

--name -n

Nom de l’abonnement aux événements.

Paramètres facultatifs

--source-resource-id

Identificateur complet de la ressource Azure dont l’abonnement aux événements doit être supprimé.

Utilisation : --source-resource-id Azure-Resource-ID pour l’abonnement Azure : --source-resource-id /subscriptions/{SubID} pour le groupe de ressources : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 pour la rubrique EventGrid : --source-resource -id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Pour le compte de stockage : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Stockage/storageaccounts/sa1 Pour le domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Pour la rubrique de domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

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 eventgrid event-subscription delete (eventgrid extension)

Préversion

Le groupe de commandes « az eventgrid » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Supprimer un abonnement à un événement.

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Exemples

Supprimez un abonnement aux événements pour une rubrique Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Supprimez un abonnement aux événements pour une rubrique de domaine Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Supprimez un abonnement aux événements pour un domaine Event Grid.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Supprimez un abonnement à un événement pour un abonnement Azure.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

Supprimez un abonnement à un événement pour un groupe de ressources.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Supprimez un abonnement aux événements pour un compte de stockage.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

Paramètres obligatoires

--name -n

Nom de l’abonnement aux événements.

Paramètres facultatifs

--source-resource-id

Identificateur complet de la ressource Azure dont l’abonnement aux événements doit être supprimé.

Utilisation : --source-resource-id Azure-Resource-ID pour l’abonnement Azure : --source-resource-id /subscriptions/{SubID} pour le groupe de ressources : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 pour la rubrique EventGrid : --source-resource -id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Pour le compte de stockage : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Stockage/storageaccounts/sa1 Pour le domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Pour la rubrique de domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

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 eventgrid event-subscription list

Répertorier les abonnements aux événements.

Event Grid prend en charge les abonnements aux événements régionaux et globaux : les abonnements aux événements sur les ressources régionales (tels que les comptes Stockage ou les rubriques Event Grid) sont régionaux, tandis que les abonnements aux événements sur des ressources globales (comme un abonnement Azure ou un groupe de ressources) sont globaux. Par conséquent, vous pouvez répertorier les abonnements aux événements de plusieurs façons :

  1. Pour répertorier par l’ID de ressource de la ressource dont vous souhaitez répertorier les abonnements aux événements, spécifiez le paramètre --source-resource-id. Aucun autre paramètre ne doit être spécifié.
  2. Pour répertorier par type de rubrique (par exemple, les comptes de stockage), spécifiez le paramètre --topic-type avec le paramètre --location (par exemple, « westus2 »). Pour les types de rubriques globales (par exemple, « Microsoft.Resources.Subscriptions »), spécifiez la valeur d’emplacement comme « global ».
  3. Pour répertorier tous les abonnements aux événements d’une région (entre tous les types de rubriques), spécifiez uniquement le paramètre --location.
  4. Pour #2 et #3 ci-dessus, pour filtrer uniquement par un groupe de ressources, vous pouvez également spécifier le paramètre --resource-group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Exemples

Répertoriez tous les abonnements aux événements créés pour une rubrique Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Répertoriez tous les abonnements aux événements créés pour un compte de stockage.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

Répertoriez tous les abonnements aux événements créés pour un abonnement Azure.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

Répertorier tous les abonnements aux événements créés pour un groupe de ressources.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Répertoriez tous les abonnements aux événements pour un domaine Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

Répertoriez tous les abonnements aux événements pour une rubrique de domaine Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Répertoriez tous les abonnements aux événements Stockage (sous l’abonnement Azure actuellement sélectionné) dans westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Répertoriez tous les abonnements aux événements Stockage (sous le groupe de ressources donné) dans westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Répertoriez tous les abonnements aux événements régionaux ou globaux (sous l’abonnement Azure actuellement sélectionné).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

Répertoriez tous les abonnements aux événements régionaux ou globaux sous un groupe de ressources spécifié.

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

Répertorier tous les abonnements aux événements pour un domaine Event Grid dont le nom contient le modèle « XYZ »

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Répertorier tous les abonnements aux événements pour un domaine Event Grid, à l’exception de l’abonnement aux événements portant le nom « name1 »

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

Paramètres facultatifs

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

--odata-query

Requête OData utilisée pour filtrer les résultats de la liste. Le filtrage est actuellement autorisé uniquement sur la propriété Name. Les opérations prises en charge sont les suivantes : CONTAINS, eq (pour égal), ne (pour pas égal), AND, OR et NOT.

--resource-group -g

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

--source-resource-id

Identificateur complet de la ressource Azure dont l’abonnement aux événements doit être répertorié.

Utilisation : --source-resource-id Azure-Resource-ID pour l’abonnement Azure : --source-resource-id /subscriptions/{SubID} pour le groupe de ressources : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 pour la rubrique EventGrid : --source-resource -id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Pour le compte de stockage : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Stockage/storageaccounts/sa1 Pour le domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Pour la rubrique de domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Nom du type de rubrique dont les abonnements aux événements doivent être répertoriés. Lorsque cela est spécifié, vous devez également spécifier --location.

Exemple 1 : Répertorier tous les abonnements d’événements Stockage dans WestUS2 --resource-group TestRG --topic-type-name Microsoft.Stockage. Stockage Accounts --location westus2 Exemple 2 : répertorier tous les abonnements aux événements sur les abonnements Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

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 eventgrid event-subscription list (eventgrid extension)

Préversion

Le groupe de commandes « az eventgrid » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertorier les abonnements aux événements.

Event Grid prend en charge les abonnements aux événements régionaux et globaux : les abonnements aux événements sur les ressources régionales (tels que les comptes Stockage ou les rubriques Event Grid) sont régionaux, tandis que les abonnements aux événements sur des ressources globales (comme un abonnement Azure ou un groupe de ressources) sont globaux. Par conséquent, vous pouvez répertorier les abonnements aux événements de plusieurs façons :

  1. Pour répertorier par l’ID de ressource de la ressource dont vous souhaitez répertorier les abonnements aux événements, spécifiez le paramètre --source-resource-id. Aucun autre paramètre ne doit être spécifié.
  2. Pour répertorier par type de rubrique (par exemple, les comptes de stockage), spécifiez le paramètre --topic-type avec le paramètre --location (par exemple, « westus2 »). Pour les types de rubriques globales (par exemple, « Microsoft.Resources.Subscriptions »), spécifiez la valeur d’emplacement comme « global ».
  3. Pour répertorier tous les abonnements aux événements d’une région (entre tous les types de rubriques), spécifiez uniquement le paramètre --location.
  4. Pour #2 et #3 ci-dessus, pour filtrer uniquement par un groupe de ressources, vous pouvez également spécifier le paramètre --resource-group.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Exemples

Répertoriez tous les abonnements aux événements créés pour une rubrique Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Répertoriez tous les abonnements aux événements créés pour un compte de stockage.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

Répertoriez tous les abonnements aux événements créés pour un abonnement Azure.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

Répertorier tous les abonnements aux événements créés pour un groupe de ressources.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Répertoriez tous les abonnements aux événements pour un domaine Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

Répertoriez tous les abonnements aux événements pour une rubrique de domaine Event Grid.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Répertoriez tous les abonnements aux événements Stockage (sous l’abonnement Azure actuellement sélectionné) dans westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Répertoriez tous les abonnements aux événements Stockage (sous le groupe de ressources donné) dans westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Répertoriez tous les abonnements aux événements régionaux ou globaux (sous l’abonnement Azure actuellement sélectionné).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

Répertoriez tous les abonnements aux événements régionaux ou globaux sous un groupe de ressources spécifié.

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

Répertorier tous les abonnements aux événements pour un domaine Event Grid dont le nom contient le modèle « XYZ »

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Répertorier tous les abonnements aux événements pour un domaine Event Grid, à l’exception de l’abonnement aux événements portant le nom « name1 »

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

Paramètres facultatifs

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

--odata-query

Requête utilisée pour filtrer les résultats à l’aide de la syntaxe OData.

--resource-group -g

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

--source-resource-id

Identificateur complet de la ressource Azure dont l’abonnement aux événements doit être répertorié.

Utilisation : --source-resource-id Azure-Resource-ID pour l’abonnement Azure : --source-resource-id /subscriptions/{SubID} pour le groupe de ressources : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 pour la rubrique EventGrid : --source-resource -id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Pour le compte de stockage : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Stockage/storageaccounts/sa1 Pour le domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Pour la rubrique de domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Nom du type de rubrique dont les abonnements aux événements doivent être répertoriés. Lorsque cela est spécifié, vous devez également spécifier --location.

Exemple 1 : Répertorier tous les abonnements d’événements Stockage dans WestUS2 --resource-group TestRG --topic-type-name Microsoft.Stockage. Stockage Accounts --location westus2 Exemple 2 : répertorier tous les abonnements aux événements sur les abonnements Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

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 eventgrid event-subscription show

Obtenez les détails d’un abonnement aux événements.

az eventgrid event-subscription show --name
                                     [--include-attrib-secret {false, true}]
                                     [--include-full-endpoint-url {false, true}]
                                     [--source-resource-id]

Exemples

Affichez les détails d’un abonnement aux événements pour une rubrique Event Grid.

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

Affichez les détails d’un abonnement aux événements pour un abonnement Azure.

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

Afficher les détails d’un abonnement à un événement pour un groupe de ressources.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

Affichez les détails d’un abonnement aux événements pour un compte de stockage.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

Affichez les détails d’un abonnement aux événements pour un groupe de ressources, y compris les secrets d’attribut de remise statique.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 \
    --include-static-delivery-attribute-secret

Paramètres obligatoires

--name -n

Nom de l’abonnement aux événements.

Paramètres facultatifs

--include-attrib-secret --include-static-delivery-attribute-secret

Indiquez si des secrets d’attribut de remise statique doivent être retournés. True si l’indicateur est présent.

Valeurs acceptées: false, true
Valeur par défaut: False
--include-full-endpoint-url

Spécifiez pour indiquer si l’URL de point de terminaison complète doit être retournée. True si l’indicateur est présent.

Valeurs acceptées: false, true
Valeur par défaut: False
--source-resource-id

Identificateur complet de la ressource Azure dont l’abonnement aux événements doit être affiché.

Utilisation : --source-resource-id Azure-Resource-ID pour l’abonnement Azure : --source-resource-id /subscriptions/{SubID} pour le groupe de ressources : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 pour la rubrique EventGrid : --source-resource -id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Pour le compte de stockage : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Stockage/storageaccounts/sa1 Pour le domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Pour la rubrique de domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

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 eventgrid event-subscription show (eventgrid extension)

Préversion

Le groupe de commandes « az eventgrid » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Obtenez les détails d’un abonnement aux événements.

az eventgrid event-subscription show --name
                                     [--include-full-endpoint-url {false, true}]
                                     [--source-resource-id]

Exemples

Affichez les détails d’un abonnement aux événements pour une rubrique Event Grid.

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

Affichez les détails d’un abonnement aux événements pour un abonnement Azure.

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

Afficher les détails d’un abonnement à un événement pour un groupe de ressources.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

Affichez les détails d’un abonnement aux événements pour un compte de stockage.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

Paramètres obligatoires

--name -n

Nom de l’abonnement aux événements.

Paramètres facultatifs

--include-full-endpoint-url

Spécifiez pour indiquer si l’URL de point de terminaison complète doit être retournée. True si l’indicateur est présent.

Valeurs acceptées: false, true
Valeur par défaut: False
--source-resource-id

Identificateur complet de la ressource Azure dont l’abonnement aux événements doit être affiché.

Utilisation : --source-resource-id Azure-Resource-ID pour l’abonnement Azure : --source-resource-id /subscriptions/{SubID} pour le groupe de ressources : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 pour la rubrique EventGrid : --source-resource -id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Pour le compte de stockage : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Stockage/storageaccounts/sa1 Pour le domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Pour la rubrique de domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

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 eventgrid event-subscription update

Mettez à jour un abonnement aux événements.

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Exemples

Mettez à jour un abonnement aux événements d’une rubrique Event Grid pour spécifier un nouveau point de terminaison.

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Mettez à jour un abonnement aux événements pour un abonnement Azure afin de spécifier un nouveau filtre avec objet.

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

Mettez à jour un abonnement aux événements d’un groupe de ressources pour spécifier un nouveau point de terminaison et un nouveau filtre subject-ends-with.

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Mettez à jour un abonnement aux événements pour un compte de stockage afin de spécifier une nouvelle liste de types d’événements inclus.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Mettez à jour un abonnement aux événements pour un compte de stockage afin d’inclure une destination deadletter.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Mettez à jour un abonnement aux événements pour un compte de stockage à l’aide de filtres avancés.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Mettez à jour un abonnement aux événements pour un compte de stockage afin d’inclure la durée de vie du message définie sur 5 minutes.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --storage-queue-msg-ttl 300

Mettre à jour un abonnement aux événements avec filtrage avancé activé sur les tableaux

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --enable-advanced-filtering-on-arrays true

Paramètres obligatoires

--name -n

Nom de l’abonnement aux événements.

Paramètres facultatifs

--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: []
--advanced-filter

Un filtre avancé permet de filtrer les événements en fonction d’une propriété d’événement spécifique.

Utilisation : --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn : --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn : --advanced-filter data. Color StringNotIn Blue Red Orange StringContains : --advanced-filter subject StringContains Blue Red StringNotContains : --advanced-filter subject StringNotContains Blue Red StringBeginsWith : --advanced-filter subject StringBeginsWithsWith : --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith : --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith : --advanced-filter subject StringNotEndsWith img png numberIn : --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn : --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange : --advanced-filter data.property2 NumberNotInInRange 100 110 200 210 300 310 NumberLessThan : --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals : --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan : --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals : --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals : --advanced-filter data.property3 BoolEquals true IsNullOrUndefined : --advanced-filter data.property3 IsNullOrUndefined IsNotNull : --advanced-filter data.property3 IsNotNull Plusieurs filtres avancés peuvent être spécifiés à l’aide de plusieurs --advanced-filter arguments.

--deadletter-endpoint

ID de ressource Azure d’une destination de conteneur d’objets blob Stockage Azure où EventGrid doit annuler la remise des événements pour cet abonnement d’événements.

--deadletter-identity
Préversion

Type d’identité de la ressource de destination deadletter.

Valeurs acceptées: systemassigned
--deadletter-identity-endpoint

ID de ressource Azure d’une destination de conteneur d’objets blob Stockage Azure avec l’identité où EventGrid doit annuler la remise des événements pour cet abonnement d’événements.

--delivery-attribute-mapping

Ajoutez le mappage d’attributs de remise pour envoyer des informations supplémentaires via des en-têtes HTTP lors de la remise d’événements. Cet attribut est valide pour tous les types de destination, sauf Stockage Queue. Plusieurs attributs peuvent être spécifiés à l’aide --delivery-attribute-mapping de plusieurs arguments.

Utilisation : --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Mappage d’attribut statique : --delivery-attribute-mapping somename static somevalue Static Attribute Mapping : --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping : --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping : --delivery-attribute-mapping dynamic somevalue both Static and Dynamic : -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Préversion

Type d’identité de la ressource de destination de remise (par exemple, file d’attente de stockage ou eventhub).

Valeurs acceptées: systemassigned
--delivery-identity-endpoint
Préversion

Point de terminaison avec identité où EventGrid doit remettre des événements correspondant à cet abonnement d’événements. Pour le type de point de terminaison webhook, il doit s’agir de l’URL de webhook correspondante. Pour les autres types de points de terminaison, il doit s’agir de l’identificateur de ressource Azure du point de terminaison.

--delivery-identity-endpoint-type
Préversion

Type du point de terminaison de destination avec l’identité de ressource.

Valeurs acceptées: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Permet aux filtres avancés d’être évalués par rapport à un tableau de valeurs au lieu d’attendre une valeur singulière.

Valeurs acceptées: false, true
--endpoint

Point de terminaison où EventGrid doit remettre des événements correspondant à cet abonnement d’événements. Pour le type de point de terminaison webhook, il doit s’agir de l’URL de webhook correspondante. Pour les autres types de points de terminaison, il doit s’agir de l’identificateur de ressource Azure du point de terminaison. Il est prévu que le point de terminaison de destination soit déjà créé et disponible pour une utilisation avant d’exécuter une commande Event Grid.

--endpoint-type

Type du point de terminaison de destination.

Valeur par défaut: webhook
--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
--included-event-types

Liste séparée par l’espace des types d’événements (par exemple, Microsoft.Stockage. BlobCreated et Microsoft. Stockage. BlobDeleted). Pour vous abonner à tous les types d’événements par défaut, ne spécifiez aucune valeur pour cet argument. Pour les rubriques Event Grid, les types d’événements sont définis par le client. Pour les événements Azure, par exemple, Stockage Comptes, IoT Hub, etc., vous pouvez interroger leurs types d’événements à l’aide de cette commande CLI « az eventgrid topic-type list-event-types ».

--labels

Liste d’étiquettes séparées par un espace à associer à cet abonnement d’événements.

--qttl --storage-queue-msg-ttl

Stockage délai de vie des messages de file d’attente en secondes.

--remove

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

Valeur par défaut: []
--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: []
--source-resource-id

Identificateur complet de la ressource Azure dont l’abonnement aux événements doit être mis à jour.

Utilisation : --source-resource-id Azure-Resource-ID pour l’abonnement Azure : --source-resource-id /subscriptions/{SubID} pour le groupe de ressources : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 pour la rubrique EventGrid : --source-resource -id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Pour le compte de stockage : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Stockage/storageaccounts/sa1 Pour le domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Pour la rubrique de domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Chaîne facultative permettant de filtrer les événements d’un abonnement aux événements en fonction d’un préfixe. Les caractères génériques ne sont pas pris en charge.

--subject-ends-with

Chaîne facultative pour filtrer les événements d’un abonnement aux événements en fonction d’un suffixe. Les caractères génériques ne sont pas pris en charge.

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 eventgrid event-subscription update (eventgrid extension)

Préversion

Le groupe de commandes « az eventgrid » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Mettez à jour un abonnement aux événements.

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--endpoint]
                                       [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Exemples

Mettez à jour un abonnement aux événements d’une rubrique Event Grid pour spécifier un nouveau point de terminaison.

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Mettez à jour un abonnement aux événements pour un abonnement Azure afin de spécifier un nouveau filtre avec objet.

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

Mettez à jour un abonnement aux événements d’un groupe de ressources pour spécifier un nouveau point de terminaison et un nouveau filtre subject-ends-with.

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Mettez à jour un abonnement aux événements pour un compte de stockage afin de spécifier une nouvelle liste de types d’événements inclus.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Mettez à jour un abonnement aux événements pour un compte de stockage afin d’inclure une destination deadletter.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Mettez à jour un abonnement aux événements pour un compte de stockage à l’aide de filtres avancés.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Paramètres obligatoires

--name -n

Nom de l’abonnement aux événements.

Paramètres facultatifs

--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: []
--advanced-filter

Un filtre avancé permet de filtrer les événements en fonction d’une propriété d’événement spécifique.

Utilisation : --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn : --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn : --advanced-filter data. Color StringNotIn Blue Red Orange StringContains : --advanced-filter subject StringContains Blue Red StringBeginsWith : --advanced-filter subject StringBeginsWith Blue Red StringEndsWith : --advanced-filter subject StringEndsWith img png NumberIn : --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn : --advanced-filter data.property2 NumberNotIn 100 200 300 NumberLessThan : --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals : --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan : --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals : --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals : --advanced-filter data.property3 BoolEquals true Plusieurs filtres avancés peuvent être spécifiés à l’aide de plusieurs --advanced-filter arguments.

--deadletter-endpoint

ID de ressource Azure d’une destination de conteneur d’objets blob Stockage Azure où EventGrid doit annuler la remise des événements pour cet abonnement d’événements.

--deadletter-identity

Type d’identité de la ressource de destination deadletter.

Valeurs acceptées: systemassigned
--deadletter-identity-endpoint

ID de ressource Azure d’une destination de conteneur d’objets blob Stockage Azure avec l’identité où EventGrid doit annuler la remise des événements pour cet abonnement d’événements.

--delivery-identity

Type d’identité de la ressource de destination de remise (par exemple, file d’attente de stockage ou eventhub).

Valeurs acceptées: systemassigned
--delivery-identity-endpoint

Point de terminaison avec identité où EventGrid doit remettre des événements correspondant à cet abonnement d’événements. Pour le type de point de terminaison webhook, il doit s’agir de l’URL de webhook correspondante. Pour les autres types de points de terminaison, il doit s’agir de l’identificateur de ressource Azure du point de terminaison.

--delivery-identity-endpoint-type

Type du point de terminaison de destination avec l’identité de ressource.

Valeurs acceptées: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Point de terminaison où EventGrid doit remettre des événements correspondant à cet abonnement d’événements. Pour le type de point de terminaison webhook, il doit s’agir de l’URL de webhook correspondante. Pour les autres types de points de terminaison, il doit s’agir de l’identificateur de ressource Azure du point de terminaison.

--endpoint-type

Type du point de terminaison de destination.

Valeurs acceptées: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Valeur par défaut: webhook
--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
--included-event-types

Liste séparée par un espace des types d’événements. Exemple : Microsoft. Stockage. BlobCreated Microsoft. Stockage. BlobDeleted. Pour vous abonner à tous les types d’événements par défaut, ne spécifiez aucune valeur pour cet argument.

--labels

Liste d’étiquettes séparées par un espace à associer à cet abonnement d’événements.

--remove

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

Valeur par défaut: []
--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: []
--source-resource-id

Identificateur complet de la ressource Azure dont l’abonnement aux événements doit être mis à jour.

Utilisation : --source-resource-id Azure-Resource-ID pour l’abonnement Azure : --source-resource-id /subscriptions/{SubID} pour le groupe de ressources : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 pour la rubrique EventGrid : --source-resource -id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Pour le compte de stockage : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Stockage/storageaccounts/sa1 Pour le domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Pour la rubrique de domaine EventGrid : --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Chaîne facultative permettant de filtrer les événements d’un abonnement aux événements en fonction d’un préfixe. Les caractères génériques ne sont pas pris en charge.

--subject-ends-with

Chaîne facultative pour filtrer les événements d’un abonnement aux événements en fonction d’un suffixe. Les caractères génériques ne sont pas pris en charge.

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.