az eventgrid system-topic event-subscription
Správa odběrů událostí systémového tématu
Příkazy
Name | Description | Typ | Stav |
---|---|---|---|
az eventgrid system-topic event-subscription create |
Vytvořte nové odběry událostí pro systémové téma. |
Jádro | GHANŠTINA |
az eventgrid system-topic event-subscription delete |
Odstranění odběru událostí systémového tématu |
Jádro | GHANŠTINA |
az eventgrid system-topic event-subscription list |
Vypíše odběry událostí konkrétního systémového tématu. |
Jádro | GHANŠTINA |
az eventgrid system-topic event-subscription show |
Získejte podrobnosti o odběru událostí systémového tématu. |
Jádro | GHANŠTINA |
az eventgrid system-topic event-subscription update |
Aktualizace odběru událostí systémového tématu |
Jádro | GHANŠTINA |
az eventgrid system-topic event-subscription create
Vytvořte nové odběry událostí pro systémové téma.
az eventgrid system-topic event-subscription create --name
--resource-group
--system-topic-name
[--aad-tenant-id]
[--advanced-filter]
[--azure-active-directory-application-id-or-uri]
[--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]
Příklady
Vytvořte nové odběry událostí pro systémové téma event Gridu pomocí výchozích filtrů.
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Vytvořte nové odběry událostí pro systémové téma event Gridu s filtrem určujícím předponu předmětu.
az eventgrid system-topic event-subscription create --name es4 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Vytvořte nové odběry událostí pro systémové téma event Gridu s použitím výchozích filtrů a CloudEvent V 1.0 jako schématu doručení.
az eventgrid system-topic event-subscription create -n es2 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Vytvořte nové odběry událostí pro systémové téma 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 system-topic event-subscription create --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--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 systémové téma event Gridu pomocí webhooku s podporou Azure Active Directory jako cíle .
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--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 systému Event Grid pomocí funkce Azure Functions jako cíle.
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction
Vytvoření nového odběru událostí pro systémové téma event Gridu pomocí fronty úložiště jako cíle s ttl 5 minut
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--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 systémové téma event Gridu a povolení rozšířeného filtrování polí
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--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 odběru události.
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Název systémového tématu.
Volitelné parametry
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 argumentu --advanced-filter
.
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 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ší informace a příklady najdete v http://jmespath.org/.
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 system-topic event-subscription delete
Odstranění odběru událostí systémového tématu
az eventgrid system-topic event-subscription delete --name
--resource-group
--system-topic-name
[--yes]
Příklady
Odstranění odběru událostí pro systémové téma event Gridu
az eventgrid system-topic event-subscription delete --name es1 \
-g rg1 --system-topic-name systemtopic1 \
Povinné parametry
Název odběru události.
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Název systémového tématu.
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ší informace a příklady najdete v http://jmespath.org/.
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 system-topic event-subscription list
Vypíše odběry událostí konkrétního systémového tématu.
az eventgrid system-topic event-subscription list --resource-group
--system-topic-name
[--odata-query]
Příklady
Zobrazí seznam všech odběrů událostí vytvořených pro systémové téma event Gridu.
az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1
Povinné parametry
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Název systémového tématu.
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ší informace a příklady najdete v http://jmespath.org/.
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 system-topic event-subscription show
Získejte podrobnosti o odběru událostí systémového tématu.
az eventgrid system-topic event-subscription show --name
--resource-group
--system-topic-name
[--include-attrib-secret {false, true}]
[--include-full-endpoint-url {false, true}]
Příklady
Zobrazí podrobnosti odběru událostí pro systémové téma event Gridu.
az eventgrid system-topic event-subscription show --name es1 \
-g rg1 --system-topic-name systemtopic1
Zobrazení podrobností odběru událostí pro systémové téma event Gridu zahrnuje všechny tajné kódy atributů statického doručování.
az eventgrid system-topic event-subscription show --name es1 \
-g rg1 --system-topic-name systemtopic1 --include-attrib-secret
Povinné parametry
Název odběru události.
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Název systémového tématu.
Volitelné parametry
Určete, jestli se mají vrátit nějaké tajné kódy atributů statického doručení. True if flag present.
Zadejte, zda má být vrácena úplná adresa URL koncového bodu. 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ší informace a příklady najdete v http://jmespath.org/.
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 system-topic event-subscription update
Aktualizace odběru událostí systémového tématu
az eventgrid system-topic event-subscription update --name
--resource-group
--system-topic-name
[--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]
Příklady
Aktualizujte odběr událostí pro téma systému Event Grid a zadejte nový koncový bod.
az eventgrid system-topic event-subscription update --name es1 \
-g rg1 --system-topic-name systemtopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Aktualizujte odběr událostí pro systémové téma event Gridu a určete nový filtr končících předmětem.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .jpg
Aktualizujte odběr událostí pro systémové téma 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 system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--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 systémové téma služby Azure Event Grid tak, aby zahrnovalo cíl deadletteru.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Aktualizace odběru událostí pro systémové téma služby Azure Event Grid pomocí rozšířených filtrů
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--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 systémové téma event Gridu s využitím fronty úložiště jako cíle s ttl 5 minut
az eventgrid system-topic event-subscription update -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--storage-queue-msg-ttl 300
Aktualizace odběru událostí pro systémové téma event Gridu s rozšířeným filtrováním polí
az eventgrid system-topic event-subscription update -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--enable-advanced-filtering-on-arrays true
Povinné parametry
Název odběru události.
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
Název systémového tématu.
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 argumentu --advanced-filter
.
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í.
Typ cílového koncového bodu.
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.
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ší informace a příklady najdete v http://jmespath.org/.
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.