az eventgrid partner topic event-subscription

Gebeurtenisabonnementen van partneronderwerp beheren.

Opdracht

az eventgrid partner topic event-subscription create

Maak een nieuw gebeurtenisabonnement voor een partneronderwerp.

az eventgrid partner topic event-subscription delete

Een gebeurtenisabonnement van een partneronderwerp verwijderen.

az eventgrid partner topic event-subscription list

Lijst met gebeurtenisabonnementen van een specifiek partneronderwerp.

az eventgrid partner topic event-subscription show

De details van een gebeurtenisabonnement van een partneronderwerp op te halen.

az eventgrid partner topic event-subscription update

Werk een gebeurtenisabonnement van een partneronderwerp bij.

az eventgrid partner topic event-subscription create

Maak een nieuw gebeurtenisabonnement voor een partneronderwerp.

az eventgrid partner topic event-subscription create --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--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 partneronderwerp met behulp van standaardfilters.

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Maak een nieuw gebeurtenisabonnement voor een Event Grid partneronderwerp, met een filter dat een onderwerp voorvoegsel opgeeft.

az eventgrid partner topic event-subscription create --name es4 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Maak een nieuw gebeurtenisabonnement voor een Event Grid partneronderwerp, met behulp van standaardfilters en CloudEvent V 1.0 als leveringsschema.

az eventgrid partner topic event-subscription create -n es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Maak een nieuw gebeurtenisabonnement voor een Event Grid partnertopic, met een deadletter-bestemming en aangepast beleid voor opnieuw proberen van maximaal 10 bezorgingspogingen en een TTL van 2 uur (wat eerder gebeurt) en vervaldatum.

az eventgrid partner topic event-subscription create --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partneronderwerp, met behulp Azure Active Directory webhook ingeschakeld als doel .

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partneronderwerp, met behulp van Azure Function als doel.

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Maak een nieuw gebeurtenisabonnement voor een Event Grid partneronderwerp met behulp Storage Queue as destination met bericht ttl op 5 minuten

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partneronderwerp met geavanceerd filteren op matrices ingeschakeld

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

--partner-topic-name

Naam van het partneronderwerp.

--resource-group -g

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

Optionele parameters

--advanced-filter

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

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

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

--azure-active-directory-tenant-id

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

--deadletter-endpoint

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

--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 spaties gescheiden lijst met labels die u aan dit gebeurtenisabonnement wilt koppelen.

--max-delivery-attempts

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

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

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

--preferred-batch-size-in-kilobytes

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

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

Storage de time to live 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-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 partner topic event-subscription delete

Een gebeurtenisabonnement van een partneronderwerp verwijderen.

az eventgrid partner topic event-subscription delete --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--subscription]
                                                     [--yes]

Voorbeelden

Een gebeurtenisabonnement verwijderen voor een Event Grid partneronderwerp.

az eventgrid partner topic event-subscription delete --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

--partner-topic-name

Naam van het partneronderwerp.

--resource-group -g

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

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 partner topic event-subscription list

Lijst met gebeurtenisabonnementen van een specifiek partneronderwerp.

az eventgrid partner topic event-subscription list --partner-topic-name
                                                   --resource-group
                                                   [--odata-query]
                                                   [--query-examples]
                                                   [--subscription]

Voorbeelden

Vermeld alle gebeurtenisabonnementen die zijn gemaakt voor een Event Grid partneronderwerp.

az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1

Vereiste parameters

--partner-topic-name

Naam van het partneronderwerp.

--resource-group -g

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

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 partner topic event-subscription show

De details van een gebeurtenisabonnement van een partneronderwerp op te halen.

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

Voorbeelden

De details van een gebeurtenisabonnement voor een Event Grid partneronderwerp.

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1

De details van een gebeurtenisabonnement voor een partneronderwerp Event Grid en geheimen voor statische leveringskenmerken opnemen

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1 --include-static-delivery-attribute-secret

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

--partner-topic-name

Naam van het partneronderwerp.

--resource-group -g

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

Optionele parameters

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

Geef aan of geheimen van 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 partner topic event-subscription update

Werk een gebeurtenisabonnement van een partneronderwerp bij.

az eventgrid partner topic event-subscription update --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--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 partneronderwerp om een nieuw eindpunt op te geven.

az eventgrid partner topic event-subscription update --name es1 \
    -g rg1 --partner-topic-name partnertopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Werk een gebeurtenisabonnement bij voor een Event Grid partneronderwerp om een nieuw filter onderwerp-ends-with op te geven.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .jpg

Werk een gebeurtenisabonnement voor een Event Grid partneronderwerp bij om een nieuw eindpunt en een nieuw onderwerp-ends-met een nieuwe lijst met opgenomen gebeurtenistypen te filteren.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partneronderwerp om een deadletter-bestemming op te nemen.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Een gebeurtenisabonnement bijwerken voor een Azure Event Grid partneronderwerp, met behulp van geavanceerde filters.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --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 partneronderwerp met Storage Queue als bestemming met bericht ttl op 5 minuten

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Een gebeurtenisabonnement bijwerken voor een Event Grid partneronderwerp met geavanceerd filteren op matrices ingeschakeld

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Vereiste parameters

--name -n

Naam van het gebeurtenisabonnement.

--partner-topic-name

Naam van het partneronderwerp.

--resource-group -g

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

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 .