az eventgrid partner topic event-subscription
Správa odběrů událostí partnerského tématu
Příkazy
Name | Description | Typ | Stav |
---|---|---|---|
az eventgrid partner topic event-subscription create |
Vytvořte nové odběry událostí pro téma partnera. |
Jádro | GHANŠTINA |
az eventgrid partner topic event-subscription delete |
Odstranění odběru událostí tématu partnera |
Jádro | GHANŠTINA |
az eventgrid partner topic event-subscription list |
Vypíše odběry událostí konkrétního tématu partnera. |
Jádro | GHANŠTINA |
az eventgrid partner topic event-subscription show |
Získejte podrobnosti o odběru událostí tématu partnera. |
Jádro | GHANŠTINA |
az eventgrid partner topic event-subscription update |
Aktualizace odběru událostí tématu partnera |
Jádro | GHANŠTINA |
az eventgrid partner topic event-subscription create
Vytvořte nové odběry událostí pro téma partnera.
az eventgrid partner topic event-subscription create --name
--partner-topic-name
--resource-group
[--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 téma partnera event Gridu pomocí výchozích filtrů.
az eventgrid partner topic event-subscription create --name es1 \
-g rg1 --partner-topic-name partnertopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Vytvořte nové odběry událostí pro téma partnera event Gridu s filtrem určujícím předponu předmětu.
az eventgrid partner topic event-subscription create --name es4 \
-g rg1 --partner-topic-name partnertopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Vytvořte nové odběry událostí pro téma partnera event Gridu s použitím výchozích filtrů a CloudEvent V 1.0 jako schématu doručení.
az eventgrid partner topic event-subscription create -n es2 \
-g rg1 --partner-topic-name partnertopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Vytvořte nové odběry událostí pro partnerskou lokalitu služby Event Grid 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 partner topic event-subscription create --name es2 \
-g rg1 --partner-topic-name partnertopic1 \
--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 partnera event Gridu pomocí webhooku s podporou Azure Active Directory jako cíle .
az eventgrid partner topic event-subscription create --name es1 \
-g rg1 --partner-topic-name partnertopic1 \
--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 partnera event Gridu pomocí funkce Azure Functions jako cíle.
az eventgrid partner topic event-subscription create -n es1 \
-g rg1 --partner-topic-name partnertopic1 \
--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 partnera event Gridu s využitím fronty úložiště jako cíle se zprávou ttl během 5 minut
az eventgrid partner topic event-subscription create -n es1 \
-g rg1 --partner-topic-name partnertopic1 \
--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 partnerské téma event Gridu s rozšířeným filtrováním polí s povolenými poli
az eventgrid partner topic event-subscription create -n es1 \
-g rg1 --partner-topic-name partnertopic1 \
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--enable-advanced-filtering-on-arrays true
Povinné parametry
Název odběru události.
Název tématu partnera
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
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 partner topic event-subscription delete
Odstranění odběru událostí tématu partnera
az eventgrid partner topic event-subscription delete --name
--partner-topic-name
--resource-group
[--yes]
Příklady
Odstranění odběru událostí pro téma partnera event Gridu
az eventgrid partner topic event-subscription delete --name es1 \
-g rg1 --partner-topic-name partnertopic1 \
Povinné parametry
Název odběru události.
Název tématu partnera
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ší 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 partner topic event-subscription list
Vypíše odběry událostí konkrétního tématu partnera.
az eventgrid partner topic event-subscription list --partner-topic-name
--resource-group
[--odata-query]
Příklady
Zobrazí seznam všech odběrů událostí vytvořených pro téma partnera event Gridu.
az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1
Povinné parametry
Název tématu partnera
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ší 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 partner topic event-subscription show
Získejte podrobnosti o odběru událostí tématu partnera.
az eventgrid partner topic event-subscription show --name
--partner-topic-name
--resource-group
[--include-attrib-secret {false, true}]
[--include-full-endpoint-url {false, true}]
Příklady
Zobrazí podrobnosti odběru událostí pro téma partnera event Gridu.
az eventgrid partner topic event-subscription show --name es1 \
-g rg1 --partner-topic-name partnertopic1
Zobrazení podrobností odběru událostí pro téma partnera event Gridu a zahrnutí tajných kódů atributů statického doručování
az eventgrid partner topic event-subscription show --name es1 \
-g rg1 --partner-topic-name partnertopic1 --include-static-delivery-attribute-secret
Povinné parametry
Název odběru události.
Název tématu partnera
Název skupiny prostředků Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>
.
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 partner topic event-subscription update
Aktualizace odběru událostí tématu partnera
az eventgrid partner topic event-subscription update --name
--partner-topic-name
--resource-group
[--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 partnera event Gridu a zadejte nový koncový bod.
az eventgrid partner topic event-subscription update --name es1 \
-g rg1 --partner-topic-name partnertopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Aktualizace odběru událostí pro téma partnera event Gridu, aby bylo možné zadat nový filtr končících předmětem.
az eventgrid partner topic event-subscription update --name es2 \
-g rg1 --partner-topic-name partnertopic1 \
--subject-ends-with .jpg
Aktualizujte odběr událostí pro téma partnera 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 partner topic event-subscription update --name es3 \
-g rg1 --partner-topic-name partnertopic1 \
--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 partnera služby Azure Event Grid tak, aby zahrnoval cíl deadletteru.
az eventgrid partner topic event-subscription update --name es2 \
-g rg1 --partner-topic-name partnertopic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Aktualizace odběru událostí pro téma partnera azure Event Gridu pomocí rozšířených filtrů
az eventgrid partner topic event-subscription update --name es3 \
-g rg1 --partner-topic-name partnertopic1 \
--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 partnera služby Event Grid s využitím fronty úložiště jako cíle se zprávou ttl v 5 minutách
az eventgrid partner topic event-subscription update -n es1 \
-g rg1 --partner-topic-name partnertopic1 \
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--storage-queue-msg-ttl 300
Aktualizace odběru událostí pro téma partnera event Gridu s rozšířeným filtrováním polí
az eventgrid partner topic event-subscription update -n es1 \
-g rg1 --partner-topic-name partnertopic1 \
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--enable-advanced-filtering-on-arrays true
Povinné parametry
Název odběru události.
Název tématu partnera
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 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.