az eventgrid event-subscription

Notitie

Deze opdrachtgroep bevat opdrachten die zijn gedefinieerd in zowel Azure CLI als ten minste één extensie. Installeer elke extensie om te profiteren van de uitgebreide mogelijkheden. Meer informatie over extensies.

Gebeurtenisabonnementen beheren.

Gebeurtenisabonnementen beheren voor een Event Grid-onderwerp, domein, domeinonderwerp, Azure-abonnement, resourcegroep of voor andere Azure-resources die gebeurtenismeldingen ondersteunen.

Opdracht

Name Description Type Status
az eventgrid event-subscription create

Maak een nieuw gebeurtenisabonnement.

Basis GA
az eventgrid event-subscription create (eventgrid extensie)

Maak een nieuw gebeurtenisabonnement.

Toestel Preview
az eventgrid event-subscription delete

Een gebeurtenisabonnement verwijderen.

Basis GA
az eventgrid event-subscription delete (eventgrid extensie)

Een gebeurtenisabonnement verwijderen.

Toestel Preview
az eventgrid event-subscription list

Gebeurtenisabonnementen weergeven.

Basis GA
az eventgrid event-subscription list (eventgrid extensie)

Gebeurtenisabonnementen weergeven.

Toestel Preview
az eventgrid event-subscription show

De details van een gebeurtenisabonnement ophalen.

Basis GA
az eventgrid event-subscription show (eventgrid extensie)

De details van een gebeurtenisabonnement ophalen.

Toestel Preview
az eventgrid event-subscription update

Een gebeurtenisabonnement bijwerken.

Basis GA
az eventgrid event-subscription update (eventgrid extensie)

Een gebeurtenisabonnement bijwerken.

Toestel Preview

az eventgrid event-subscription create

Maak een nieuw gebeurtenisabonnement.

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]

Voorbeelden

Maak een nieuw gebeurtenisabonnement voor een Event Grid-onderwerp met behulp van standaardfilters.

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

Maak een nieuw gebeurtenisabonnement voor een Azure-abonnement met behulp van standaardfilters.

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

Maak een nieuw gebeurtenisabonnement voor een resourcegroep met behulp van standaardfilters.

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

Maak een nieuw gebeurtenisabonnement voor een opslagaccount met behulp van standaardfilters.

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

Maak een nieuw gebeurtenisabonnement voor een opslagaccount met behulp van geavanceerde filters.

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

Maak een nieuw gebeurtenisabonnement voor een Azure-abonnement, met een filter dat een onderwerpvoorvoegsel opgeeft.

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

Maak een nieuw gebeurtenisabonnement voor een resourcegroep, met een filter dat een onderwerpachtervoegsel opgeeft.

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

Maak een nieuw gebeurtenisabonnement voor een Azure-abonnement met behulp van standaardfilters en een EventHub als bestemming.

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

Maak een nieuw gebeurtenisabonnement voor een Azure-abonnement met behulp van standaardfilters en een Azure Storage-wachtrij als doel.

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

Maak een nieuw gebeurtenisabonnement voor een Azure-abonnement met behulp van standaardfilters en een Azure ServiceBusQueue als bestemming.

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

Maak een nieuw gebeurtenisabonnement voor een Event Grid-domein met behulp van standaardfilters en CloudEvent V 1.0 als leveringsschema.

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

Maak een nieuw gebeurtenisabonnement voor een opslagaccount, met een deadletterbestemming en aangepast beleid voor opnieuw proberen van maximaal 10 bezorgingspogingen en een gebeurtenis-TTL van 2 uur (afhankelijk van wat er eerder gebeurt).

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

Maak een nieuw gebeurtenisabonnement voor een domeinonderwerp.

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

Maak een nieuw gebeurtenisabonnement (voor een opslagaccount) met een vervaldatum.

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"

Maak een nieuw gebeurtenisabonnement voor een Event Grid-onderwerp met behulp van webhook met Azure Active Directory als bestemming.

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

Maak een nieuw gebeurtenisabonnement voor een Event Grid-onderwerp met behulp van Azure Function als bestemming.

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

Maak een nieuw gebeurtenisabonnement voor een Event Grid-onderwerp met eventhub met systemassigned MSI-identiteit als bestemming en met deadletter met MSI-identiteit

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}

Een nieuw gebeurtenisabonnement maken voor een Event Grid-onderwerp met opslagwachtrij als bestemming met bericht-ttl op 5 minuten

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

Een nieuw gebeurtenisabonnement maken voor een Event Grid-onderwerp met behulp van StorageQueue met door het systeem toegewezen MSI-identiteit als bestemming

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

Een nieuw gebeurtenisabonnement maken voor een Event Grid-onderwerp met geavanceerd filteren ingeschakeld voor matrices

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

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

Optionele parameters

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

De Tenant-id van Azure Active Directory om het toegangstoken op te halen dat wordt opgenomen als het bearer-token in bezorgingsaanvragen. Alleen van toepassing op webhook als bestemming.

--advanced-filter

Met een geavanceerd filter kunt u gebeurtenissen filteren op basis van een specifieke gebeurteniseigenschap.

Gebruik: --advanced-filter KEY[. INNERKEY] FILTEROPERATORWAARDE [WAARDE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png png StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg 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 NumberNotInRange 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 BoolEqual true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Multiple advanced filters can be specified by using more than one --advanced-filter argument.

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

De Azure Active Directory-toepassings-id of -URI om het toegangstoken op te halen dat wordt opgenomen als het bearer-token in bezorgingsaanvragen. Alleen van toepassing op webhook als bestemming.

--deadletter-endpoint

De Azure-resource-id van een Azure Storage-blobcontainerbestemming waar EventGrid onbestelbare gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.

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

--deadletter-identity
Preview

Het identiteitstype van de doelresource deadletter.

geaccepteerde waarden: systemassigned
--deadletter-identity-endpoint

De Azure-resource-id van een Azure Storage-blobcontainerbestemming met identiteit waarbij EventGrid niet-bezorgde gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.

--delivery-attribute-mapping

Voeg de toewijzing van het leveringskenmerk toe om aanvullende informatie te verzenden via HTTP-headers bij het leveren van gebeurtenissen. Dit kenmerk is geldig voor alle doeltypen, met uitzondering van StorageQueue. Er kunnen meerdere kenmerken worden opgegeven met behulp van meer dan één --delivery-attribute-mapping argument.

Gebruik: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Static Attribute Mapping: --delivery-attribute-mapping somename static attribute mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename statische somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Zowel statisch als dynamisch: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Preview

Het identiteitstype van de bezorgingsdoelresource (bijvoorbeeld opslagwachtrij of eventhub).

geaccepteerde waarden: systemassigned
--delivery-identity-endpoint
Preview

Eindpunt met identiteit waar EventGrid gebeurtenissen moet leveren die overeenkomen met dit gebeurtenisabonnement. Voor het eindpunttype van de webhook moet dit de bijbehorende webhook-URL zijn. Voor andere eindpunttypen moet dit de Azure-resource-id van het eindpunt zijn.

--delivery-identity-endpoint-type
Preview

Het type van het doeleindpunt met resource-id.

geaccepteerde waarden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Hiermee kunnen geavanceerde filters worden geëvalueerd op basis van een matrix met waarden in plaats van een enkelvoudige waarde te verwachten.

geaccepteerde waarden: false, true
--endpoint

Eindpunt waar EventGrid gebeurtenissen moet leveren die overeenkomen met dit gebeurtenisabonnement. Voor het eindpunttype van de webhook moet dit de bijbehorende webhook-URL zijn. Voor andere eindpunttypen moet dit de Azure-resource-id van het eindpunt zijn. Er wordt verwacht dat het doeleindpunt al is gemaakt en beschikbaar is voor gebruik voordat u een Event Grid-opdracht uitvoert.

--endpoint-type

Het type van het doeleindpunt.

standaardwaarde: webhook
--event-delivery-schema

Het schema waarin gebeurtenissen moeten worden geleverd voor dit gebeurtenisabonnement. Standaard worden gebeurtenissen geleverd in hetzelfde schema waarin ze worden gepubliceerd (op basis van het bijbehorende invoerschema van het onderwerp).

geaccepteerde waarden: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Time to Live van gebeurtenis (in minuten). Moet een getal tussen 1 en 1440 zijn.

standaardwaarde: 1440
--expiration-date

Datum of datum/tijd (in UTC, bijvoorbeeld '2018-11-30T11:59:59+00:00' of '2018-11-30') waarna het gebeurtenisabonnement zou verlopen. Standaard is er geen vervaldatum voor het gebeurtenisabonnement.

--included-event-types

Een door spaties gescheiden lijst met gebeurtenistypen (bijvoorbeeld Microsoft.Storage.BlobCreated en Microsoft.Storage.BlobDeleted). Als u zich wilt abonneren op alle standaard gebeurtenistypen, geeft u geen waarde op voor dit argument. Voor event grid-onderwerpen worden gebeurtenistypen door de klant gedefinieerd. Voor Azure-gebeurtenissen, bijvoorbeeld opslagaccounts, IoT Hub, enzovoort, kunt u hun gebeurtenistypen opvragen met behulp van deze CLI-opdracht 'az eventgrid topic-type list-event-types'.

--labels

Een door spaties gescheiden lijst met labels die aan dit gebeurtenisabonnement moeten worden gekoppeld.

--max-delivery-attempts

Maximum aantal bezorgingspogingen. Moet een getal tussen 1 en 30 zijn.

standaardwaarde: 30
--max-events-per-batch

Maximum aantal gebeurtenissen in een batch. Moet een getal tussen 1 en 5000 zijn.

--preferred-batch-size-in-kilobytes

Voorkeursbatchgrootte in kilobytes. Moet een getal tussen 1 en 1024 zijn.

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

Berichttijd van opslagwachtrij in seconden.

--source-resource-id

Volledig gekwalificeerde id van de Azure-resource waaraan het gebeurtenisabonnement moet worden gemaakt.

Gebruik: --source-resource-id Azure-Resource-ID voor Azure-abonnement: --source-resource-id /subscriptions/{SubID} Voor resourcegroep: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Voor EventGrid-onderwerp: --source-resource-id /subscriptions /{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een voorvoegsel. Jokertekens worden niet ondersteund.

--subject-case-sensitive

Geef op om aan te geven of de onderwerpvelden op een hoofdlettergevoelige manier moeten worden vergeleken. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
standaardwaarde: False
--subject-ends-with

Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een achtervoegsel. Jokertekens worden niet ondersteund.

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
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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 event-subscription create (eventgrid extensie)

Preview

Opdrachtgroep az eventgrid is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Maak een nieuw gebeurtenisabonnement.

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]

Voorbeelden

Maak een nieuw gebeurtenisabonnement voor een Event Grid-onderwerp met behulp van standaardfilters.

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

Maak een nieuw gebeurtenisabonnement voor een Azure-abonnement met behulp van standaardfilters.

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

Maak een nieuw gebeurtenisabonnement voor een resourcegroep met behulp van standaardfilters.

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

Maak een nieuw gebeurtenisabonnement voor een opslagaccount met behulp van standaardfilters.

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

Maak een nieuw gebeurtenisabonnement voor een opslagaccount met behulp van geavanceerde filters.

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

Maak een nieuw gebeurtenisabonnement voor een Azure-abonnement, met een filter dat een onderwerpvoorvoegsel opgeeft.

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

Maak een nieuw gebeurtenisabonnement voor een resourcegroep, met een filter dat een onderwerpachtervoegsel opgeeft.

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

Maak een nieuw gebeurtenisabonnement voor een Azure-abonnement met behulp van standaardfilters en een EventHub als bestemming.

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

Maak een nieuw gebeurtenisabonnement voor een Azure-abonnement met behulp van standaardfilters en een Azure Storage-wachtrij als doel.

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

Maak een nieuw gebeurtenisabonnement voor een Azure-abonnement met behulp van standaardfilters en een Azure ServiceBusQueue als bestemming.

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

Maak een nieuw gebeurtenisabonnement voor een Event Grid-domein met behulp van standaardfilters en CloudEvent V 1.0 als leveringsschema.

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

Maak een nieuw gebeurtenisabonnement voor een opslagaccount, met een deadletterbestemming en aangepast beleid voor opnieuw proberen van maximaal 10 bezorgingspogingen en een gebeurtenis-TTL van 2 uur (afhankelijk van wat er eerder gebeurt).

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

Maak een nieuw gebeurtenisabonnement voor een domeinonderwerp.

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

Maak een nieuw gebeurtenisabonnement (voor een opslagaccount) met een vervaldatum.

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"

Maak een nieuw gebeurtenisabonnement voor een Event Grid-onderwerp met behulp van webhook met Azure Active Directory als bestemming.

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

Maak een nieuw gebeurtenisabonnement voor een Event Grid-onderwerp met behulp van Azure Function als bestemming.

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

Maak een nieuw gebeurtenisabonnement voor een Event Grid-onderwerp met eventhub met systemassigned MSI-identiteit als bestemming en met deadletter met MSI-identiteit

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}

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

Optionele parameters

--advanced-filter

Met een geavanceerd filter kunt u gebeurtenissen filteren op basis van een specifieke gebeurteniseigenschap.

Gebruik: --advanced-filter KEY[. INNERKEY] FILTEROPERATORWAARDE [WAARDE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg 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 Multiple advanced filters can be specified by using more than one --advanced-filter argument.

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

De Azure Active Directory-toepassings-id of -URI om het toegangstoken op te halen dat wordt opgenomen als het bearer-token in bezorgingsaanvragen. Alleen van toepassing op webhook als bestemming.

--azure-active-directory-tenant-id

De Tenant-id van Azure Active Directory om het toegangstoken op te halen dat wordt opgenomen als het bearer-token in bezorgingsaanvragen. Alleen van toepassing op webhook als bestemming.

--deadletter-endpoint

De Azure-resource-id van een Azure Storage-blobcontainerbestemming waar EventGrid onbestelbare gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.

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

--deadletter-identity

Het identiteitstype van de doelresource deadletter.

geaccepteerde waarden: systemassigned
--deadletter-identity-endpoint

De Azure-resource-id van een Azure Storage-blobcontainerbestemming met identiteit waarbij EventGrid niet-bezorgde gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.

--delivery-identity

Het identiteitstype van de bezorgingsdoelresource (bijvoorbeeld opslagwachtrij of eventhub).

geaccepteerde waarden: systemassigned
--delivery-identity-endpoint

Eindpunt met identiteit waar EventGrid gebeurtenissen moet leveren die overeenkomen met dit gebeurtenisabonnement. Voor het eindpunttype van de webhook moet dit de bijbehorende webhook-URL zijn. Voor andere eindpunttypen moet dit de Azure-resource-id van het eindpunt zijn.

--delivery-identity-endpoint-type

Het type van het doeleindpunt met resource-id.

geaccepteerde waarden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Eindpunt waar EventGrid gebeurtenissen moet leveren die overeenkomen met dit gebeurtenisabonnement. Voor het eindpunttype van de webhook moet dit de bijbehorende webhook-URL zijn. Voor andere eindpunttypen moet dit de Azure-resource-id van het eindpunt zijn.

--endpoint-type

Het type van het doeleindpunt.

geaccepteerde waarden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
standaardwaarde: webhook
--event-delivery-schema

Het schema waarin gebeurtenissen moeten worden geleverd voor dit gebeurtenisabonnement. Standaard worden gebeurtenissen geleverd in hetzelfde schema waarin ze worden gepubliceerd (op basis van het bijbehorende invoerschema van het onderwerp).

geaccepteerde waarden: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Time to Live van gebeurtenis (in minuten). Moet een getal tussen 1 en 1440 zijn.

standaardwaarde: 1440
--expiration-date

Datum of datum/tijd (in UTC, bijvoorbeeld '2018-11-30T11:59:59+00:00' of '2018-11-30') waarna het gebeurtenisabonnement zou verlopen. Standaard is er geen vervaldatum voor het gebeurtenisabonnement.

--included-event-types

Een door spaties gescheiden lijst met gebeurtenistypen. Voorbeeld: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Als u zich wilt abonneren op alle standaard gebeurtenistypen, geeft u geen waarde op voor dit argument.

--labels

Een door spaties gescheiden lijst met labels die aan dit gebeurtenisabonnement moeten worden gekoppeld.

--max-delivery-attempts

Maximum aantal bezorgingspogingen. Moet een getal tussen 1 en 30 zijn.

standaardwaarde: 30
--max-events-per-batch

Maximum aantal gebeurtenissen in een batch. Moet een getal tussen 1 en 5000 zijn.

--preferred-batch-size-in-kilobytes

Voorkeursbatchgrootte in kilobytes. Moet een getal tussen 1 en 1024 zijn.

--source-resource-id

Volledig gekwalificeerde id van de Azure-resource waaraan het gebeurtenisabonnement moet worden gemaakt.

Gebruik: --source-resource-id Azure-Resource-ID voor Azure-abonnement: --source-resource-id /subscriptions/{SubID} Voor resourcegroep: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Voor EventGrid-onderwerp: --source-resource-id /subscriptions /{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een voorvoegsel. Jokertekens worden niet ondersteund.

--subject-case-sensitive

Geef op om aan te geven of de onderwerpvelden op een hoofdlettergevoelige manier moeten worden vergeleken. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
standaardwaarde: False
--subject-ends-with

Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een achtervoegsel. Jokertekens worden niet ondersteund.

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
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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 event-subscription delete

Een gebeurtenisabonnement verwijderen.

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

Voorbeelden

Een gebeurtenisabonnement voor een Event Grid-onderwerp verwijderen.

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

Een gebeurtenisabonnement voor een Event Grid-domeinonderwerp verwijderen.

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

Een gebeurtenisabonnement voor een Event Grid-domein verwijderen.

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

Een gebeurtenisabonnement voor een Azure-abonnement verwijderen.

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

Een gebeurtenisabonnement voor een resourcegroep verwijderen.

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

Een gebeurtenisabonnement voor een opslagaccount verwijderen.

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

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

Optionele parameters

--source-resource-id

Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden verwijderd.

Gebruik: --source-resource-id Azure-Resource-ID voor Azure-abonnement: --source-resource-id /subscriptions/{SubID} Voor resourcegroep: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Voor EventGrid-onderwerp: --source-resource-id /subscriptions /{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

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
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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 event-subscription delete (eventgrid extensie)

Preview

Opdrachtgroep az eventgrid is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een gebeurtenisabonnement verwijderen.

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

Voorbeelden

Een gebeurtenisabonnement voor een Event Grid-onderwerp verwijderen.

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

Een gebeurtenisabonnement voor een Event Grid-domeinonderwerp verwijderen.

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

Een gebeurtenisabonnement voor een Event Grid-domein verwijderen.

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

Een gebeurtenisabonnement voor een Azure-abonnement verwijderen.

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

Een gebeurtenisabonnement voor een resourcegroep verwijderen.

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

Een gebeurtenisabonnement voor een opslagaccount verwijderen.

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

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

Optionele parameters

--source-resource-id

Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden verwijderd.

Gebruik: --source-resource-id Azure-Resource-ID voor Azure-abonnement: --source-resource-id /subscriptions/{SubID} Voor resourcegroep: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Voor EventGrid-onderwerp: --source-resource-id /subscriptions /{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

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
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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 event-subscription list

Gebeurtenisabonnementen weergeven.

Event Grid ondersteunt zowel regionale als globale gebeurtenisabonnementen: gebeurtenisabonnementen op regionale resources (zoals opslagaccounts of Event Grid-onderwerpen) zijn regionaal, terwijl gebeurtenisabonnementen op globale resources (zoals een Azure-abonnement of resourcegroep) globaal zijn. Daarom kunt u gebeurtenisabonnementen op verschillende manieren weergeven:

  1. Als u wilt weergeven op basis van de resource-id van de resource waarvan u de gebeurtenisabonnementen wilt vermelden, geeft u de parameter --source-resource-id op. Er moeten geen andere parameters worden opgegeven.
  2. Als u een lijst wilt weergeven op basis van een onderwerptype (bijvoorbeeld opslagaccounts), geeft u de parameter --topic-type op, samen met de parameter --location (bijvoorbeeld 'westus2'). Geef voor globale onderwerptypen (bijvoorbeeld 'Microsoft.Resources.Subscriptions') de locatiewaarde op als 'globaal'.
  3. Als u alle gebeurtenisabonnementen in een regio (voor alle onderwerptypen) wilt weergeven, geeft u alleen de parameter --location op.
  4. Als u voor zowel #2 als #3 hierboven alleen wilt filteren op een resourcegroep, kunt u ook de parameter --resource-group opgeven.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Voorbeelden

Geef alle gebeurtenisabonnementen weer die zijn gemaakt voor een Event Grid-onderwerp.

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

Vermeld alle gebeurtenisabonnementen die zijn gemaakt voor een opslagaccount.

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

Vermeld alle gebeurtenisabonnementen die zijn gemaakt voor een Azure-abonnement.

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

Vermeld alle gebeurtenisabonnementen die zijn gemaakt voor een resourcegroep.

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

Vermeld alle gebeurtenisabonnementen voor een Event Grid-domein.

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

Vermeld alle gebeurtenisabonnementen voor een Event Grid-domeinonderwerp.

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

Vermeld alle opslag gebeurtenisabonnementen (onder het momenteel geselecteerde Azure-abonnement) in westus2.

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

Vermeld alle opslag gebeurtenisabonnementen (onder de opgegeven resourcegroep) in westus2.

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

Alle regionale of globale gebeurtenisabonnementen weergeven (onder het momenteel geselecteerde Azure-abonnement).

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

Alle regionale of globale gebeurtenisabonnementen onder een opgegeven resourcegroep weergeven.

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

Vermeld alle gebeurtenisabonnementen voor een Event Grid-domein waarvan de naam het patroon XYZ bevat

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

Alle gebeurtenisabonnementen voor een Event Grid-domein weergeven, met uitzondering van het gebeurtenisabonnement met de naam 'naam1'

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

Optionele parameters

--location -l

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

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

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

--source-resource-id

Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden vermeld.

Gebruik: --source-resource-id Azure-Resource-ID voor Azure-abonnement: --source-resource-id /subscriptions/{SubID} Voor resourcegroep: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Voor EventGrid-onderwerp: --source-resource-id /subscriptions /{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Naam van het onderwerptype waarvan de gebeurtenisabonnementen moeten worden vermeld. Wanneer dit is opgegeven, moet u ook --location opgeven.

Voorbeeld 1: Vermeld alle abonnementen voor opslaggebeurtenissen in WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Voorbeeld 2: Alle gebeurtenisabonnementen op Azure-abonnementen --topic-type-name Microsoft.Resources.Subscriptions --location global.

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
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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 event-subscription list (eventgrid extensie)

Preview

Opdrachtgroep az eventgrid is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Gebeurtenisabonnementen weergeven.

Event Grid ondersteunt zowel regionale als globale gebeurtenisabonnementen: gebeurtenisabonnementen op regionale resources (zoals opslagaccounts of Event Grid-onderwerpen) zijn regionaal, terwijl gebeurtenisabonnementen op globale resources (zoals een Azure-abonnement of resourcegroep) globaal zijn. Daarom kunt u gebeurtenisabonnementen op verschillende manieren weergeven:

  1. Als u wilt weergeven op basis van de resource-id van de resource waarvan u de gebeurtenisabonnementen wilt vermelden, geeft u de parameter --source-resource-id op. Er moeten geen andere parameters worden opgegeven.
  2. Als u een lijst wilt weergeven op basis van een onderwerptype (bijvoorbeeld opslagaccounts), geeft u de parameter --topic-type op, samen met de parameter --location (bijvoorbeeld 'westus2'). Geef voor globale onderwerptypen (bijvoorbeeld 'Microsoft.Resources.Subscriptions') de locatiewaarde op als 'globaal'.
  3. Als u alle gebeurtenisabonnementen in een regio (voor alle onderwerptypen) wilt weergeven, geeft u alleen de parameter --location op.
  4. Als u voor zowel #2 als #3 hierboven alleen wilt filteren op een resourcegroep, kunt u ook de parameter --resource-group opgeven.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Voorbeelden

Geef alle gebeurtenisabonnementen weer die zijn gemaakt voor een Event Grid-onderwerp.

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

Vermeld alle gebeurtenisabonnementen die zijn gemaakt voor een opslagaccount.

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

Vermeld alle gebeurtenisabonnementen die zijn gemaakt voor een Azure-abonnement.

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

Vermeld alle gebeurtenisabonnementen die zijn gemaakt voor een resourcegroep.

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

Vermeld alle gebeurtenisabonnementen voor een Event Grid-domein.

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

Vermeld alle gebeurtenisabonnementen voor een Event Grid-domeinonderwerp.

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

Vermeld alle opslag gebeurtenisabonnementen (onder het momenteel geselecteerde Azure-abonnement) in westus2.

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

Vermeld alle opslag gebeurtenisabonnementen (onder de opgegeven resourcegroep) in westus2.

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

Alle regionale of globale gebeurtenisabonnementen weergeven (onder het momenteel geselecteerde Azure-abonnement).

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

Alle regionale of globale gebeurtenisabonnementen onder een opgegeven resourcegroep weergeven.

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

Vermeld alle gebeurtenisabonnementen voor een Event Grid-domein waarvan de naam het patroon XYZ bevat

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

Alle gebeurtenisabonnementen voor een Event Grid-domein weergeven, met uitzondering van het gebeurtenisabonnement met de naam 'naam1'

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

Optionele parameters

--location -l

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

--odata-query

De query die wordt gebruikt om de resultaten te filteren met behulp van OData-syntaxis.

--resource-group -g

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

--source-resource-id

Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden vermeld.

Gebruik: --source-resource-id Azure-Resource-ID voor Azure-abonnement: --source-resource-id /subscriptions/{SubID} Voor resourcegroep: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Voor EventGrid-onderwerp: --source-resource-id /subscriptions /{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Naam van het onderwerptype waarvan de gebeurtenisabonnementen moeten worden vermeld. Wanneer dit is opgegeven, moet u ook --location opgeven.

Voorbeeld 1: Vermeld alle abonnementen voor opslaggebeurtenissen in WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Voorbeeld 2: Alle gebeurtenisabonnementen op Azure-abonnementen --topic-type-name Microsoft.Resources.Subscriptions --location global.

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
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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 event-subscription show

De details van een gebeurtenisabonnement ophalen.

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

Voorbeelden

Geef de details weer van een gebeurtenisabonnement voor een Event Grid-onderwerp.

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

De details van een gebeurtenisabonnement voor een Azure-abonnement weergeven.

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

De details van een gebeurtenisabonnement voor een resourcegroep weergeven.

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

Geef de details weer van een gebeurtenisabonnement voor een opslagaccount.

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

Geef de details weer van een gebeurtenisabonnement voor een resourcegroep, inclusief eventuele geheimen van statische leveringskenmerken.

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

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

Optionele parameters

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

Geef aan of geheimen van statische leveringskenmerken moeten worden geretourneerd. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
standaardwaarde: False
--include-full-endpoint-url

Geef op of de volledige eindpunt-URL moet worden geretourneerd. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
standaardwaarde: False
--source-resource-id

Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden weergegeven.

Gebruik: --source-resource-id Azure-Resource-ID voor Azure-abonnement: --source-resource-id /subscriptions/{SubID} Voor resourcegroep: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Voor EventGrid-onderwerp: --source-resource-id /subscriptions /{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

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
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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 event-subscription show (eventgrid extensie)

Preview

Opdrachtgroep az eventgrid is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

De details van een gebeurtenisabonnement ophalen.

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

Voorbeelden

Geef de details weer van een gebeurtenisabonnement voor een Event Grid-onderwerp.

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

De details van een gebeurtenisabonnement voor een Azure-abonnement weergeven.

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

De details van een gebeurtenisabonnement voor een resourcegroep weergeven.

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

Geef de details weer van een gebeurtenisabonnement voor een opslagaccount.

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

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

Optionele parameters

--include-full-endpoint-url

Geef op of de volledige eindpunt-URL moet worden geretourneerd. Waar als er een vlag aanwezig is.

geaccepteerde waarden: false, true
standaardwaarde: False
--source-resource-id

Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden weergegeven.

Gebruik: --source-resource-id Azure-Resource-ID voor Azure-abonnement: --source-resource-id /subscriptions/{SubID} Voor resourcegroep: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Voor EventGrid-onderwerp: --source-resource-id /subscriptions /{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

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
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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 event-subscription update

Een gebeurtenisabonnement bijwerken.

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]

Voorbeelden

Werk een gebeurtenisabonnement voor een Event Grid-onderwerp bij om een nieuw eindpunt op te geven.

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

Werk een gebeurtenisabonnement voor een Azure-abonnement bij om een nieuw onderwerp-ends-with-filter op te geven.

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

Werk een gebeurtenisabonnement voor een resourcegroep bij om een nieuw eindpunt en een nieuw onderwerpeindpunt met filter op te geven.

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

Werk een gebeurtenisabonnement voor een opslagaccount bij om een nieuwe lijst met opgenomen gebeurtenistypen op te geven.

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

Werk een gebeurtenisabonnement voor een opslagaccount bij om een deadletterbestemming op te nemen.

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

Werk een gebeurtenisabonnement voor een opslagaccount bij met behulp van geavanceerde filters.

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

Werk een gebeurtenisabonnement voor een opslagaccount bij om bericht-ttl op te nemen die is ingesteld op 5 minuten.

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

Een gebeurtenisabonnement bijwerken met geavanceerd filteren ingeschakeld voor matrices

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

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

Optionele parameters

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.

standaardwaarde: []
--advanced-filter

Met een geavanceerd filter kunt u gebeurtenissen filteren op basis van een specifieke gebeurteniseigenschap.

Gebruik: --advanced-filter KEY[. INNERKEY] FILTEROPERATORWAARDE [WAARDE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png png StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg 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 NumberNotInRange 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 BoolEqual true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Multiple advanced filters can be specified by using more than one --advanced-filter argument.

--deadletter-endpoint

De Azure-resource-id van een Azure Storage-blobcontainerbestemming waar EventGrid onbestelbare gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.

--deadletter-identity
Preview

Het identiteitstype van de doelresource deadletter.

geaccepteerde waarden: systemassigned
--deadletter-identity-endpoint

De Azure-resource-id van een Azure Storage-blobcontainerbestemming met identiteit waarbij EventGrid niet-bezorgde gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.

--delivery-attribute-mapping

Voeg de toewijzing van het leveringskenmerk toe om aanvullende informatie te verzenden via HTTP-headers bij het leveren van gebeurtenissen. Dit kenmerk is geldig voor alle doeltypen, met uitzondering van StorageQueue. Er kunnen meerdere kenmerken worden opgegeven met behulp van meer dan één --delivery-attribute-mapping argument.

Gebruik: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Static Attribute Mapping: --delivery-attribute-mapping somename static attribute mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename statische somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Zowel statisch als dynamisch: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Preview

Het identiteitstype van de bezorgingsdoelresource (bijvoorbeeld opslagwachtrij of eventhub).

geaccepteerde waarden: systemassigned
--delivery-identity-endpoint
Preview

Eindpunt met identiteit waar EventGrid gebeurtenissen moet leveren die overeenkomen met dit gebeurtenisabonnement. Voor het eindpunttype van de webhook moet dit de bijbehorende webhook-URL zijn. Voor andere eindpunttypen moet dit de Azure-resource-id van het eindpunt zijn.

--delivery-identity-endpoint-type
Preview

Het type van het doeleindpunt met resource-id.

geaccepteerde waarden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Hiermee kunnen geavanceerde filters worden geëvalueerd op basis van een matrix met waarden in plaats van een enkelvoudige waarde te verwachten.

geaccepteerde waarden: false, true
--endpoint

Eindpunt waar EventGrid gebeurtenissen moet leveren die overeenkomen met dit gebeurtenisabonnement. Voor het eindpunttype van de webhook moet dit de bijbehorende webhook-URL zijn. Voor andere eindpunttypen moet dit de Azure-resource-id van het eindpunt zijn. Er wordt verwacht dat het doeleindpunt al is gemaakt en beschikbaar is voor gebruik voordat u een Event Grid-opdracht uitvoert.

--endpoint-type

Het type van het doeleindpunt.

standaardwaarde: webhook
--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

standaardwaarde: False
--included-event-types

Een door spaties gescheiden lijst met gebeurtenistypen (bijvoorbeeld Microsoft.Storage.BlobCreated en Microsoft.Storage.BlobDeleted). Als u zich wilt abonneren op alle standaard gebeurtenistypen, geeft u geen waarde op voor dit argument. Voor event grid-onderwerpen worden gebeurtenistypen door de klant gedefinieerd. Voor Azure-gebeurtenissen, bijvoorbeeld opslagaccounts, IoT Hub, enzovoort, kunt u hun gebeurtenistypen opvragen met behulp van deze CLI-opdracht 'az eventgrid topic-type list-event-types'.

--labels

Een door spaties gescheiden lijst met labels die aan dit gebeurtenisabonnement moeten worden gekoppeld.

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

Berichttijd van opslagwachtrij in seconden.

--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.

standaardwaarde: []
--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.

standaardwaarde: []
--source-resource-id

Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden bijgewerkt.

Gebruik: --source-resource-id Azure-Resource-ID voor Azure-abonnement: --source-resource-id /subscriptions/{SubID} Voor resourcegroep: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Voor EventGrid-onderwerp: --source-resource-id /subscriptions /{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een voorvoegsel. Jokertekens worden niet ondersteund.

--subject-ends-with

Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een achtervoegsel. Jokertekens worden niet ondersteund.

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
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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 event-subscription update (eventgrid extensie)

Preview

Opdrachtgroep az eventgrid is in preview en in ontwikkeling. Referentie- en ondersteuningsniveaus: https://aka.ms/CLI_refstatus

Een gebeurtenisabonnement bijwerken.

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]

Voorbeelden

Werk een gebeurtenisabonnement voor een Event Grid-onderwerp bij om een nieuw eindpunt op te geven.

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

Werk een gebeurtenisabonnement voor een Azure-abonnement bij om een nieuw onderwerp-ends-with-filter op te geven.

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

Werk een gebeurtenisabonnement voor een resourcegroep bij om een nieuw eindpunt en een nieuw onderwerpeindpunt met filter op te geven.

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

Werk een gebeurtenisabonnement voor een opslagaccount bij om een nieuwe lijst met opgenomen gebeurtenistypen op te geven.

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

Werk een gebeurtenisabonnement voor een opslagaccount bij om een deadletterbestemming op te nemen.

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

Werk een gebeurtenisabonnement voor een opslagaccount bij met behulp van geavanceerde filters.

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

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

Optionele parameters

--add

Voeg een object toe aan een lijst met objecten door een pad- en sleutelwaardeparen op te geven. Voorbeeld: --add property.listProperty <key=value, string or JSON string>.

standaardwaarde: []
--advanced-filter

Met een geavanceerd filter kunt u gebeurtenissen filteren op basis van een specifieke gebeurteniseigenschap.

Gebruik: --advanced-filter KEY[. INNERKEY] FILTEROPERATORWAARDE [WAARDE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg 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 Multiple advanced filters can be specified by using more than one --advanced-filter argument.

--deadletter-endpoint

De Azure-resource-id van een Azure Storage-blobcontainerbestemming waar EventGrid onbestelbare gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.

--deadletter-identity

Het identiteitstype van de doelresource deadletter.

geaccepteerde waarden: systemassigned
--deadletter-identity-endpoint

De Azure-resource-id van een Azure Storage-blobcontainerbestemming met identiteit waarbij EventGrid niet-bezorgde gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.

--delivery-identity

Het identiteitstype van de bezorgingsdoelresource (bijvoorbeeld opslagwachtrij of eventhub).

geaccepteerde waarden: systemassigned
--delivery-identity-endpoint

Eindpunt met identiteit waar EventGrid gebeurtenissen moet leveren die overeenkomen met dit gebeurtenisabonnement. Voor het eindpunttype van de webhook moet dit de bijbehorende webhook-URL zijn. Voor andere eindpunttypen moet dit de Azure-resource-id van het eindpunt zijn.

--delivery-identity-endpoint-type

Het type van het doeleindpunt met resource-id.

geaccepteerde waarden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Eindpunt waar EventGrid gebeurtenissen moet leveren die overeenkomen met dit gebeurtenisabonnement. Voor het eindpunttype van de webhook moet dit de bijbehorende webhook-URL zijn. Voor andere eindpunttypen moet dit de Azure-resource-id van het eindpunt zijn.

--endpoint-type

Het type van het doeleindpunt.

geaccepteerde waarden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
standaardwaarde: webhook
--force-string

Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.

standaardwaarde: False
--included-event-types

Een door spaties gescheiden lijst met gebeurtenistypen. Voorbeeld: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Als u zich wilt abonneren op alle standaard gebeurtenistypen, geeft u geen waarde op voor dit argument.

--labels

Een door spaties gescheiden lijst met labels die aan dit gebeurtenisabonnement moeten worden gekoppeld.

--remove

Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove> OF --remove propertyToRemove.

standaardwaarde: []
--set

Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>.

standaardwaarde: []
--source-resource-id

Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden bijgewerkt.

Gebruik: --source-resource-id Azure-Resource-ID voor Azure-abonnement: --source-resource-id /subscriptions/{SubID} Voor resourcegroep: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Voor EventGrid-onderwerp: --source-resource-id /subscriptions /{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid domain: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een voorvoegsel. Jokertekens worden niet ondersteund.

--subject-ends-with

Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een achtervoegsel. Jokertekens worden niet ondersteund.

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
standaardwaarde: json
--query

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

--subscription

Naam of id van het 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.