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

--name -n

Naam van het gebeurtenisabonnement.

--resource-group -g

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

--system-topic-name

Naam van het systeemonderwerp.

Optionele parameters

--advanced-filter

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

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

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

--azure-active-directory-tenant-id

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

--deadletter-endpoint

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

--delivery-attribute-mapping

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

--enable-advanced-filtering-on-arrays --enable-af-arr

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

geaccepteerde waarden: false, true
--endpoint

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

--endpoint-type

Het type van het doel-eindpunt.

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

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

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

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

standaardwaarde: 1440
--expiration-date

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

--included-event-types

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

--labels

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

--max-delivery-attempts

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

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

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

--preferred-batch-size-in-kilobytes

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

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

Storage de time to live van het wachtrijbericht in seconden.

--subject-begins-with

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

--subject-case-sensitive

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

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

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

--subscription

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

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

--name -n

Naam van het gebeurtenisabonnement.

--resource-group -g

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

--system-topic-name

Naam van het systeemonderwerp.

Optionele parameters

--subscription

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

--yes -y

Niet vragen om bevestiging.

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

--resource-group -g

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

--system-topic-name

Naam van het systeemonderwerp.

Optionele parameters

--odata-query

De OData-query die wordt gebruikt voor het filteren van de lijstresultaten. Filteren is momenteel alleen toegestaan voor de eigenschap Naam. De ondersteunde bewerkingen zijn: CONTAINS, eq (voor equal), ne (voor niet gelijk aan), AND, OR en NOT.

--query-examples

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

--subscription

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

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

--name -n

Naam van het gebeurtenisabonnement.

--resource-group -g

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

--system-topic-name

Naam van het systeemonderwerp.

Optionele parameters

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

Geef aan of geheimen voor statische leveringskenmerken moeten worden geretourneerd. Waar als de vlag aanwezig is.

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

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

geaccepteerde waarden: false, true
--query-examples

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

--subscription

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

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

--name -n

Naam van het gebeurtenisabonnement.

--resource-group -g

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

--system-topic-name

Naam van het systeemonderwerp.

Optionele parameters

--advanced-filter

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

--deadletter-endpoint

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

--delivery-attribute-mapping

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.

--enable-advanced-filtering-on-arrays --enable-af-arr

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

geaccepteerde waarden: false, true
--endpoint

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

--endpoint-type

Het type van het doel-eindpunt.

geaccepteerde waarden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
standaardwaarde: webhook
--included-event-types

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

--labels

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

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

Storage time to live in de wachtrij in seconden.

--subject-begins-with

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

--subject-ends-with

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

--subscription

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