az eventgrid topic event-subscription
Hantera händelseprenumerationer för ämnet.
Kommandon
Name | Description | Typ | Status |
---|---|---|---|
az eventgrid topic event-subscription create |
Skapa en ny händelseprenumeration för ett ämne. |
Kärna | Allmän tillgänglighet |
az eventgrid topic event-subscription delete |
Ta bort en händelseprenumeration för ett ämne. |
Kärna | Allmän tillgänglighet |
az eventgrid topic event-subscription list |
Lista händelseprenumerationer för ett specifikt ämne. |
Kärna | Allmän tillgänglighet |
az eventgrid topic event-subscription show |
Hämta information om en händelseprenumeration för ett ämne. |
Kärna | Allmän tillgänglighet |
az eventgrid topic event-subscription update |
Uppdatera en händelseprenumeration för ett ämne. |
Kärna | Allmän tillgänglighet |
az eventgrid topic event-subscription create
Skapa en ny händelseprenumeration för ett ämne.
az eventgrid topic event-subscription create --name
--resource-group
--topic-name
[--aad-app-id]
[--aad-tenant-id]
[--advanced-filter]
[--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]
[--pref-batch-size-kb]
[--qttl]
[--subject-begins-with]
[--subject-case-sensitive {false, true}]
[--subject-ends-with]
Exempel
Skapa en ny händelseprenumeration för ett Event Grid-ämne med hjälp av standardfilter.
az eventgrid topic event-subscription create --name es1 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Skapa en ny händelseprenumeration för ett Event Grid-ämne med ett filter som anger ett ämnesprefix.
az eventgrid topic event-subscription create --name es4 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Skapa en ny händelseprenumeration för ett Event Grid-ämne med standardfilter och CloudEvent V 1.0 som leveransschema.
az eventgrid topic event-subscription create -n es2 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Skapa en ny händelseprenumeration för ett Event Grid-ämne med ett deadletter-mål och en anpassad återförsöksprincip på högst 10 leveransförsök och en händelse-TTL på 2 timmar (beroende på vilket som inträffar tidigare) och förfallodatum.
az eventgrid topic event-subscription create --name es2 \
-g rg1 --topic-name topic1 \
--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"
Skapa en ny händelseprenumeration för ett Event Grid-ämne med Azure Active Directory-aktiverad Webhook som mål.
az eventgrid topic event-subscription create --name es1 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--azure-active-directory-tenant-id azureactivedirectorytenantid
--azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri
Skapa en ny händelseprenumeration för ett Event Grid-ämne med Azure Function som mål.
az eventgrid topic event-subscription create -n es1 \
-g rg1 --topic-name topic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction
Skapa en ny händelseprenumeration för ett Event Grid-ämne med lagringskö som mål med en ttl på 5 minuter
az eventgrid topic event-subscription create -n es1 \
-g rg1 --topic-name topic1 \
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--storage-queue-msg-ttl 300
Skapa en ny händelseprenumeration för ett Event Grid-ämne och aktivera avancerad filtrering på matriser
az eventgrid topic event-subscription create -n es1 \
-g rg1 --topic-name topic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
--enable-advanced-filtering-on-arrays true
Obligatoriska parametrar
Namn på händelseprenumerationen.
Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
Namnet på ämnet.
Valfria parametrar
Azure Active Directory-program-ID eller URI för att hämta åtkomsttoken som ska inkluderas som ägartoken i leveransbegäranden. Gäller endast för webhook som mål.
Azure Active Directory-klient-ID:t för att hämta åtkomsttoken som ska inkluderas som ägartoken i leveransbegäranden. Gäller endast för webhook som mål.
Ett avancerat filter möjliggör filtrering av händelser baserat på en specifik händelseegenskap.
Användning: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-VÄRDE [VÄRDE ...] StringIn: --advanced-filter data. FärgsträngI blå röd orange gul stringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotInRange 100 110 200 210 300 310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEqual sant IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Flera avancerade filter kan anges med fler än ett --advanced-filter
argument.
Azure-resurs-ID:t för ett Azure Storage-blobcontainermål där EventGrid bör döda händelser som inte kan levereras för den här händelseprenumerationen.
Exempel: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.
Lägg till leveransattributmappning för att skicka ytterligare information via HTTP-huvuden när händelser levereras. Det här attributet är giltigt för alla måltyper utom StorageQueue. Flera attribut kan anges med fler än ett --delivery-attribute-mapping
argument.
Användning: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.
Gör att avancerade filter kan utvärderas mot en matris med värden i stället för att förvänta sig ett singularvärde.
Slutpunkt där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten. Det förväntas att målslutpunkten redan har skapats och är tillgänglig för användning innan ett Event Grid-kommando körs.
Typ av målslutpunkt.
Schemat där händelser ska levereras för den här händelseprenumerationen. Som standard levereras händelser i samma schema där de publiceras (baserat på motsvarande ämnes indataschema).
Händelsetid till live (i minuter). Måste vara ett tal mellan 1 och 1440.
Datum eller datetime (i UTC, t.ex. "2018-11-30T11:59:59+00:00" eller "2018-11-30") varefter händelseprenumerationen upphör att gälla. Som standard går det inte att förfalla för händelseprenumerationen.
En blankstegsavgränsad lista över händelsetyper (t.ex. Microsoft.Storage.BlobCreated och Microsoft.Storage.BlobDeleted). Om du vill prenumerera på alla standardhändelsetyper ska du inte ange något värde för det här argumentet. För event grid-ämnen är händelsetyper kunddefinierade. För Azure-händelser, t.ex. lagringskonton, IoT Hub osv., kan du fråga deras händelsetyper med hjälp av det här CLI-kommandot "az eventgrid topic-type list-event-types".
En blankstegsavgränsad lista med etiketter som ska associeras med den här händelseprenumerationen.
Maximalt antal leveransförsök. Måste vara ett tal mellan 1 och 30.
Maximalt antal händelser i en batch. Måste vara ett tal mellan 1 och 5 000.
Önskad batchstorlek i kilobyte. Måste vara ett tal mellan 1 och 1024.
Lagringskö meddelandetid att leva i sekunder.
En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett prefix. Jokertecken stöds inte.
Ange om ämnesfälten ska jämföras på ett skiftlägeskänsligt sätt. Sant om flaggan finns.
En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett suffix. Jokertecken stöds inte.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az eventgrid topic event-subscription delete
Ta bort en händelseprenumeration för ett ämne.
az eventgrid topic event-subscription delete --name
--resource-group
--topic-name
[--yes]
Exempel
Ta bort en händelseprenumeration för ett Event Grid-ämne.
az eventgrid topic event-subscription delete --name es1 \
-g rg1 --topic-name topic1 \
Obligatoriska parametrar
Namn på händelseprenumerationen.
Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
Namnet på ämnet.
Valfria parametrar
Fråga inte efter bekräftelse.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az eventgrid topic event-subscription list
Lista händelseprenumerationer för ett specifikt ämne.
az eventgrid topic event-subscription list --resource-group
--topic-name
[--odata-query]
Exempel
Visa en lista över alla händelseprenumerationer som skapats för ett Event Grid-ämne.
az eventgrid topic event-subscription list -g rg1 --topic-name topic1
Obligatoriska parametrar
Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
Namnet på ämnet.
Valfria parametrar
OData-frågan som används för att filtrera listresultatet. Filtrering tillåts för närvarande endast på egenskapen Namn. De åtgärder som stöds är: CONTAINS, eq (för lika), ne (för inte lika), AND, OR och NOT.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az eventgrid topic event-subscription show
Hämta information om en händelseprenumeration för ett ämne.
az eventgrid topic event-subscription show --name
--resource-group
--topic-name
[--full-ed-url {false, true}]
[--include-attrib-secret {false, true}]
Exempel
Visa information om en händelseprenumeration för ett Event Grid-ämne.
az eventgrid topic event-subscription show --name es1 \
-g rg1 --topic-name topic1
Visa information om en händelseprenumeration för ett Event Grid-ämne som innehåller eventuella hemligheter för statiska leveransattribut.
az eventgrid topic event-subscription show --name es1 \
-g rg1 --topic-name topic1 --include-attrib-secret
Obligatoriska parametrar
Namn på händelseprenumerationen.
Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
Namnet på ämnet.
Valfria parametrar
Ange om den fullständiga slutpunkts-URL:en ska returneras. Sant om flaggan finns.
Ange om några hemligheter för statiska leveransattribut ska returneras. Sant om flaggan finns.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az eventgrid topic event-subscription update
Uppdatera en händelseprenumeration för ett ämne.
az eventgrid topic event-subscription update --name
--resource-group
--topic-name
[--advanced-filter]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--enable-advanced-filtering-on-arrays {false, true}]
[--endpoint]
[--included-event-types]
[--labels]
[--qttl]
[--subject-begins-with]
[--subject-ends-with]
[--update-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
Exempel
Uppdatera en händelseprenumeration för ett Event Grid-ämne för att ange en ny slutpunkt.
az eventgrid topic event-subscription update --name es1 \
-g rg1 --topic-name topic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Uppdatera en händelseprenumeration för ett Event Grid-ämne för att ange ett nytt ämnesslut med filter.
az eventgrid topic event-subscription update --name es2 \
-g rg1 --topic-name topic1 \
--subject-ends-with .jpg
Uppdatera en händelseprenumeration för ett Event Grid-ämne för att ange en ny slutpunkt och ett nytt ämne med filter för en ny lista över inkluderade händelsetyper.
az eventgrid topic event-subscription update --name es3 \
-g rg1 --topic-name topic1 \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted
Uppdatera en händelseprenumeration för ett Azure Event Grid-ämne för att inkludera ett deadletter-mål.
az eventgrid topic event-subscription update --name es2 \
-g rg1 --topic-name topic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Uppdatera en händelseprenumeration för ett Azure Event Grid-ämne med hjälp av avancerade filter.
az eventgrid topic event-subscription update --name es3 \
-g rg1 --topic-name topic1 \
--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
Uppdatera en händelseprenumeration för ett Event Grid-ämne med Lagringskö som mål med ttl på 5 minuter
az eventgrid topic event-subscription update -n es1 \
-g rg1 --topic-name topic1 \
--storage-queue-msg-ttl 300
Uppdatera en händelseprenumeration för ett Event Grid-ämne med avancerad filtrering på matriser aktiverat
az eventgrid topic event-subscription update -n es1 \
-g rg1 --topic-name topic1 \
--enable-advanced-filtering-on-arrays true
Obligatoriska parametrar
Namn på händelseprenumerationen.
Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
Namnet på ämnet.
Valfria parametrar
Ett avancerat filter möjliggör filtrering av händelser baserat på en specifik händelseegenskap.
Användning: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-VÄRDE [VÄRDE ...] StringIn: --advanced-filter data. FärgsträngI blå röd orange gul stringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotInRange 100 110 200 210 300 310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEqual sant IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Flera avancerade filter kan anges med fler än ett --advanced-filter
argument.
Azure-resurs-ID:t för ett Azure Storage-blobcontainermål där EventGrid bör döda händelser som inte kan levereras för den här händelseprenumerationen.
Lägg till leveransattributmappning för att skicka ytterligare information via HTTP-huvuden när händelser levereras. Det här attributet är giltigt för alla måltyper utom StorageQueue. Flera attribut kan anges med fler än ett --delivery-attribute-mapping
argument.
Användning: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.
Gör att avancerade filter kan utvärderas mot en matris med värden i stället för att förvänta sig ett singularvärde.
Slutpunkt där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten. Det förväntas att målslutpunkten redan har skapats och är tillgänglig för användning innan ett Event Grid-kommando körs.
En blankstegsavgränsad lista över händelsetyper (t.ex. Microsoft.Storage.BlobCreated och Microsoft.Storage.BlobDeleted). Om du vill prenumerera på alla standardhändelsetyper ska du inte ange något värde för det här argumentet. För event grid-ämnen är händelsetyper kunddefinierade. För Azure-händelser, t.ex. lagringskonton, IoT Hub osv., kan du fråga deras händelsetyper med hjälp av det här CLI-kommandot "az eventgrid topic-type list-event-types".
En blankstegsavgränsad lista med etiketter som ska associeras med den här händelseprenumerationen.
Lagringskö meddelandetid att leva i sekunder.
En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett prefix. Jokertecken stöds inte.
En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett suffix. Jokertecken stöds inte.
Typ av målslutpunkt.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.
Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.