Partager via


az eventgrid partner topic event-subscription

Gérer les abonnements aux événements de la rubrique partenaire.

Commandes

Nom Description Type État
az eventgrid partner topic event-subscription create

Créez un abonnement à un événement pour une rubrique partenaire.

Core GA
az eventgrid partner topic event-subscription delete

Supprimez un abonnement à un événement d’une rubrique partenaire.

Core GA
az eventgrid partner topic event-subscription list

Répertorier les abonnements aux événements d’une rubrique partenaire spécifique.

Core GA
az eventgrid partner topic event-subscription show

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

Core GA
az eventgrid partner topic event-subscription update

Mettez à jour un abonnement aux événements d’une rubrique partenaire.

Core GA

az eventgrid partner topic event-subscription create

Créez un abonnement à un événement pour une rubrique partenaire.

az eventgrid partner topic event-subscription create --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--aad-tenant-id --azure-active-directory-tenant-id]
                                                     [--advanced-filter]
                                                     [--azure-active-directory-application-id-or-uri]
                                                     [--deadletter-endpoint]
                                                     [--delivery-attribute-mapping]
                                                     [--enable-advanced-filtering-on-arrays --enable-af-arr {false, true}]
                                                     [--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]
                                                     [--qttl --storage-queue-msg-ttl]
                                                     [--subject-begins-with]
                                                     [--subject-case-sensitive {false, true}]
                                                     [--subject-ends-with]

Exemples

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

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Créez un abonnement aux événements pour une rubrique partenaire Event Grid, avec un filtre spécifiant un préfixe d’objet.

az eventgrid partner topic event-subscription create --name es4 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

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

az eventgrid partner topic event-subscription create -n es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Créez un abonnement aux événements pour un partenaire Event Grid, avec une stratégie de nouvelle tentative 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 (le cas échéant) et la date d’expiration.

az eventgrid partner topic event-subscription create --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 --expiration-date "2022-10-31"

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

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partenaire Event Grid à l’aide d’Azure Function en tant que destination.

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partenaire Event Grid à l’aide de la file d’attente de stockage en tant que destination avec la durée de vie du message à 5 minutes

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partenaire Event Grid avec filtrage avancé sur les tableaux activés

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 à l’événement.

--partner-topic-name

Nom de la rubrique partenaire.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Propriété Valeur
Groupe de paramètres: Filtering 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 dans laquelle EventGrid doit annuler la remise des événements pour cet abonnement d’événements.

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

--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, à l’exception de StorageQueue. Plusieurs attributs peuvent être spécifiés à l’aide de plusieurs arguments --delivery-attribute-mapping.

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.

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

Propriété Valeur
Groupe de paramètres: Filtering Arguments
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.

Propriété Valeur
Valeur par défaut: webhook
Valeurs acceptées: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, 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).

Propriété Valeur
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.

Propriété Valeur
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.Storage.BlobCreated et Microsoft.Storage.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, les comptes de stockage, IoT Hub, etc., vous pouvez interroger leurs types d’événements à l’aide de cette commande CLI « az eventgrid topic-type list-event-types ».

Propriété Valeur
Groupe de paramètres: Filtering Arguments
--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.

Propriété Valeur
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

Durée de vie des messages de file d’attente du stockage en secondes.

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

Propriété Valeur
Groupe de paramètres: Filtering Arguments
--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.

Propriété Valeur
Groupe de paramètres: Filtering Arguments
Valeur par défaut: False
Valeurs acceptées: false, true
--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.

Propriété Valeur
Groupe de paramètres: Filtering Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az eventgrid partner topic event-subscription delete

Supprimez un abonnement à un événement d’une rubrique partenaire.

az eventgrid partner topic event-subscription delete --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--yes]

Exemples

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

az eventgrid partner topic event-subscription delete --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \

Paramètres obligatoires

--name -n

Nom de l’abonnement à l’événement.

--partner-topic-name

Nom de la rubrique partenaire.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

--yes -y

N’invitez pas à confirmer.

Propriété Valeur
Valeur par défaut: False
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az eventgrid partner topic event-subscription list

Répertorier les abonnements aux événements d’une rubrique partenaire spécifique.

az eventgrid partner topic event-subscription list --partner-topic-name
                                                   --resource-group
                                                   [--odata-query]

Exemples

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

az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1

Paramètres obligatoires

--partner-topic-name

Nom de la rubrique partenaire.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az eventgrid partner topic event-subscription show

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

az eventgrid partner topic event-subscription show --name
                                                   --partner-topic-name
                                                   --resource-group
                                                   [--include-attrib-secret --include-static-delivery-attribute-secret {false, true}]
                                                   [--include-full-endpoint-url {false, true}]

Exemples

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

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1

Afficher les détails d’un abonnement aux événements pour une rubrique partenaire Event Grid et inclure des secrets d’attribut de remise statiques

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1 --include-static-delivery-attribute-secret

Paramètres obligatoires

--name -n

Nom de l’abonnement à l’événement.

--partner-topic-name

Nom de la rubrique partenaire.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
--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.

Propriété Valeur
Valeur par défaut: False
Valeurs acceptées: false, true
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False

az eventgrid partner topic event-subscription update

Mettez à jour un abonnement aux événements d’une rubrique partenaire.

az eventgrid partner topic event-subscription update --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--advanced-filter]
                                                     [--deadletter-endpoint]
                                                     [--delivery-attribute-mapping]
                                                     [--enable-advanced-filtering-on-arrays --enable-af-arr {false, true}]
                                                     [--endpoint]
                                                     [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                     [--included-event-types]
                                                     [--labels]
                                                     [--qttl --storage-queue-msg-ttl]
                                                     [--subject-begins-with]
                                                     [--subject-ends-with]

Exemples

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

az eventgrid partner topic event-subscription update --name es1 \
    -g rg1 --partner-topic-name partnertopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Mettez à jour un abonnement aux événements d’une rubrique partenaire Event Grid pour spécifier un nouveau filtre de fin d’objet.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .jpg

Mettez à jour un abonnement aux événements d’une rubrique partenaire Event Grid pour spécifier un nouveau point de terminaison et un nouveau sujet se termine par filtrer une nouvelle liste de types d’événements inclus.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Mettez à jour un abonnement aux événements pour une rubrique partenaire Azure Event Grid afin d’inclure une destination deadletter.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Mettez à jour un abonnement aux événements pour une rubrique partenaire Azure Event Grid à l’aide de filtres avancés.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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

Mettre à jour un abonnement aux événements pour une rubrique partenaire Event Grid à l’aide de la file d’attente de stockage comme destination avec la durée de vie du message à 5 minutes

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Mettre à jour un abonnement aux événements pour une rubrique partenaire Event Grid avec filtrage avancé sur les tableaux activés

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 à l’événement.

--partner-topic-name

Nom de la rubrique partenaire.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut à l’aide de az configure --defaults group=<name>.

Paramètres facultatifs

Les paramètres suivants sont facultatifs, mais en fonction du contexte, un ou plusieurs peuvent être nécessaires pour que la commande s’exécute correctement.

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

Propriété Valeur
Groupe de paramètres: Filtering Arguments
--deadletter-endpoint

ID de ressource Azure d’une destination de conteneur d’objets blob Stockage Azure dans laquelle 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, à l’exception de StorageQueue. Plusieurs attributs peuvent être spécifiés à l’aide de plusieurs arguments --delivery-attribute-mapping.

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.

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

Propriété Valeur
Groupe de paramètres: Filtering Arguments
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.

Propriété Valeur
Valeur par défaut: webhook
Valeurs acceptées: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--included-event-types

Liste séparée par l’espace des types d’événements (par exemple, Microsoft.Storage.BlobCreated et Microsoft.Storage.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, les comptes de stockage, IoT Hub, etc., vous pouvez interroger leurs types d’événements à l’aide de cette commande CLI « az eventgrid topic-type list-event-types ».

Propriété Valeur
Groupe de paramètres: Filtering Arguments
--labels

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

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

Durée de vie des messages de file d’attente du stockage en secondes.

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

Propriété Valeur
Groupe de paramètres: Filtering Arguments
--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.

Propriété Valeur
Groupe de paramètres: Filtering Arguments
Paramètres globaux
--debug

Augmentez la verbosité de la journalisation pour afficher tous les logs de débogage.

Propriété Valeur
Valeur par défaut: False
--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

Propriété Valeur
Valeur par défaut: False
--output -o

Format de sortie.

Propriété Valeur
Valeur par défaut: json
Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
--query

Chaîne de requête 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 à l’aide de az account set -s NAME_OR_ID.

--verbose

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

Propriété Valeur
Valeur par défaut: False