Partager via

az eventgrid topic

  • Référence

Gérer les rubriques Azure Event Grid.

Commandes

Nom Description Type État
az eventgrid topic create

Créez une rubrique.

 Noyau GA
az eventgrid topic delete

Supprimez une rubrique.

 Noyau GA
az eventgrid topic event-subscription

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

 Noyau GA
az eventgrid topic event-subscription create

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

 Noyau GA
az eventgrid topic event-subscription delete

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

 Noyau GA
az eventgrid topic event-subscription list

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

 Noyau GA
az eventgrid topic event-subscription show

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

 Noyau GA
az eventgrid topic event-subscription update

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

 Noyau GA
az eventgrid topic key

Gérer les clés d’accès partagé d’une rubrique.

 Noyau GA
az eventgrid topic key list

Répertoriez les clés d’accès partagé d’une rubrique.

 Noyau GA
az eventgrid topic key regenerate

Régénérer une clé d’accès partagé d’une rubrique.

 Noyau GA
az eventgrid topic list

Répertorier les rubriques disponibles.

 Noyau GA
az eventgrid topic show

Obtenez les détails d’une rubrique.

 Noyau GA
az eventgrid topic update

Mettez à jour une rubrique.

 Noyau GA

az eventgrid topic create

Modifier

Créez une rubrique.

az eventgrid topic create --name
                          --resource-group
                          [--extended-location-name]
                          [--extended-location-type {customlocation}]
                          [--identity {noidentity, systemassigned}]
                          [--inbound-ip-rules]
                          [--input-mapping-default-values]
                          [--input-mapping-fields]
                          [--input-schema {cloudeventschemav1_0, customeventschema, eventgridschema}]
                          [--kind {azure, azurearc}]
                          [--location]
                          [--mi-system-assigned]
                          [--mi-user-assigned]
                          [--public-network-access {disabled, enabled}]
                          [--sku {basic, premium}]
                          [--tags]

Exemples

Créez une rubrique.

az eventgrid topic create -g rg1 --name topic1 -l westus2

Créez une rubrique avec des mappages d’entrée personnalisés.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --input-schema customeventschema --input-mapping-fields topic=myTopicField eventType=myEventTypeField --input-mapping-default-values subject=DefaultSubject dataVersion=1.0

Créez une rubrique qui accepte les événements publiés dans le schéma CloudEvents V1.0.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --input-schema cloudeventschemav1_0

Créer une rubrique qui autorise des règles ip entrantes spécifiques avec une référence SKU de base et une identité affectée par le système

az eventgrid topic create -g rg1 --name topic1 -l westus2 --public-network-access enabled --inbound-ip-rules 10.0.0.0/8 Allow --inbound-ip-rules 10.2.0.0/8 Allow --sku Basic --identity systemassigned

Créez une rubrique dans Azure.

az eventgrid topic create -g rg1 --name topic1 -l westus2

Créez une rubrique dans Azure.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --kind azure

Créez une rubrique dans AzureArc ciblant un emplacement personnalisé.

az eventgrid topic create -g rg1 --name topic1 -l eastus2euap --kind azurearc --extended-location-name /subscriptions/<subid>/resourcegroups/<rgname>/providers/microsoft.extendedlocation/customlocations/<cust-loc-name> --extended-location-type customlocation --input-schema CloudEventSchemaV1_0

Paramètres obligatoires

--name -n

Nom de la rubrique.

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

--extended-location-name
Préversion

Nom de l’emplacement étendu si kind===azurearc.

--extended-location-type
Préversion

Type d’emplacement étendu si kind===azurearc.

Valeurs acceptées: customlocation
--identity
Préversion Déprécié

L’argument 'identity' a été déprécié et sera supprimé dans une version ultérieure.

Type d’identité managée pour la ressource. Sera déconseillé et remplacé par --mi-system-assigned-identity à l’avenir.

Valeurs acceptées: noidentity, systemassigned
--inbound-ip-rules

Liste des règles IP de trafic entrant.

Liste des règles IP entrantes spécifiant l’adresse IP dans la notation CIDR, par exemple, 10.0.0.0/8, ainsi que l’action correspondante à effectuer en fonction de la correspondance ou de l’absence de correspondance de l’ipmask. Valeurs possibles : Autoriser.

--input-mapping-default-values

Lorsque le schéma d’entrée est spécifié en tant que customeventschema, ce paramètre peut être utilisé pour spécifier des mappages d’entrée en fonction des valeurs par défaut. Vous pouvez utiliser ce paramètre lorsque votre schéma personnalisé n’inclut pas de champ qui correspond à l’un des trois champs pris en charge par ce paramètre. Spécifiez des mappages séparés par espace au format « key=value ». Les noms de clés autorisés sont « subject », « eventtype », « dataversion ». Les noms de valeurs correspondants doivent spécifier les valeurs par défaut à utiliser pour le mappage et elles ne seront utilisées que lorsque l’événement publié n’a pas de mappage valide pour un champ particulier.

--input-mapping-fields

Lorsque le schéma d’entrée est spécifié en tant que customeventschema, ce paramètre est utilisé pour spécifier des mappages d’entrée en fonction des noms de champs. Spécifiez des mappages séparés par espace au format « key=value ». Les noms de clés autorisés sont « id », « topic », « eventtime », « subject », « eventtype », « dataversion ». Les noms de valeurs correspondants doivent spécifier les noms des champs dans le schéma d’entrée personnalisé. Si un mappage pour « id » ou « eventtime » n’est pas fourni, Event Grid génère automatiquement une valeur par défaut pour ces deux champs.

--input-schema

Schéma dans lequel les événements entrants seront publiés dans cette rubrique/domaine. Si vous spécifiez customeventschema comme valeur pour ce paramètre, vous devez également fournir des valeurs pour au moins un de --input_mapping_default_values / --input_mapping_fields.

Valeurs acceptées: cloudeventschemav1_0, customeventschema, eventgridschema
Valeur par défaut: eventgridschema
--kind
Préversion

Type de ressource de rubrique.

Valeurs acceptées: azure, azurearc
Valeur par défaut: Azure
--location -l

Emplacement. Valeurs de : az account list-locations. Vous pouvez configurer l’emplacement par défaut à l’aide de az configure --defaults location=<location>.

--mi-system-assigned

La présence de cet analyseur indique que l’identité managée SystemAssigned sera utilisée.

--mi-user-assigned
Préversion

Ajoutez des identités affectées par l’utilisateur lorsque identityType est utilisateur ou mixte. 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 --mi-user-assigned.

--public-network-access

Cela détermine si le trafic est autorisé sur le réseau public. Par défaut, elle est activée. Vous pouvez restreindre davantage les adresses IP spécifiques en configurant.

Valeurs acceptées: disabled, enabled
--sku
Préversion

Nom de la référence SKU de la ressource.

Valeurs acceptées: basic, premium
Valeur par défaut: Basic
--tags

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ê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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az eventgrid topic delete

Modifier

Supprimez une rubrique.

az eventgrid topic delete [--ids]
                          [--name]
                          [--resource-group]
                          [--subscription]

Exemples

Supprimez une rubrique.

az eventgrid topic delete -g rg1 --name topic1

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de la rubrique.

--resource-group -g

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

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ê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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az eventgrid topic list

Modifier

Répertorier les rubriques disponibles.

az eventgrid topic list [--odata-query]
                        [--resource-group]

Exemples

Répertoriez toutes les rubriques de l’abonnement Azure actuel.

az eventgrid topic list

Répertorier toutes les rubriques d’un groupe de ressources.

az eventgrid topic list -g rg1

Répertorier toutes les rubriques d’un groupe de ressources dont le nom contient le modèle « XYZ »

az eventgrid topic list -g rg1 --odata-query "Contains(name, 'XYZ')"

Répertorier toutes les rubriques d’un groupe de ressources, à l’exception du domaine portant le nom « name1 »

az eventgrid topic list -g rg1 --odata-query "NOT (name eq 'name1')"

Paramètres facultatifs

--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 à l’aide de az configure --defaults group=<name>.

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ê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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az eventgrid topic show

Modifier

Obtenez les détails d’une rubrique.

az eventgrid topic show [--ids]
                        [--name]
                        [--resource-group]
                        [--subscription]

Exemples

Afficher les détails d’une rubrique.

az eventgrid topic show -g rg1 -n topic1

Affichez les détails d’une rubrique en fonction de l’ID de ressource.

az eventgrid topic show --ids /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Paramètres facultatifs

--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--name -n

Nom de la rubrique.

--resource-group -g

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

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ê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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.

az eventgrid topic update

Modifier

Mettez à jour une rubrique.

az eventgrid topic update [--identity {noidentity, systemassigned}]
                          [--ids]
                          [--inbound-ip-rules]
                          [--mi-system-assigned]
                          [--mi-user-assigned]
                          [--name]
                          [--public-network-access {disabled, enabled}]
                          [--resource-group]
                          [--sku {basic, premium}]
                          [--subscription]
                          [--tags]

Exemples

Mettez à jour les propriétés d’une rubrique existante avec de nouvelles informations d’accès au réseau public, d’identité et de référence SKU.

az eventgrid topic update -g rg1 --name topic1 --sku Premium --identity systemassigned --public-network-access enabled --inbound-ip-rules 10.0.0.0/8 Allow --inbound-ip-rules 10.2.0.0/8 Allow --tags Dept=IT --sku basic

Paramètres facultatifs

--identity
Préversion Déprécié

L’argument 'identity' a été déprécié et sera supprimé dans une version ultérieure.

Type d’identité managée pour la ressource. Sera déconseillé et remplacé par --mi-system-assigned-identity à l’avenir.

Valeurs acceptées: noidentity, systemassigned
--ids

Un ou plusieurs ID de ressource (délimités par l’espace). Il doit s’agir d’un ID de ressource complet contenant toutes les informations des arguments « ID de ressource ». Vous devez fournir des arguments --id ou d’autres arguments « ID de ressource ».

--inbound-ip-rules

Liste des règles IP entrantes spécifiant l’adresse IP dans la notation CIDR, par exemple, 10.0.0.0/8, ainsi que l’action correspondante à effectuer en fonction de la correspondance ou de l’absence de correspondance de l’ipmask. Valeurs possibles : Autoriser.

--mi-system-assigned

La présence de cet analyseur indique que l’identité managée SystemAssigned sera utilisée.

--mi-user-assigned
Préversion

Ajoutez des identités affectées par l’utilisateur lorsque identityType est utilisateur ou mixte. 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 --mi-user-assigned.

--name -n

Nom de la rubrique.

--public-network-access

Cela détermine si le trafic est autorisé sur le réseau public. Par défaut, elle est activée. Vous pouvez restreindre davantage les adresses IP spécifiques en configurant.

Valeurs acceptées: disabled, enabled
--resource-group -g

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

--sku
Préversion

Nom de la référence SKU de la ressource.

Valeurs acceptées: basic, premium
--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.

--tags

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

Paramètres globaux
--debug

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

--help -h

Affichez ce message d’aide et quittez-le.

--only-show-errors

Affiche 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ê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 la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.