Visszajelzés

az eventgrid system-topic event-subscription

  • Referencia

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

Parancsok

az eventgrid system-topic event-subscription create

Hozzon létre egy új esemény-előfizetést egy rendszertémakörhöz.
az eventgrid system-topic event-subscription delete

Rendszertémakör esemény-előfizetésének törlése.
az eventgrid system-topic event-subscription list

Egy adott rendszertémakör esemény-előfizetéseinek listázása.
az eventgrid system-topic event-subscription show

Egy rendszertémakör esemény-előfizetésének részleteinek lekérése.
az eventgrid system-topic event-subscription update

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

az eventgrid system-topic event-subscription create

Szerkesztés

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

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

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

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

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

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

Hozzon létre egy új esemény-előfizetést egy Event Grid-rendszerté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 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

Hozzon létre egy új esemény-előfizetést egy Event Grid-rendszertémakörhöz, amelynek célhelye és 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 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"

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

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

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

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

Hozzon létre egy új esemény-előfizetést egy Event Grid-rendszertémakörhöz a Storage Queue használatával célként 5 perces élettartammal

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

Új esemény-előfizetés létrehozása egy Event Grid-rendszertémakörhöz, és speciális szűrés engedélyezése tömbökön

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

Kötelező paraméterek

--name -n

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

--resource-group -g

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

--system-topic-name

A rendszertémakör neve.

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.

az eventgrid system-topic event-subscription delete

Szerkesztés

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

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

Példák

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

az eventgrid system-topic event-subscription delete --name es1 \
    -g rg1 --system-topic-name systemtopic1 \

Kötelező paraméterek

--name -n

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

--resource-group -g

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

--system-topic-name

A rendszertémakör neve.

Opcionális paraméterek

--yes -y

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

az eventgrid system-topic event-subscription list

Szerkesztés

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

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

Példák

Az Event Grid-rendszer témaköréhez létrehozott összes esemény-előfizetés listázása.

az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1

Kötelező paraméterek

--resource-group -g

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

--system-topic-name

A rendszertémakör neve.

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.

az eventgrid system-topic event-subscription show

Szerkesztés

Egy rendszertémakör esemény-előfizetésének részleteinek lekérése.

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

Az Event Grid-rendszer témaköréhez tartozó esemény-előfizetés részleteinek megjelenítése.

az eventgrid system-topic event-subscription show --name es1 \
     -g rg1 --system-topic-name systemtopic1

Az Event Grid-rendszer témaköréhez tartozó esemény-előfizetés részleteinek megjelenítése a statikus kézbesítési attribútum titkos kulcsait is tartalmazza.

az eventgrid system-topic event-subscription show --name es1 \
     -g rg1 --system-topic-name systemtopic1 --include-attrib-secret

Kötelező paraméterek

--name -n

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

--resource-group -g

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

--system-topic-name

A rendszertémakör neve.

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

az eventgrid system-topic event-subscription update

Szerkesztés

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

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

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

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

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

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

Egy Event Grid-rendszertémakör esemény-előfizetésének frissítése 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 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

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

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

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

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

Event Grid-rendszertémakör esemény-előfizetésének frissítése tárolási üzenetsorsal célként 5 perces élettartammal

az eventgrid system-topic event-subscription update -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --storage-queue-msg-ttl 300

Event Grid-rendszerté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 system-topic event-subscription update -n es1 \
    -g rg1 --system-topic-name systemtopic1 \
    --enable-advanced-filtering-on-arrays true

Kötelező paraméterek

--name -n

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

--resource-group -g

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

--system-topic-name

A rendszertémakör neve.

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

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
--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.

--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.