az eventgrid domain event-subscription
Správa odběrů událostí domény
Příkazy
Name | Description | Typ | Stav |
---|---|---|---|
az eventgrid domain event-subscription create |
Vytvořte nové odběry událostí pro doménu. |
Základ | GA |
az eventgrid domain event-subscription delete |
Odstranění odběru události domény |
Základ | GA |
az eventgrid domain event-subscription list |
Výpis odběrů událostí konkrétní domény |
Základ | GA |
az eventgrid domain event-subscription show |
Získejte podrobnosti o odběru události domény. |
Základ | GA |
az eventgrid domain event-subscription update |
Aktualizujte odběr události domény. |
Základ | GA |
az eventgrid domain event-subscription create
Vytvořte nové odběry událostí pro doménu.
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]
Příklady
Vytvořte nové odběry událostí pro doménu Event Gridu pomocí výchozích filtrů.
az eventgrid domain event-subscription create --name es1 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Vytvořte nové odběry událostí pro doménu Event Gridu s filtrem určujícím předponu předmětu.
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
Vytvořte nové odběry událostí pro doménu Event Gridu s použitím výchozích filtrů a cloudEvent verze 1.0 jako schématu doručení.
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
Vytvořte nové odběry událostí pro doménu Event Gridu s cílem deadletteru a vlastní zásadou opakování s maximálním počtem 10 pokusů o doručení a 2 hodinovou hodnotu TTL události (podle toho, co nastane dříve) a datem vypršení platnosti.
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"
Vytvořte nové odběry událostí pro doménu Event Gridu pomocí webhooku s podporou Azure Active Directory jako cíle.
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
Vytvořte nové odběry událostí pro doménu Event Gridu pomocí funkce Azure Functions jako cíle.
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
Vytvoření nového odběru událostí pro doménu Event Gridu pomocí fronty úložiště jako cíle s ttl 5 minut
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
Vytvoření nového odběru událostí pro doménu Event Gridu a povolení rozšířeného filtrování polí
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
Povinné parametry
Název domény.
Název odběru události.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Volitelné parametry
ID aplikace Azure Active Directory nebo identifikátor URI pro získání přístupového tokenu, který bude zahrnut jako nosný token v žádostech o doručení. Platí pouze pro webhook jako cíl.
ID tenanta Azure Active Directory pro získání přístupového tokenu, který bude zahrnut jako nosný token v žádostech o doručení. Platí pouze pro webhook jako cíl.
Rozšířený filtr umožňuje filtrování událostí na základě konkrétní vlastnosti události.
Použití: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginssWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png 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 ČísloNotInRange 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 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Více rozšířených filtrů lze zadat pomocí více než jednoho --advanced-filter
argumentu.
ID prostředku Azure cílového kontejneru objektů blob služby Azure Storage, kde by EventGrid měl pro toto odběr událostí zrušit nedoručitelné události.
Příklad: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.
Přidání mapování atributů doručení pro odesílání dalších informací prostřednictvím hlaviček HTTP při doručování událostí. Tento atribut je platný pro všechny cílové typy s výjimkou StorageQueue. Více atributů lze zadat pomocí více než jednoho --delivery-attribute-mapping
argumentu.
Použití: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Statické mapování atributů: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somename false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.
Umožňuje, aby se rozšířené filtry vyhodnocovaly proti poli hodnot místo toho, aby nečekaly hodnotu v jednotném čísle.
Koncový bod, kde eventGrid by měl doručovat události odpovídající tomuto odběru událostí. U typu koncového bodu webhooku by to měla být odpovídající adresa URL webhooku. U jiných typů koncových bodů by to měl být identifikátor prostředku Azure koncového bodu. Před spuštěním jakéhokoli příkazu Event Gridu se očekává, že cílový koncový bod už je vytvořený a dostupný pro použití.
Typ cílového koncového bodu.
Schéma, ve kterém se mají události doručovat pro toto odběry událostí. Ve výchozím nastavení se události doručí ve stejném schématu, ve kterém jsou publikovány (na základě vstupního schématu odpovídajícího tématu).
Doba živé události (v minutách). Musí to být číslo od 1 do 1440.
Datum nebo datum a čas (v UTC, např. 2018-11-30T11:59:59+00:00 nebo 2018-11-30), po kterém vyprší platnost odběru události. Ve výchozím nastavení neexistuje žádné vypršení platnosti odběru událostí.
Seznam typů událostí oddělených mezerami (např. Microsoft.Storage.BlobCreated a Microsoft.Storage.BlobDeleted). Chcete-li se přihlásit k odběru všech výchozích typů událostí, nezadávejte pro tento argument žádnou hodnotu. U témat event gridu jsou typy událostí definované zákazníkem. Pro události Azure, například účty úložiště, IoT Hub atd., můžete jejich typy událostí dotazovat pomocí tohoto příkazu rozhraní příkazového řádku az eventgrid topic-type list-event-types.
Seznam popisků oddělených mezerami, které se mají přidružit k tomuto odběru událostí.
Maximální počet pokusů o doručení Musí to být číslo od 1 do 30.
Maximální počet událostí v dávce Musí to být číslo od 1 do 5000.
Upřednostňovaná velikost dávky v kilobajtech. Musí to být číslo v rozsahu 1 až 1024.
Doba živé zprávy fronty úložiště v sekundách
Volitelný řetězec pro filtrování událostí odběru událostí na základě předpony. Zástupné znaky nejsou podporovány.
Určete, zda se pole předmětu mají porovnávat citlivým způsobem na malá a velká písmena. True if flag present.
Volitelný řetězec pro filtrování událostí odběru událostí na základě přípony. Zástupné znaky nejsou podporovány.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az eventgrid domain event-subscription delete
Odstranění odběru události domény
az eventgrid domain event-subscription delete --domain-name
--name
--resource-group
[--yes]
Příklady
Odstranění odběru událostí pro doménu Event Gridu
az eventgrid domain event-subscription delete --name es1 \
-g rg1 --domain-name domain1 \
Povinné parametry
Název domény.
Název odběru události.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Volitelné parametry
Nezotvádejte výzvu k potvrzení.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az eventgrid domain event-subscription list
Výpis odběrů událostí konkrétní domény
az eventgrid domain event-subscription list --domain-name
--resource-group
[--odata-query]
Příklady
Zobrazí seznam všech odběrů událostí vytvořených pro doménu Event Gridu.
az eventgrid domain event-subscription list -g rg1 --domain-name domain1
Povinné parametry
Název domény.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Volitelné parametry
Dotaz OData použitý k filtrování výsledků seznamu. Filtrování je aktuálně povoleno pouze u vlastnosti Name. Mezi podporované operace patří: CONTAINS, eq (pro rovná se), ne (ne rovno), AND, OR a NOT.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az eventgrid domain event-subscription show
Získejte podrobnosti o odběru události domény.
az eventgrid domain event-subscription show --domain-name
--name
--resource-group
[--full-ed-url {false, true}]
[--include-attrib-secret {false, true}]
Příklady
Zobrazí podrobnosti odběru událostí pro doménu Event Gridu.
az eventgrid domain event-subscription show --name es1 \
-g rg1 --domain-name domain1
Zobrazení podrobností odběru událostí pro doménu Event Gridu zahrnuje všechny tajné kódy atributů statického doručování.
az eventgrid domain event-subscription show --name es1 \
-g rg1 --domain-name domain1 --include-attrib-secret
Povinné parametry
Název domény.
Název odběru události.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Volitelné parametry
Zadejte, zda má být vrácena úplná adresa URL koncového bodu. True if flag present.
Určete, jestli se mají vrátit nějaké tajné kódy atributů statického doručení. True if flag present.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.
az eventgrid domain event-subscription update
Aktualizujte odběr události domény.
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}]
Příklady
Aktualizujte odběr událostí pro doménu Event Gridu a zadejte nový koncový bod.
az eventgrid domain event-subscription update --name es1 \
-g rg1 --domain-name domain1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Aktualizujte odběr událostí pro doménu Event Gridu a zadejte nový filtr končících předmětem.
az eventgrid domain event-subscription update --name es2 \
-g rg1 --domain-name domain1 \
--subject-ends-with .jpg
Aktualizujte odběr událostí pro doménu Event Gridu tak, aby určil nový koncový bod a nový předmět končí filtrem nového seznamu zahrnutých typů událostí.
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
Aktualizujte odběr událostí pro doménu služby Azure Event Grid tak, aby zahrnoval cíl deadletteru.
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
Aktualizujte odběr událostí pro doménu služby Azure Event Grid pomocí rozšířených filtrů.
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
Aktualizace odběru událostí pro doménu Event Gridu s využitím fronty úložiště jako cíle s ttl 5 minut
az eventgrid domain event-subscription update -n es1 \
-g rg1 --domain-name domain1 \
--storage-queue-msg-ttl 300
Aktualizace odběru událostí pro doménu Event Gridu s rozšířeným filtrováním polí
az eventgrid domain event-subscription update -n es1 \
-g rg1 --domain-name domain1 \
--enable-advanced-filtering-on-arrays true
Povinné parametry
Název domény.
Název odběru události.
Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Volitelné parametry
Rozšířený filtr umožňuje filtrování událostí na základě konkrétní vlastnosti události.
Použití: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginssWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png 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 ČísloNotInRange 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 BoolEquals true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Více rozšířených filtrů lze zadat pomocí více než jednoho --advanced-filter
argumentu.
ID prostředku Azure cílového kontejneru objektů blob služby Azure Storage, kde by EventGrid měl pro toto odběr událostí zrušit nedoručitelné události.
Přidání mapování atributů doručení pro odesílání dalších informací prostřednictvím hlaviček HTTP při doručování událostí. Tento atribut je platný pro všechny cílové typy s výjimkou StorageQueue. Více atributů lze zadat pomocí více než jednoho --delivery-attribute-mapping
argumentu.
Použití: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Statické mapování atributů: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somename false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.
Umožňuje, aby se rozšířené filtry vyhodnocovaly proti poli hodnot místo toho, aby nečekaly hodnotu v jednotném čísle.
Koncový bod, kde eventGrid by měl doručovat události odpovídající tomuto odběru událostí. U typu koncového bodu webhooku by to měla být odpovídající adresa URL webhooku. U jiných typů koncových bodů by to měl být identifikátor prostředku Azure koncového bodu. Před spuštěním jakéhokoli příkazu Event Gridu se očekává, že cílový koncový bod už je vytvořený a dostupný pro použití.
Seznam typů událostí oddělených mezerami (např. Microsoft.Storage.BlobCreated a Microsoft.Storage.BlobDeleted). Chcete-li se přihlásit k odběru všech výchozích typů událostí, nezadávejte pro tento argument žádnou hodnotu. U témat event gridu jsou typy událostí definované zákazníkem. Pro události Azure, například účty úložiště, IoT Hub atd., můžete jejich typy událostí dotazovat pomocí tohoto příkazu rozhraní příkazového řádku az eventgrid topic-type list-event-types.
Seznam popisků oddělených mezerami, které se mají přidružit k tomuto odběru událostí.
Doba živé zprávy fronty úložiště v sekundách
Volitelný řetězec pro filtrování událostí odběru událostí na základě předpony. Zástupné znaky nejsou podporovány.
Volitelný řetězec pro filtrování událostí odběru událostí na základě přípony. Zástupné znaky nejsou podporovány.
Typ cílového koncového bodu.
Globální parametry
Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.
Zobrazte tuto zprávu nápovědy a ukončete ji.
Zobrazují se pouze chyby, potlačení upozornění.
Výstupní formát
Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.
Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID
.
Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.