az eventgrid domain topic event-subscription
Správa odběrů událostí tématu domény
Příkazy
Name | Description | Typ | Stav |
---|---|---|---|
az eventgrid domain topic event-subscription create |
Vytvořte nové odběry událostí pro téma domény. |
Základ | GA |
az eventgrid domain topic event-subscription delete |
Odstranění odběru událostí tématu domény |
Základ | GA |
az eventgrid domain topic event-subscription list |
Vypíše odběry událostí konkrétního tématu domény. |
Základ | GA |
az eventgrid domain topic event-subscription show |
Získejte podrobnosti o odběru událostí tématu domény. |
Základ | GA |
az eventgrid domain topic event-subscription update |
Aktualizace odběru událostí tématu domény |
Základ | GA |
az eventgrid domain topic event-subscription create
Vytvořte nové odběry událostí pro téma domény.
az eventgrid domain topic event-subscription create --domain-name
--domain-topic-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 téma domény Event Gridu pomocí výchozích filtrů.
az eventgrid domain topic event-subscription create --name es1 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Vytvořte nové odběry událostí pro téma domény Event Gridu s filtrem určujícím předponu předmětu.
az eventgrid domain topic event-subscription create --name es4 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Vytvořte nové odběry událostí pro téma domény Event Gridu s použitím výchozích filtrů a CloudEvent V 1.0 jako schématu doručení.
az eventgrid domain topic event-subscription create -n es2 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Vytvořte nové odběry událostí pro téma domény 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 topic event-subscription create --name es2 \
-g rg1 --domain-name domain1 --domain-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"
Vytvořte nové odběry událostí pro téma domény Event Gridu pomocí webhooku s podporou Azure Active Directory jako cíle.
az eventgrid domain topic event-subscription create --name es1 \
-g rg1 --domain-name domain1 --domain-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
Vytvořte nové odběry událostí pro téma domény Event Gridu pomocí funkce Azure Functions jako cíle.
az eventgrid domain topic event-subscription create -n es1 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction
Vytvoření nového odběru událostí pro téma domény Event Gridu pomocí fronty úložiště jako cíle s ttl 5 minut
az eventgrid domain topic event-subscription create -n es1 \
-g rg1 --domain-name domain1 --domain-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
Vytvoření nového odběru událostí pro téma domény Event Gridu a povolení rozšířeného filtrování polí
az eventgrid domain topic event-subscription create -n es1 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 \
--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 tématu 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 topic event-subscription delete
Odstranění odběru událostí tématu domény
az eventgrid domain topic event-subscription delete --domain-name
--domain-topic-name
--name
--resource-group
[--yes]
Příklady
Odstranění odběru událostí pro téma domény Event Gridu
az eventgrid domain topic event-subscription delete --name es1 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 \
Povinné parametry
Název domény.
Název tématu 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 topic event-subscription list
Vypíše odběry událostí konkrétního tématu domény.
az eventgrid domain topic event-subscription list --domain-name
--domain-topic-name
--resource-group
[--odata-query]
Příklady
Zobrazí seznam všech odběrů událostí vytvořených pro téma domény Event Gridu.
az eventgrid domain topic event-subscription list -g rg1 --domain-name domain1 --domain-topic-name topic1
Povinné parametry
Název domény.
Název tématu 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 topic event-subscription show
Získejte podrobnosti o odběru událostí tématu domény.
az eventgrid domain topic event-subscription show --domain-name
--domain-topic-name
--name
--resource-group
[--full-ed-url {false, true}]
[--include-attrib-secret {false, true}]
Příklady
Zobrazí podrobnosti odběru událostí pro téma domény Event Gridu.
az eventgrid domain topic event-subscription show --name es1 \
-g rg1 --domain-name domain1 --domain-topic-name topic1
Zobrazení podrobností odběru událostí pro téma domény Event Gridu zahrnuje všechny tajné kódy atributů statického doručování.
az eventgrid domain topic event-subscription show --name es1 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 --include-attrib-secret
Povinné parametry
Název domény.
Název tématu 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 topic event-subscription update
Aktualizace odběru událostí tématu domény
az eventgrid domain topic event-subscription update --domain-name
--domain-topic-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 téma domény Event Gridu a zadejte nový koncový bod.
az eventgrid domain topic event-subscription update --name es1 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Aktualizujte odběr událostí pro téma domény Event Gridu a zadejte nový filtr končících předmětem.
az eventgrid domain topic event-subscription update --name es2 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 \
--subject-ends-with .jpg
Aktualizace odběru událostí pro téma domény Event Gridu, aby bylo možné zadat nový koncový bod a nový předmět končí filtrem nového seznamu zahrnutých typů událostí.
az eventgrid domain topic event-subscription update --name es3 \
-g rg1 --domain-name domain1 --domain-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
Aktualizujte odběr událostí pro téma domény služby Azure Event Grid tak, aby zahrnoval cíl deadletteru.
az eventgrid domain topic event-subscription update --name es2 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Aktualizujte odběr událostí pro téma domény služby Azure Event Grid pomocí rozšířených filtrů.
az eventgrid domain topic event-subscription update --name es3 \
-g rg1 --domain-name domain1 --domain-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
Aktualizace odběru událostí pro téma domény Event Gridu s využitím fronty úložiště jako cíle s ttl 5 minut
az eventgrid domain topic event-subscription update -n es1 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 \
--storage-queue-msg-ttl 300
Aktualizace odběru událostí pro téma domény Event Gridu s rozšířeným filtrováním u polí s povolenými poli
az eventgrid domain topic event-subscription update -n es1 \
-g rg1 --domain-name domain1 --domain-topic-name topic1 \
--enable-advanced-filtering-on-arrays true
Povinné parametry
Název domény.
Název tématu 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.