az eventgrid domain event-subscription
Hantera händelseprenumerationer för domänen.
Kommandon
Name | Description | Typ | Status |
---|---|---|---|
az eventgrid domain event-subscription create |
Skapa en ny händelseprenumeration för en domän. |
Kärna | Allmän tillgänglighet |
az eventgrid domain event-subscription delete |
Ta bort en händelseprenumeration för en domän. |
Kärna | Allmän tillgänglighet |
az eventgrid domain event-subscription list |
Lista händelseprenumerationer för en specifik domän. |
Kärna | Allmän tillgänglighet |
az eventgrid domain event-subscription show |
Hämta information om en händelseprenumeration för en domän. |
Kärna | Allmän tillgänglighet |
az eventgrid domain event-subscription update |
Uppdatera en händelseprenumeration för en domän. |
Kärna | Allmän tillgänglighet |
az eventgrid domain event-subscription create
Skapa en ny händelseprenumeration för en domän.
az eventgrid domain event-subscription create --domain-name
--name
--resource-group
[--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 en Event Grid-domän med hjälp av standardfilter.
az eventgrid domain event-subscription create --name es1 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Skapa en ny händelseprenumeration för en Event Grid-domän med ett filter som anger ett ämnesprefix.
az eventgrid domain event-subscription create --name es4 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Skapa en ny händelseprenumeration för en Event Grid-domän med standardfilter och CloudEvent V 1.0 som leveransschema.
az eventgrid domain event-subscription create -n es2 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Skapa en ny händelseprenumeration för en Event Grid-domän 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 domain event-subscription create --name es2 \
-g rg1 --domain-name domain1 \
--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 en Event Grid-domän med Azure Active Directory-aktiverad Webhook som mål.
az eventgrid domain event-subscription create --name es1 \
-g rg1 --domain-name domain1 \
--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 en Event Grid-domän med Azure Function som mål.
az eventgrid domain event-subscription create -n es1 \
-g rg1 --domain-name domain1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction
Skapa en ny händelseprenumeration för en Event Grid-domän med lagringskö som mål med en ttl på 5 minuter
az eventgrid domain event-subscription create -n es1 \
-g rg1 --domain-name domain1 \
--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 en Event Grid-domän och aktivera avancerad filtrering på matriser
az eventgrid domain event-subscription create -n es1 \
-g rg1 --domain-name domain1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
--enable-advanced-filtering-on-arrays true
Obligatoriska parametrar
Namnet på domänen.
Namn på händelseprenumerationen.
Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
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 domain event-subscription delete
Ta bort en händelseprenumeration för en domän.
az eventgrid domain event-subscription delete --domain-name
--name
--resource-group
[--yes]
Exempel
Ta bort en händelseprenumeration för en Event Grid-domän.
az eventgrid domain event-subscription delete --name es1 \
-g rg1 --domain-name domain1 \
Obligatoriska parametrar
Namnet på domänen.
Namn på händelseprenumerationen.
Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
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 domain event-subscription list
Lista händelseprenumerationer för en specifik domän.
az eventgrid domain event-subscription list --domain-name
--resource-group
[--odata-query]
Exempel
Visa en lista över alla händelseprenumerationer som skapats för en Event Grid-domän.
az eventgrid domain event-subscription list -g rg1 --domain-name domain1
Obligatoriska parametrar
Namnet på domänen.
Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
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 domain event-subscription show
Hämta information om en händelseprenumeration för en domän.
az eventgrid domain event-subscription show --domain-name
--name
--resource-group
[--full-ed-url {false, true}]
[--include-attrib-secret {false, true}]
Exempel
Visa information om en händelseprenumeration för en Event Grid-domän.
az eventgrid domain event-subscription show --name es1 \
-g rg1 --domain-name domain1
Visa information om en händelseprenumeration för en Event Grid-domän och inkludera eventuella hemligheter för statiska leveransattribut.
az eventgrid domain event-subscription show --name es1 \
-g rg1 --domain-name domain1 --include-attrib-secret
Obligatoriska parametrar
Namnet på domänen.
Namn på händelseprenumerationen.
Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
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 domain event-subscription update
Uppdatera en händelseprenumeration för en domän.
az eventgrid domain event-subscription update --domain-name
--name
--resource-group
[--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 en Event Grid-domän för att ange en ny slutpunkt.
az eventgrid domain event-subscription update --name es1 \
-g rg1 --domain-name domain1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Uppdatera en händelseprenumeration för en Event Grid-domän för att ange ett nytt ämnesslut med filter.
az eventgrid domain event-subscription update --name es2 \
-g rg1 --domain-name domain1 \
--subject-ends-with .jpg
Uppdatera en händelseprenumeration för en Event Grid-domän för att ange en ny slutpunkt och ett nytt ämne med filter för en ny lista över inkluderade händelsetyper.
az eventgrid domain event-subscription update --name es3 \
-g rg1 --domain-name domain1 \
--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 en Azure Event Grid-domän så att den innehåller ett deadletter-mål.
az eventgrid domain event-subscription update --name es2 \
-g rg1 --domain-name domain1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Uppdatera en händelseprenumeration för en Azure Event Grid-domän med hjälp av avancerade filter.
az eventgrid domain event-subscription update --name es3 \
-g rg1 --domain-name domain1 \
--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 en Event Grid-domän med Lagringskö som mål med ttl på 5 minuter
az eventgrid domain event-subscription update -n es1 \
-g rg1 --domain-name domain1 \
--storage-queue-msg-ttl 300
Uppdatera en händelseprenumeration för en Event Grid-domän med avancerad filtrering på matriser aktiverat
az eventgrid domain event-subscription update -n es1 \
-g rg1 --domain-name domain1 \
--enable-advanced-filtering-on-arrays true
Obligatoriska parametrar
Namnet på domänen.
Namn på händelseprenumerationen.
Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>
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.