az eventgrid partner topic event-subscription

Referencia

Partnertémakör esemény-előfizetéseinek kezelése.

Parancsok

az eventgrid partner topic event-subscription create	Hozzon létre egy új esemény-előfizetést egy partnertémakörhöz.
az eventgrid partner topic event-subscription delete	Partnertémakör esemény-előfizetésének törlése.
az eventgrid partner topic event-subscription list	Egy adott partnertémakör esemény-előfizetéseinek listázása.
az eventgrid partner topic event-subscription show	Egy partnertéma esemény-előfizetésének részleteinek lekérése.
az eventgrid partner topic event-subscription update	Partnertémakör esemény-előfizetésének frissítése.

az eventgrid partner topic event-subscription create

Szerkesztés

Hozzon létre egy új esemény-előfizetést egy partnertémakörhöz.

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éldák

Hozzon létre egy új esemény-előfizetést egy Event Grid-partnertémakörhöz az alapértelmezett szűrőkkel.

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Hozzon létre egy új esemény-előfizetést egy Event Grid-partnertémakörhöz egy tárgyelőtagot meghatározó szűrővel.

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

Hozzon létre egy új esemény-előfizetést egy Event Grid-partnertémakörhöz alapértelmezett szűrőkkel, és a CloudEvent V 1.0-s verziót mint kézbesítési sémát.

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

Hozzon létre egy új esemény-előfizetést egy Event Grid-partnertopichoz, amelynek célhelye holtpont, egyéni újrapróbálkozási szabályzata legfeljebb 10 kézbesítési kísérlet, valamint egy 2 órás eseményTTL (amelyik korábban történik) és lejárati dátum.

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"

Hozzon létre egy új esemény-előfizetést egy Event Grid-partnertémakörhöz az Azure Active Directory-kompatibilis Webhook célként való használatával.

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

Hozzon létre egy új esemény-előfizetést egy Event Grid-partnertémakörhöz, célként az Azure-függvényt használva.

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

Hozzon létre egy új esemény-előfizetést egy Event Grid-partnertémakörhöz a Storage Queue használatával célként, és az üzenetttl 5 percnél

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

Hozzon létre egy új esemény-előfizetést egy Event Grid-partnertémakörhöz, amelyen engedélyezve van a speciális szűrés a tömbökön

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

Kötelező paraméterek

--name -n

Az esemény-előfizetés neve.

--partner-topic-name

A partnertéma neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Opcionális paraméterek

--aad-tenant-id --azure-active-directory-tenant-id

Az Azure Active Directory bérlőazonosítója a hozzáférési jogkivonat lekéréséhez, amely tulajdonosi jogkivonatként szerepel a kézbesítési kérelmekben. Csak a webhookok esetében alkalmazható célhelyként.

--advanced-filter

A speciális szűrő lehetővé teszi az események szűrését egy adott eseménytulajdonság alapján.

--azure-active-directory-application-id-or-uri

Az Azure Active Directory alkalmazásazonosítója vagy URI-ja a hozzáférési jogkivonat lekéréséhez, amely tulajdonosi jogkivonatként szerepel a kézbesítési kérelmekben. Csak a webhookok esetében alkalmazható célhelyként.

--deadletter-endpoint

Egy Azure Storage-blobtároló célhelyének Azure-erőforrás-azonosítója, ahol az EventGridnek törölnie kell az esemény-előfizetés kézbesíthetetlen eseményeit.

--delivery-attribute-mapping

Adjon hozzá kézbesítési attribútumleképezést, hogy további információkat küldjön HTTP-fejléceken keresztül az események kézbesítésekor. Ez az attribútum a StorageQueue kivételével minden céltípusra érvényes. Több attribútum több argumentummal --delivery-attribute-mapping is megadható.

--enable-advanced-filtering-on-arrays --enable-af-arr

Lehetővé teszi a speciális szűrők kiértékelését egy értéktömbben ahelyett, hogy egyes értékeket várnak.

elfogadott értékek: false, true

--endpoint

Végpont, ahol az EventGridnek az esemény-előfizetésnek megfelelő eseményeket kell kézbesítenie. A webhook végponttípusa esetén ennek a megfelelő webhook URL-címnek kell lennie. Más végponttípusok esetén ennek a végpont Azure-erőforrás-azonosítójának kell lennie. Az Event Grid-parancsok végrehajtása előtt a célvégpont várhatóan már létrejön és használható lesz.

--endpoint-type

A célvégpont típusa.

elfogadott értékek: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

alapértelmezett érték: webhook

--event-delivery-schema

Az a séma, amelyben az esemény-előfizetéshez eseményeket kell kézbesíteni. Alapértelmezés szerint az események ugyanabban a sémában lesznek kézbesítve, amelyben közzé vannak téve (a megfelelő témakör bemeneti sémája alapján).

elfogadott értékek: cloudeventschemav1_0, custominputschema, eventgridschema

--event-ttl

Az esemény élettartama (percekben). 1 és 1440 közötti számnak kell lennie.

alapértelmezett érték: 1440

--expiration-date

Dátum vagy dátum (UTC szerint, például "2018-11-30T11:59:59+00:00" vagy "2018-11-30"), amely után az esemény-előfizetés lejár. Alapértelmezés szerint nincs lejárat az esemény-előfizetéshez.

--included-event-types

Eseménytípusok szóközzel elválasztott listája (például Microsoft.Storage.BlobCreated és Microsoft.Storage.BlobDeleted). Az összes alapértelmezett eseménytípusra való feliratkozáshoz ne adjon meg értéket ehhez az argumentumhoz. Eseményrács-témakörök esetén az eseménytípusok ügyfélként vannak meghatározva. Azure-események, például tárfiókok, IoT Hub stb. esetén az "az eventgrid topic-type list-event-types" cli-paranccsal kérdezheti le az eseménytípusokat.

--labels

Az esemény-előfizetéshez társítandó címkék szóközzel elválasztott listája.

--max-delivery-attempts

A kézbesítési kísérletek maximális száma. 1 és 30 közötti számnak kell lennie.

alapértelmezett érték: 30

--max-events-per-batch

Egy kötegben lévő események maximális száma. 1 és 5000 közötti számnak kell lennie.

--preferred-batch-size-in-kilobytes

Előnyben részesített kötegméret kilobájtban. 1 és 1024 közötti számnak kell lennie.

--qttl --storage-queue-msg-ttl

A tárolási várólista üzenetének élettartama másodpercben.

--subject-begins-with

Nem kötelező sztring egy esemény-előfizetés eseményeinek előtag alapján történő szűréséhez. A helyettesítő karakterek nem támogatottak.

--subject-case-sensitive

Adja meg, hogy a tárgymezőket a kis- és nagybetűk megkülönböztetésével kell-e összehasonlítani. Igaz, ha a jelölő jelen van.

elfogadott értékek: false, true

--subject-ends-with

Választható sztring egy esemény-előfizetés eseményeinek utótag alapján történő szűréséhez. A helyettesítő karakterek nem támogatottak.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az eventgrid partner topic event-subscription delete

Szerkesztés

Partnertémakör esemény-előfizetésének törlése.

az eventgrid partner topic event-subscription delete --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--yes]

Példák

Event Grid-partnertémakör esemény-előfizetésének törlése.

az eventgrid partner topic event-subscription delete --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \

Kötelező paraméterek

--name -n

Az esemény-előfizetés neve.

--partner-topic-name

A partnertéma neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Opcionális paraméterek

--yes -y

Ne kérje a megerősítést.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az eventgrid partner topic event-subscription list

Szerkesztés

Egy adott partnertémakör esemény-előfizetéseinek listázása.

az eventgrid partner topic event-subscription list --partner-topic-name
                                                   --resource-group
                                                   [--odata-query]

Példák

Listázhatja az Event Grid-partnertémakörhöz létrehozott összes esemény-előfizetést.

az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1

Kötelező paraméterek

--partner-topic-name

A partnertéma neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Opcionális paraméterek

--odata-query

A listaeredmények szűréséhez használt OData-lekérdezés. A szűrés jelenleg csak a Name tulajdonságon engedélyezett. A támogatott műveletek a következők: CONTAINS, eq (egyenlő), ne (nem egyenlő), AND, VAGY és NEM.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az eventgrid partner topic event-subscription show

Szerkesztés

Egy partnertéma esemény-előfizetésének részleteinek lekérése.

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éldák

Event Grid-partnertémakör esemény-előfizetésének részleteinek megjelenítése.

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1

Event Grid-partnertémakör esemény-előfizetésének részleteinek megjelenítése és statikus kézbesítési attribútum titkos kulcsainak megjelenítése

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1 --include-static-delivery-attribute-secret

Kötelező paraméterek

--name -n

Az esemény-előfizetés neve.

--partner-topic-name

A partnertéma neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Opcionális paraméterek

--include-attrib-secret --include-static-delivery-attribute-secret

Jelzi, hogy a rendszer statikus kézbesítési attribútum titkos kódokat ad-e vissza. Igaz, ha a jelölő jelen van.

elfogadott értékek: false, true

--include-full-endpoint-url

Adja meg, hogy a rendszer a teljes végpont URL-címét adja-e vissza. Igaz, ha a jelölő jelen van.

elfogadott értékek: false, true

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az eventgrid partner topic event-subscription update

Szerkesztés

Partnertémakör esemény-előfizetésének frissítése.

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éldák

Egy Event Grid-partnertémakör esemény-előfizetésének frissítése új végpont megadásához.

az eventgrid partner topic event-subscription update --name es1 \
    -g rg1 --partner-topic-name partnertopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Egy Event Grid-partnertémakör esemény-előfizetésének frissítése egy új, szűrővel ellátott tárgyvégzéssel.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .jpg

Frissítsen egy Event Grid-partnertémakör esemény-előfizetését egy új végpont és egy új tárgyvégpont megadásához a belefoglalt eseménytípusok új listájának szűrésével.

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

Frissítsen egy esemény-előfizetést egy Azure Event Grid partnertémakörhöz, hogy tartalmazza a holtpont célhelyét.

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

Speciális szűrőkkel frissítheti egy Azure Event Grid partnertémakör esemény-előfizetését.

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

Event Grid-partnertémakör esemény-előfizetésének frissítése a Storage Queue használatával célként az üzenetttl 5 perces élettartamával

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

Event Grid-partnertémakör esemény-előfizetésének frissítése a tömbök speciális szűrésének engedélyezésével

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

Kötelező paraméterek

--name -n

Az esemény-előfizetés neve.

--partner-topic-name

A partnertéma neve.

--resource-group -g

Az erőforráscsoport neve. Az alapértelmezett csoportot a következővel az configure --defaults group=<name>konfigurálhatja: .

Opcionális paraméterek

--advanced-filter

A speciális szűrő lehetővé teszi az események szűrését egy adott eseménytulajdonság alapján.

--deadletter-endpoint

Egy Azure Storage-blobtároló célhelyének Azure-erőforrás-azonosítója, ahol az EventGridnek törölnie kell az esemény-előfizetés kézbesíthetetlen eseményeit.

--delivery-attribute-mapping

--enable-advanced-filtering-on-arrays --enable-af-arr

Lehetővé teszi a speciális szűrők kiértékelését egy értéktömbben ahelyett, hogy egyes értékeket várnak.

elfogadott értékek: false, true

--endpoint

--endpoint-type

A célvégpont típusa.

elfogadott értékek: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

alapértelmezett érték: webhook

--included-event-types

--labels

Az esemény-előfizetéshez társítandó címkék szóközzel elválasztott listája.

--qttl --storage-queue-msg-ttl

A tárolási várólista üzenetének élettartama másodpercben.

--subject-begins-with

Nem kötelező sztring egy esemény-előfizetés eseményeinek előtag alapján történő szűréséhez. A helyettesítő karakterek nem támogatottak.

--subject-ends-with

Választható sztring egy esemény-előfizetés eseményeinek utótag alapján történő szűréséhez. A helyettesítő karakterek nem támogatottak.

Globális paraméterek

--debug

Növelje a naplózás részletességét az összes hibakeresési napló megjelenítéséhez.

--help -h

Jelenítse meg ezt a súgóüzenetet, és lépjen ki.

--only-show-errors

Csak a hibák megjelenítése, a figyelmeztetések mellőzése.

--output -o

Kimeneti formátum.

--query

JMESPath lekérdezési sztring. További információkért és példákért lásd http://jmespath.org/ .

--subscription

Az előfizetés neve vagy azonosítója. Az alapértelmezett előfizetést a következővel az account set -s NAME_OR_IDkonfigurálhatja: .

--verbose

A naplózás részletességének növelése. Használja a --debug parancsot a teljes hibakeresési naplókhoz.

az eventgrid partner topic event-subscription

Parancsok

az eventgrid partner topic event-subscription create

Példák

Kötelező paraméterek

Opcionális paraméterek

az eventgrid partner topic event-subscription delete

Példák

Kötelező paraméterek

Opcionális paraméterek

az eventgrid partner topic event-subscription list

Példák

Kötelező paraméterek

Opcionális paraméterek

az eventgrid partner topic event-subscription show

Példák

Kötelező paraméterek

Opcionális paraméterek

az eventgrid partner topic event-subscription update

Példák

Kötelező paraméterek

Opcionális paraméterek

Visszajelzés