Delen via

az eventgrid topic

  • Referentie

Azure Event Grid-onderwerpen beheren.

Opdracht

Name Description Type Status
az eventgrid topic create

Een onderwerp maken.

 Kern GA
az eventgrid topic delete

Een onderwerp verwijderen.

 Kern GA
az eventgrid topic event-subscription

Gebeurtenisabonnementen van onderwerp beheren.

 Kern GA
az eventgrid topic event-subscription create

Maak een nieuw gebeurtenisabonnement voor een onderwerp.

 Kern GA
az eventgrid topic event-subscription delete

Een gebeurtenisabonnement van een onderwerp verwijderen.

 Kern GA
az eventgrid topic event-subscription list

Lijst met gebeurtenisabonnementen van een specifiek onderwerp.

 Kern GA
az eventgrid topic event-subscription show

De details van een gebeurtenisabonnement van een onderwerp ophalen.

 Kern GA
az eventgrid topic event-subscription update

Een gebeurtenisabonnement van een onderwerp bijwerken.

 Kern GA
az eventgrid topic key

Gedeelde toegangssleutels van een onderwerp beheren.

 Kern GA
az eventgrid topic key list

Gedeelde toegangssleutels van een onderwerp weergeven.

 Kern GA
az eventgrid topic key regenerate

Genereer een gedeelde toegangssleutel van een onderwerp opnieuw.

 Kern GA
az eventgrid topic list

Lijst met beschikbare onderwerpen.

 Kern GA
az eventgrid topic show

De details van een onderwerp ophalen.

 Kern GA
az eventgrid topic update

Een onderwerp bijwerken.

 Kern GA

az eventgrid topic create

Bewerken

Een onderwerp maken.

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]

Voorbeelden

Maak een nieuw onderwerp.

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

Maak een nieuw onderwerp met aangepaste invoertoewijzingen.

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

Maak een nieuw onderwerp dat gebeurtenissen accepteert die zijn gepubliceerd in het CloudEvents V1.0-schema.

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

Een nieuw onderwerp maken waarmee specifieke binnenkomende IP-regels met basis-SKU en door het systeem toegewezen identiteit zijn toegestaan

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

Maak een nieuw onderwerp in Azure.

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

Maak een nieuw onderwerp in Azure.

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

Maak een nieuw onderwerp in AzureArc dat is gericht op een aangepaste locatie.

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

Vereiste parameters

--name -n

Naam van het onderwerp.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Optionele parameters

--extended-location-name
Preview

De naam van de uitgebreide locatie als kind==azurearc.

--extended-location-type
Preview

Het uitgebreide locatietype als soort==azurearc.

Geaccepteerde waarden: customlocation
--identity
Preview Afgeschaft

Argument 'identiteit' is afgeschaft en wordt verwijderd in een toekomstige release.

Het type beheerde identiteit voor de resource. Wordt in de toekomst afgeschaft en vervangen door --mi-system-assigned-identity.

Geaccepteerde waarden: noidentity, systemassigned
--inbound-ip-rules

Lijst met binnenkomende IP-regels.

Lijst met binnenkomende IP-regels die IP-adres opgeven in CIDR-notatie, bijvoorbeeld 10.0.0.0/8, samen met de bijbehorende actie die moet worden uitgevoerd op basis van de overeenkomst of geen overeenkomst van de IpMask. Mogelijke waarden zijn : Toestaan.

--input-mapping-default-values

Wanneer invoerschema is opgegeven als customeventschema, kan deze parameter worden gebruikt om invoertoewijzingen op te geven op basis van standaardwaarden. U kunt deze parameter gebruiken wanneer uw aangepaste schema geen veld bevat dat overeenkomt met een van de drie velden die door deze parameter worden ondersteund. Geef door spaties gescheiden toewijzingen op in de indeling 'key=value'. Toegestane sleutelnamen zijn 'subject', 'eventtype', 'dataversion'. De overeenkomende waardenamen moeten de standaardwaarden opgeven die moeten worden gebruikt voor de toewijzing en worden alleen gebruikt wanneer de gepubliceerde gebeurtenis geen geldige toewijzing voor een bepaald veld heeft.

--input-mapping-fields

Wanneer invoerschema is opgegeven als customeventschema, wordt deze parameter gebruikt om invoertoewijzingen op te geven op basis van veldnamen. Geef door spaties gescheiden toewijzingen op in de indeling 'key=value'. Toegestane sleutelnamen zijn 'id', 'onderwerp', 'eventtime', 'subject', 'eventtype', 'dataversion'. De overeenkomende waardenamen moeten de namen van de velden in het aangepaste invoerschema opgeven. Als er geen toewijzing voor 'id' of 'eventtime' is opgegeven, genereert Event Grid automatisch een standaardwaarde voor deze twee velden.

--input-schema

Schema waarin binnenkomende gebeurtenissen worden gepubliceerd naar dit onderwerp/domein. Als u customeventschema opgeeft als de waarde voor deze parameter, moet u ook waarden opgeven voor ten minste één van --input_mapping_default_values / --input_mapping_fields.

Geaccepteerde waarden: cloudeventschemav1_0, customeventschema, eventgridschema
Default value: eventgridschema
--kind
Preview

Het soort onderwerpresource.

Geaccepteerde waarden: azure, azurearc
Default value: Azure
--location -l

Plaats. Waarden uit: az account list-locations. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>.

--mi-system-assigned

Aanwezigheid van deze param geeft aan dat de door SystemAssigned beheerde identiteit wordt gebruikt.

--mi-user-assigned
Preview

Door de gebruiker toegewezen identiteiten toevoegen wanneer identityType gebruiker of gemengd is. Dit kenmerk is geldig voor alle doeltypen, met uitzondering van StorageQueue. Er kunnen meerdere kenmerken worden opgegeven met behulp van meer dan één --mi-user-assigned argument.

--public-network-access

Hiermee wordt bepaald of verkeer via een openbaar netwerk is toegestaan. Deze functie is standaard ingeschakeld. U kunt verder beperken tot specifieke IP-adressen door deze te configureren.

Geaccepteerde waarden: disabled, enabled
--sku
Preview

De SKU-naam van de resource.

Geaccepteerde waarden: basic, premium
Default value: Basic
--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az eventgrid topic delete

Bewerken

Een onderwerp verwijderen.

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

Voorbeelden

Een onderwerp verwijderen.

az eventgrid topic delete -g rg1 --name topic1

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

Naam van het onderwerp.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az eventgrid topic list

Bewerken

Lijst met beschikbare onderwerpen.

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

Voorbeelden

Alle onderwerpen in het huidige Azure-abonnement weergeven.

az eventgrid topic list

Alle onderwerpen in een resourcegroep weergeven.

az eventgrid topic list -g rg1

Alle onderwerpen in een resourcegroep weergeven waarvan de naam het patroon XYZ bevat

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

Alle onderwerpen in een resourcegroep weergeven, behalve het domein met de naam 'name1'

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

Optionele parameters

--odata-query

De OData-query die wordt gebruikt voor het filteren van de lijstresultaten. Filteren is momenteel alleen toegestaan voor de eigenschap Naam. De ondersteunde bewerkingen zijn: CONTAINS, eq (voor gelijk), ne (voor niet gelijk), AND, OR en NOT.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az eventgrid topic show

Bewerken

De details van een onderwerp ophalen.

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

Voorbeelden

De details van een onderwerp weergeven.

az eventgrid topic show -g rg1 -n topic1

De details van een onderwerp weergeven op basis van de resource-id.

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

Optionele parameters

--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--name -n

Naam van het onderwerp.

--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az eventgrid topic update

Bewerken

Een onderwerp bijwerken.

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]

Voorbeelden

Werk de eigenschappen van een bestaand onderwerp bij met nieuwe SKU-, identiteits- en openbare netwerktoegangsgegevens.

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

Optionele parameters

--identity
Preview Afgeschaft

Argument 'identiteit' is afgeschaft en wordt verwijderd in een toekomstige release.

Het type beheerde identiteit voor de resource. Wordt in de toekomst afgeschaft en vervangen door --mi-system-assigned-identity.

Geaccepteerde waarden: noidentity, systemassigned
--ids

Een of meer resource-id's (met spatie gescheiden). Dit moet een volledige resource-id zijn die alle informatie over de argumenten Resource-id bevat. Geef de argumenten --id's of andere resource-id's op.

--inbound-ip-rules

Lijst met binnenkomende IP-regels die IP-adres opgeven in CIDR-notatie, bijvoorbeeld 10.0.0.0/8, samen met de bijbehorende actie die moet worden uitgevoerd op basis van de overeenkomst of geen overeenkomst van de IpMask. Mogelijke waarden zijn : Toestaan.

--mi-system-assigned

Aanwezigheid van deze param geeft aan dat de door SystemAssigned beheerde identiteit wordt gebruikt.

--mi-user-assigned
Preview

Door de gebruiker toegewezen identiteiten toevoegen wanneer identityType gebruiker of gemengd is. Dit kenmerk is geldig voor alle doeltypen, met uitzondering van StorageQueue. Er kunnen meerdere kenmerken worden opgegeven met behulp van meer dan één --mi-user-assigned argument.

--name -n

Naam van het onderwerp.

--public-network-access

Hiermee wordt bepaald of verkeer via een openbaar netwerk is toegestaan. Deze functie is standaard ingeschakeld. U kunt verder beperken tot specifieke IP-adressen door deze te configureren.

Geaccepteerde waarden: disabled, enabled
--resource-group -g

Naam van resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>.

--sku
Preview

De SKU-naam van de resource.

Geaccepteerde waarden: basic, premium
--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--tags

Door spaties gescheiden tags: key[=value] [key[=value] ...]. Gebruik '' om bestaande tags te wissen.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.