az eventgrid event-subscription

Gebeurtenisabonnementen beheren.

Gebeurtenisabonnementen beheren voor een Event Grid, domein, domeinonderwerp, Azure-abonnement, resourcegroep of voor een andere Azure-resource die gebeurtenismeldingen ondersteunt.

Opdracht

az eventgrid event-subscription create

Maak een nieuw gebeurtenisabonnement.

az eventgrid event-subscription delete

Een gebeurtenisabonnement verwijderen.

az eventgrid event-subscription list

Gebeurtenisabonnementen op een lijst zetten.

az eventgrid event-subscription show

De details van een gebeurtenisabonnement op te halen.

az eventgrid event-subscription update

Een gebeurtenisabonnement bijwerken.

az eventgrid event-subscription create

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-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 {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
                                       [--event-ttl]
                                       [--expiration-date]
                                       [--included-event-types]
                                       [--labels]
                                       [--max-delivery-attempts]
                                       [--max-events-per-batch]
                                       [--preferred-batch-size-in-kilobytes]
                                       [--qttl]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]
                                       [--subscription]

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 onderwerp voorvoegsel 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 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 bestemming.

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 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 het 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 deadletter-bestemming en aangepast beleid voor opnieuw proberen van maximaal 10 bezorgingspogingen en een TTL van 2 uur (wat 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 Azure Active Directory webhook ingeschakeld als doel .

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

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 een door het systeem toegewezen 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}

Maak een nieuw gebeurtenisabonnement voor een Event Grid onderwerp met Storage Queue as destination 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

Maak een nieuw gebeurtenisabonnement voor een Event Grid onderwerp met StorageQueue met een 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

Maak een nieuw gebeurtenisabonnement voor een Event Grid onderwerp met geavanceerde filters ingeschakeld op 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

--advanced-filter

Met een geavanceerd filter kunt u gebeurtenissen filteren op basis van een specifieke gebeurtenis-eigenschap.

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

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

--azure-active-directory-tenant-id

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

--deadletter-endpoint

De Azure-resource-id van een Azure Storage blobcontainerbestemming waar EventGrid onbeseerbare gebeurtenissen voor dit gebeurtenisabonnement onbesleekbaar moet maken.

--deadletter-identity

Het identiteitstype van de deadletter-doelresource.

geaccepteerde waarden: systemassigned
--deadletter-identity-endpoint

De Azure-resource-id van een Azure Storage blobcontainerbestemming met een identiteit waar EventGrid onbemiddelde gebeurtenissen voor dit gebeurtenisabonnement onbemiddeld moet laten.

--delivery-attribute-mapping

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

--delivery-identity

Het identiteitstype van de doelresource voor de levering (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 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 doel-eindpunt met resource-identiteit.

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 webhook moet dit de bijbehorende webhook-URL zijn. Voor andere eindpunttypen moet dit de Azure-resource-id van het eindpunt zijn. Het is te verwachten dat het doel-eindpunt al is gemaakt en beschikbaar is voor gebruik voordat u een opdracht Event Grid uitvoeren.

--endpoint-type

Het type van het doel-eindpunt.

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

Het schema waarin gebeurtenissen moeten worden geleverd voor dit gebeurtenisabonnement. Gebeurtenissen worden standaard 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 verloopt. Standaard is er geen vervaldatum voor het gebeurtenisabonnement.

--included-event-types

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

--labels

Een door spaties gescheiden lijst met labels die u aan dit gebeurtenisabonnement wilt koppelen.

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

Batchgrootte van voorkeur in kilobytes. Moet een getal tussen 1 en 1024 zijn.

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

Storage de time to live van het wachtrijbericht in seconden.

--source-resource-id

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

--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 casegevoelige manier moeten worden vergeleken. Waar als de vlag aanwezig is.

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

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

--subscription

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

az eventgrid event-subscription delete

Een gebeurtenisabonnement verwijderen.

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

Voorbeelden

Een gebeurtenisabonnement verwijderen voor een Event Grid onderwerp.

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

Een gebeurtenisabonnement verwijderen voor een Event Grid domeinonderwerp.

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

Een gebeurtenisabonnement verwijderen voor een Event Grid domein.

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.

--subscription

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

az eventgrid event-subscription list

Gebeurtenisabonnementen op een lijst zetten.

Event Grid ondersteunt zowel regionale als globale gebeurtenisabonnementen: gebeurtenisabonnementen op regionale resources (zoals Storage-accounts 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 in een lijst zetten:

  1. Als u wilt vermelden op 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 wilt vermelden op onderwerptype (bijvoorbeeld opslagaccounts), geeft u de parameter --topic-type op, samen met de parameter --location (bijvoorbeeld 'westus2'). Geef voor algemene onderwerptypen (bijvoorbeeld Microsoft.Resources.Subscriptions) de locatiewaarde op als 'globaal'.
  3. Als u alle gebeurtenisabonnementen in een regio wilt vermelden (voor alle onderwerptypen), geeft u alleen de parameter --location op.
  4. Als u #2 en #3 wilt filteren op een resourcegroep, kunt u ook de parameter --resource-group opgeven.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--query-examples]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--subscription]
                                     [--topic-type-name]

Voorbeelden

Vermeld alle gebeurtenisabonnementen 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

Een lijst met 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 Storage voor gebeurtenissen (onder het geselecteerde Azure-abonnement) in westus2.

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

Een lijst Storage gebeurtenisabonnementen (onder de opgegeven resourcegroep) in westus2.

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

Vermeld alle regionale of globale gebeurtenisabonnementen (onder het 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.

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

Alle gebeurtenisabonnementen voor een Event Grid 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, met uitzondering van het gebeurtenisabonnement met de naam 'name1'

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 az configure --defaults location=<location> behulp van .

--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 equal), ne (voor niet gelijk aan), AND, OR en NOT.

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

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

--subscription

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

--topic-type-name

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

az eventgrid event-subscription show

De details van een gebeurtenisabonnement op te halen.

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

Voorbeelden

De details van een gebeurtenisabonnement voor een Event Grid tonen.

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

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

De details van een gebeurtenisabonnement voor een resourcegroep tonen.

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

De details van een gebeurtenisabonnement voor een opslagaccount tonen.

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

De details van een gebeurtenisabonnement voor een resourcegroep tonen, inclusief geheimen voor 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 voor statische leveringskenmerken moeten worden geretourneerd. Waar als de vlag aanwezig is.

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

Geef op om aan te geven of de volledige eindpunt-URL moet worden geretourneerd. Waar als de vlag aanwezig is.

geaccepteerde waarden: false, true
--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--source-resource-id

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

--subscription

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

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 {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]
                                       [--subscription]

Voorbeelden

Werk een gebeurtenisabonnement bij voor een Event Grid 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 filter onderwerp-ends-with 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 filter onderwerp-ends-with 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 deadletter-bestemming 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 zodat bericht-ttl 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 op 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 of JSON string>.

--advanced-filter

Met een geavanceerd filter kunt u gebeurtenissen filteren op basis van een specifieke gebeurtenis-eigenschap.

--deadletter-endpoint

De Azure-resource-id van een Azure Storage blobcontainerbestemming waar EventGrid onbeseerbare gebeurtenissen voor dit gebeurtenisabonnement onbesleekbaar moet maken.

--deadletter-identity

Het identiteitstype van de deadletter-doelresource.

geaccepteerde waarden: systemassigned
--deadletter-identity-endpoint

De Azure-resource-id van een Azure Storage blobcontainerbestemming met een identiteit waar EventGrid onbemiddelde gebeurtenissen voor dit gebeurtenisabonnement onbemiddeld moet laten.

--delivery-attribute-mapping

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

--delivery-identity

Het identiteitstype van de doelresource voor de levering (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 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 doel-eindpunt met resource-identiteit.

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 webhook moet dit de bijbehorende webhook-URL zijn. Voor andere eindpunttypen moet dit de Azure-resource-id van het eindpunt zijn. Het is te verwachten dat het doel-eindpunt al is gemaakt en beschikbaar is voor gebruik voordat u een opdracht Event Grid uitvoeren.

--endpoint-type

Het type van het doel-eindpunt.

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

Wanneer u 'set' of 'add' gebruikt, moet u letterlijke tekenreeksen bewaren in plaats van te proberen te converteren naar JSON.

--included-event-types

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

--labels

Een door spaties gescheiden lijst met labels die u aan dit gebeurtenisabonnement wilt koppelen.

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

Storage de time to live van het wachtrijbericht in seconden.

--remove

Verwijder een eigenschap of een element uit een lijst. Voorbeeld: --remove property.list OR --remove propertyToRemove.

--set

Werk een object bij door een eigenschapspad en waarde op te geven die moeten worden ingesteld. Voorbeeld: --set property1.property2=.

--source-resource-id

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

--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 om gebeurtenissen voor een gebeurtenisabonnement te filteren op basis van een achtervoegsel. Jokertekens worden niet ondersteund.

--subscription

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