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
Naam van het gebeurtenisabonnement.
Optionele parameters
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.
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.
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.
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.
Het identiteitstype van de doelresource deadletter.
De Azure-resource-id van een Azure Storage-blobcontainerbestemming met identiteit waarbij EventGrid niet-bezorgde gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.
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.
Het identiteitstype van de bezorgingsdoelresource (bijvoorbeeld opslagwachtrij of eventhub).
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.
Het type van het doeleindpunt met resource-id.
Hiermee kunnen geavanceerde filters worden geëvalueerd op basis van een matrix met waarden in plaats van een enkelvoudige waarde te verwachten.
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.
Het type van het doeleindpunt.
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).
Time to Live van gebeurtenis (in minuten). Moet een getal tussen 1 en 1440 zijn.
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.
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'.
Een door spaties gescheiden lijst met labels die aan dit gebeurtenisabonnement moeten worden gekoppeld.
Maximum aantal bezorgingspogingen. Moet een getal tussen 1 en 30 zijn.
Maximum aantal gebeurtenissen in een batch. Moet een getal tussen 1 en 5000 zijn.
Voorkeursbatchgrootte in kilobytes. Moet een getal tussen 1 en 1024 zijn.
Berichttijd van opslagwachtrij in seconden.
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.
Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een voorvoegsel. Jokertekens worden niet ondersteund.
Geef op om aan te geven of de onderwerpvelden op een hoofdlettergevoelige manier moeten worden vergeleken. Waar als er een vlag aanwezig is.
Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een achtervoegsel. Jokertekens worden niet ondersteund.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az eventgrid event-subscription create (eventgrid extensie)
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
Naam van het gebeurtenisabonnement.
Optionele parameters
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.
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.
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.
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.
Het identiteitstype van de doelresource deadletter.
De Azure-resource-id van een Azure Storage-blobcontainerbestemming met identiteit waarbij EventGrid niet-bezorgde gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.
Het identiteitstype van de bezorgingsdoelresource (bijvoorbeeld opslagwachtrij of eventhub).
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.
Het type van het doeleindpunt met resource-id.
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.
Het type van het doeleindpunt.
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).
Time to Live van gebeurtenis (in minuten). Moet een getal tussen 1 en 1440 zijn.
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.
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.
Een door spaties gescheiden lijst met labels die aan dit gebeurtenisabonnement moeten worden gekoppeld.
Maximum aantal bezorgingspogingen. Moet een getal tussen 1 en 30 zijn.
Maximum aantal gebeurtenissen in een batch. Moet een getal tussen 1 en 5000 zijn.
Voorkeursbatchgrootte in kilobytes. Moet een getal tussen 1 en 1024 zijn.
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.
Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een voorvoegsel. Jokertekens worden niet ondersteund.
Geef op om aan te geven of de onderwerpvelden op een hoofdlettergevoelige manier moeten worden vergeleken. Waar als er een vlag aanwezig is.
Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een achtervoegsel. Jokertekens worden niet ondersteund.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
Naam van het gebeurtenisabonnement.
Optionele parameters
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az eventgrid event-subscription delete (eventgrid extensie)
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
Naam van het gebeurtenisabonnement.
Optionele parameters
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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:
- 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.
- 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'.
- Als u alle gebeurtenisabonnementen in een regio (voor alle onderwerptypen) wilt weergeven, geeft u alleen de parameter --location op.
- 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
Locatie. Waarden van: az account list-locations
. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>
.
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.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
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.
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az eventgrid event-subscription list (eventgrid extensie)
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:
- 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.
- 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'.
- Als u alle gebeurtenisabonnementen in een regio (voor alle onderwerptypen) wilt weergeven, geeft u alleen de parameter --location op.
- 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
Locatie. Waarden van: az account list-locations
. U kunt de standaardlocatie configureren met behulp van az configure --defaults location=<location>
.
De query die wordt gebruikt om de resultaten te filteren met behulp van OData-syntaxis.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name>
.
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.
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
Naam van het gebeurtenisabonnement.
Optionele parameters
Geef aan of geheimen van statische leveringskenmerken moeten worden geretourneerd. Waar als er een vlag aanwezig is.
Geef op of de volledige eindpunt-URL moet worden geretourneerd. Waar als er een vlag aanwezig is.
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az eventgrid event-subscription show (eventgrid extensie)
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
Naam van het gebeurtenisabonnement.
Optionele parameters
Geef op of de volledige eindpunt-URL moet worden geretourneerd. Waar als er een vlag aanwezig is.
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
Naam van het gebeurtenisabonnement.
Optionele parameters
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>
.
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.
De Azure-resource-id van een Azure Storage-blobcontainerbestemming waar EventGrid onbestelbare gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.
Het identiteitstype van de doelresource deadletter.
De Azure-resource-id van een Azure Storage-blobcontainerbestemming met identiteit waarbij EventGrid niet-bezorgde gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.
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.
Het identiteitstype van de bezorgingsdoelresource (bijvoorbeeld opslagwachtrij of eventhub).
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.
Het type van het doeleindpunt met resource-id.
Hiermee kunnen geavanceerde filters worden geëvalueerd op basis van een matrix met waarden in plaats van een enkelvoudige waarde te verwachten.
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.
Het type van het doeleindpunt.
Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.
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'.
Een door spaties gescheiden lijst met labels die aan dit gebeurtenisabonnement moeten worden gekoppeld.
Berichttijd van opslagwachtrij in seconden.
Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove>
OF --remove propertyToRemove
.
Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>
.
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.
Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een voorvoegsel. Jokertekens worden niet ondersteund.
Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een achtervoegsel. Jokertekens worden niet ondersteund.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.
az eventgrid event-subscription update (eventgrid extensie)
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
Naam van het gebeurtenisabonnement.
Optionele parameters
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>
.
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.
De Azure-resource-id van een Azure Storage-blobcontainerbestemming waar EventGrid onbestelbare gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.
Het identiteitstype van de doelresource deadletter.
De Azure-resource-id van een Azure Storage-blobcontainerbestemming met identiteit waarbij EventGrid niet-bezorgde gebeurtenissen voor dit gebeurtenisabonnement moet overletteren.
Het identiteitstype van de bezorgingsdoelresource (bijvoorbeeld opslagwachtrij of eventhub).
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.
Het type van het doeleindpunt met resource-id.
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.
Het type van het doeleindpunt.
Wanneer u 'set' of 'toevoegen' gebruikt, behoudt u letterlijke tekenreeksen in plaats van te converteren naar JSON.
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.
Een door spaties gescheiden lijst met labels die aan dit gebeurtenisabonnement moeten worden gekoppeld.
Een eigenschap of element uit een lijst verwijderen. Voorbeeld: --remove property.list <indexToRemove>
OF --remove propertyToRemove
.
Werk een object bij door een eigenschapspad en waarde op te geven die u wilt instellen. Voorbeeld: --set property1.property2=<value>
.
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.
Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een voorvoegsel. Jokertekens worden niet ondersteund.
Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een achtervoegsel. Jokertekens worden niet ondersteund.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.