Partager via

az eventgrid topic

Gérer les rubriques Azure Event Grid.

Commandes

Nom Description Type État
az eventgrid topic create

créer une rubrique ;

 Core GA
az eventgrid topic delete

Supprimez une rubrique.

 Core GA
az eventgrid topic event-subscription

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

 Core GA
az eventgrid topic event-subscription create

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

 Core GA
az eventgrid topic event-subscription delete

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

 Core GA
az eventgrid topic event-subscription list

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

 Core GA
az eventgrid topic event-subscription show

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

 Core GA
az eventgrid topic event-subscription update

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

 Core GA
az eventgrid topic key

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

 Core GA
az eventgrid topic key list

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

 Core GA
az eventgrid topic key regenerate

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

 Core GA
az eventgrid topic list

Répertorier les rubriques disponibles.

 Core GA
az eventgrid topic show

Obtenez les détails d’une rubrique.

 Core GA
az eventgrid topic update

Mettez à jour une rubrique.

 Core GA

az eventgrid topic create

Modifier

créer 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

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.

--extended-location-name
Préversion

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

Propriété Valeur
Groupe de paramètres: Azure Arc Arguments
--extended-location-type
Préversion

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

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

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

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

Type de ressource de rubrique.

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

Location. Valeurs provenant 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.

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

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

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

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

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

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.

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom de la rubrique.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

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

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

Propriété Valeur
Groupe de paramètres: Resource Id 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/.

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

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.

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

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.

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--name -n

Nom de la rubrique.

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--resource-group -g

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

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

Propriété Valeur
Groupe de paramètres: Resource Id 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/.

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

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.

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

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

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

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

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--sku
Préversion

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

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

Propriété Valeur
Groupe de paramètres: Resource Id Arguments
--tags

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

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

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