az eventgrid system-topic event-subscription
Gebeurtenisabonnementen van het systeemonderwerp beheren.
Opdracht
| az eventgrid system-topic event-subscription create |
Maak een nieuw gebeurtenisabonnement voor een systeemonderwerp. |
| az eventgrid system-topic event-subscription delete |
Een gebeurtenisabonnement van een systeemonderwerp verwijderen. |
| az eventgrid system-topic event-subscription list |
Lijst met gebeurtenisabonnementen van een specifiek systeemonderwerp. |
| az eventgrid system-topic event-subscription show |
De details van een gebeurtenisabonnement van een systeemonderwerp op te halen. |
| az eventgrid system-topic event-subscription update |
Werk een gebeurtenisabonnement van een systeemonderwerp bij. |
az eventgrid system-topic event-subscription create
Maak een nieuw gebeurtenisabonnement voor een systeemonderwerp.
az eventgrid system-topic event-subscription create --name
--resource-group
--system-topic-name
[--advanced-filter]
[--azure-active-directory-application-id-or-uri]
[--azure-active-directory-tenant-id]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--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]
[--subject-begins-with]
[--subject-case-sensitive {false, true}]
[--subject-ends-with]
[--subscription]
Voorbeelden
Maak een nieuw gebeurtenisabonnement voor een Event Grid systeemonderwerp, met behulp van standaardfilters.
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Maak een nieuw gebeurtenisabonnement voor een Event Grid systeemonderwerp, met een filter dat een onderwerp voorvoegsel opgeeft.
az eventgrid system-topic event-subscription create --name es4 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Maak een nieuw gebeurtenisabonnement voor een Event Grid systeemonderwerp, met behulp van standaardfilters en CloudEvent V 1.0 als het leveringsschema.
az eventgrid system-topic event-subscription create -n es2 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Maak een nieuw gebeurtenisabonnement voor een Event Grid-systeemonderwerp, met een deadletter-bestemming en aangepast beleid voor opnieuw proberen van maximaal 10 bezorgingspogingen en een gebeurtenis-TTL van 2 uur (wat eerder gebeurt) en vervaldatum.
az eventgrid system-topic event-subscription create --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--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 --expiration-date "2022-10-31"
Maak een nieuw gebeurtenisabonnement voor een Event Grid systeemonderwerp, met behulp Azure Active Directory ingeschakelde webhook als doel .
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--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 systeemonderwerp, met behulp van Azure Function als doel.
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction
Maak een nieuw gebeurtenisabonnement voor een Event Grid systeemonderwerp met behulp Storage Queue as destination met een ttl van 5 minuten
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--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 systeemonderwerp en schakel geavanceerd filteren op matrices in
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
--enable-advanced-filtering-on-arrays true
Vereiste parameters
Naam van het gebeurtenisabonnement.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .
Naam van het systeemonderwerp.
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 als bearer-token wordt opgenomen 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.
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.
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 spatie 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.
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 voor het filteren van gebeurtenissen voor een gebeurtenisabonnement 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 logboekbebossing 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 system-topic event-subscription delete
Een gebeurtenisabonnement van een systeemonderwerp verwijderen.
az eventgrid system-topic event-subscription delete --name
--resource-group
--system-topic-name
[--subscription]
[--yes]
Voorbeelden
Een gebeurtenisabonnement voor een Event Grid verwijderen.
az eventgrid system-topic event-subscription delete --name es1 \
-g rg1 --system-topic-name systemtopic1 \
Vereiste parameters
Naam van het gebeurtenisabonnement.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .
Naam van het systeemonderwerp.
Optionele parameters
Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .
Niet vragen om bevestiging.
Vergroot de logboekbebossing 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 system-topic event-subscription list
Lijst met gebeurtenisabonnementen van een specifiek systeemonderwerp.
az eventgrid system-topic event-subscription list --resource-group
--system-topic-name
[--odata-query]
[--query-examples]
[--subscription]
Voorbeelden
Een lijst met alle gebeurtenisabonnementen maken voor een Event Grid systeemonderwerp.
az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1
Vereiste parameters
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .
Naam van het systeemonderwerp.
Optionele parameters
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.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .
Vergroot de logboekbebossing 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 system-topic event-subscription show
De details van een gebeurtenisabonnement van een systeemonderwerp op te halen.
az eventgrid system-topic event-subscription show --name
--resource-group
--system-topic-name
[--include-attrib-secret {false, true}]
[--include-full-endpoint-url {false, true}]
[--query-examples]
[--subscription]
Voorbeelden
De details van een gebeurtenisabonnement voor een Event Grid systeemonderwerp.
az eventgrid system-topic event-subscription show --name es1 \
-g rg1 --system-topic-name systemtopic1
De details van een gebeurtenisabonnement voor een Event Grid systeemonderwerp bevatten alle statische levering kenmerk geheimen.
az eventgrid system-topic event-subscription show --name es1 \
-g rg1 --system-topic-name systemtopic1 --include-attrib-secret
Vereiste parameters
Naam van het gebeurtenisabonnement.
De naam van de resourcegroep. U kunt de standaardgroep configureren met behulp van az configure --defaults group=<name> .
Naam van het systeemonderwerp.
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.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met az account set -s NAME_OR_ID behulp van .
Vergroot de logboekbebossing 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 system-topic event-subscription update
Werk een gebeurtenisabonnement van een systeemonderwerp bij.
az eventgrid system-topic event-subscription update --name
--resource-group
--system-topic-name
[--advanced-filter]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--enable-advanced-filtering-on-arrays {false, true}]
[--endpoint]
[--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--included-event-types]
[--labels]
[--qttl]
[--subject-begins-with]
[--subject-ends-with]
[--subscription]
Voorbeelden
Werk een gebeurtenisabonnement bij voor een Event Grid systeemonderwerp om een nieuw eindpunt op te geven.
az eventgrid system-topic event-subscription update --name es1 \
-g rg1 --system-topic-name systemtopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Werk een gebeurtenisabonnement bij voor een Event Grid systeemonderwerp om een nieuw onderwerp-ends-with-filter op te geven.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .jpg
Werk een gebeurtenisabonnement voor een Event Grid systeemonderwerp bij om een nieuw eindpunt en een nieuw onderwerp-ends-met een nieuwe lijst met opgenomen gebeurtenistypen te filteren.
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted
Werk een gebeurtenisabonnement bij voor een Azure Event Grid van een systeemonderwerp om een deadletter-bestemming op te nemen.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Een gebeurtenisabonnement bijwerken voor een Azure Event Grid systeemonderwerp, met behulp van geavanceerde filters.
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--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
Een gebeurtenisabonnement bijwerken voor een Event Grid systeemonderwerp met Storage Queue als bestemming met ttl van 5 minuten
az eventgrid system-topic event-subscription update -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--storage-queue-msg-ttl 300
Een gebeurtenisabonnement bijwerken voor een Event Grid systeemonderwerp met geavanceerd filteren op matrices ingeschakeld
az eventgrid system-topic event-subscription update -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--enable-advanced-filtering-on-arrays true
Vereiste parameters
Naam van het gebeurtenisabonnement.
De naam van de resourcegroep. U kunt de standaardgroep configureren met az configure --defaults group=<name> behulp van .
Naam van het systeemonderwerp.
Optionele parameters
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 onbemiddelde gebeurtenissen voor dit gebeurtenisabonnement onbesleekbaar moet maken.
Voeg toewijzing van delivery-kenmerk 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.
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.
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 spatie gescheiden lijst met labels die u aan dit gebeurtenisabonnement wilt koppelen.
Storage time to live in de wachtrij in seconden.
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.
Naam of id van het abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID .
Vergroot de logboekbebossing 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.