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
Naam van het gebeurtenisabonnement.
Optionele parameters
Met een geavanceerd filter kunt u gebeurtenissen filteren op basis van een specifieke gebeurtenis-eigenschap.
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.
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.
De Azure-resource-id van een Azure Storage blobcontainerbestemming waar EventGrid onbeseerbare gebeurtenissen voor dit gebeurtenisabonnement onbesleekbaar moet maken.
Het identiteitstype van de deadletter-doelresource.
De Azure-resource-id van een Azure Storage blobcontainerbestemming met een identiteit waar EventGrid onbemiddelde gebeurtenissen voor dit gebeurtenisabonnement onbemiddeld moet laten.
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.
Het identiteitstype van de doelresource voor de levering (bijvoorbeeld opslagwachtrij of eventhub).
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.
Het type van het doel-eindpunt met resource-identiteit.
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 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.
Het type van het doel-eindpunt.
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).
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 verloopt. Standaard is er geen vervaldatum voor het gebeurtenisabonnement.
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'.
Een door spaties gescheiden lijst met labels die u aan dit gebeurtenisabonnement wilt koppelen.
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.
Batchgrootte van voorkeur in kilobytes. Moet een getal tussen 1 en 1024 zijn.
Storage de time to live van het wachtrijbericht in seconden.
Volledig gekwalificeerde id van de Azure-resource waarop het gebeurtenisabonnement moet worden gemaakt.
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 casegevoelige manier moeten worden vergeleken. Waar als de vlag aanwezig is.
Een optionele tekenreeks om gebeurtenissen voor een gebeurtenisabonnement te filteren op basis van een achtervoegsel. Jokertekens worden niet ondersteund.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .
Vergroot de logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
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
Naam van het gebeurtenisabonnement.
Optionele parameters
Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden verwijderd.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .
Vergroot de logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
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:
- 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.
- 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'.
- Als u alle gebeurtenisabonnementen in een regio wilt vermelden (voor alle onderwerptypen), geeft u alleen de parameter --location op.
- 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
Locatie. Waarden van: az account list-locations . U kunt de standaardlocatie configureren met az configure --defaults location=<location> behulp van .
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.
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.
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.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .
Naam van het onderwerptype waarvan de gebeurtenisabonnementen moeten worden vermeld. Wanneer dit is opgegeven, moet u ook --location opgeven.
Vergroot de logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
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
Naam van het gebeurtenisabonnement.
Optionele parameters
Geef aan of geheimen voor statische leveringskenmerken moeten worden geretourneerd. Waar als de vlag aanwezig is.
Geef op om aan te geven of de volledige eindpunt-URL moet worden geretourneerd. Waar als de vlag aanwezig is.
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.
Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden weergegeven.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .
Vergroot de logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.
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
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 of JSON string>.
Met een geavanceerd filter kunt u gebeurtenissen filteren op basis van een specifieke gebeurtenis-eigenschap.
De Azure-resource-id van een Azure Storage blobcontainerbestemming waar EventGrid onbeseerbare gebeurtenissen voor dit gebeurtenisabonnement onbesleekbaar moet maken.
Het identiteitstype van de deadletter-doelresource.
De Azure-resource-id van een Azure Storage blobcontainerbestemming met een identiteit waar EventGrid onbemiddelde gebeurtenissen voor dit gebeurtenisabonnement onbemiddeld moet laten.
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.
Het identiteitstype van de doelresource voor de levering (bijvoorbeeld opslagwachtrij of eventhub).
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.
Het type van het doel-eindpunt met resource-identiteit.
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 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.
Het type van het doel-eindpunt.
Wanneer u 'set' of 'add' gebruikt, moet u letterlijke tekenreeksen bewaren in plaats van te proberen te converteren naar JSON.
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'.
Een door spaties gescheiden lijst met labels die u aan dit gebeurtenisabonnement wilt koppelen.
Storage de time to live van het wachtrijbericht in seconden.
Verwijder een eigenschap of een element uit een lijst. Voorbeeld: --remove property.list OR --remove propertyToRemove.
Werk een object bij door een eigenschapspad en waarde op te geven die moeten worden ingesteld. Voorbeeld: --set property1.property2=.
Volledig gekwalificeerde id van de Azure-resource waarvan het gebeurtenisabonnement moet worden bijgewerkt.
Een optionele tekenreeks voor het filteren van gebeurtenissen voor een gebeurtenisabonnement op basis van een voorvoegsel. Jokertekens worden niet ondersteund.
Een optionele tekenreeks om gebeurtenissen voor een gebeurtenisabonnement te filteren op basis van een achtervoegsel. Jokertekens worden niet ondersteund.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .
Vergroot de logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Laat dit Help-bericht zien en sluit af.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Vergroot de logboekverkenbaarheid. Gebruik --debug voor volledige logboeken voor foutopsporing.