az eventgrid event-subscription

Esemény-előfizetések kezelése.

Event Grid-témakör, tartomány, tartományi témakör, Azure-előfizetés, erőforráscsoport vagy bármely más, eseményértesítéseket támogató Azure-erőforrás esemény-előfizetéseinek kezelése.

Parancsok

az eventgrid event-subscription create

Hozzon létre egy új esemény-előfizetést.

az eventgrid event-subscription delete

Esemény-előfizetés törlése.

az eventgrid event-subscription list

Esemény-előfizetések listázása.

az eventgrid event-subscription show

Lekérheti egy esemény-előfizetés adatait.

az eventgrid event-subscription update

Esemény-előfizetés frissítése.

az eventgrid event-subscription create

Hozzon létre egy új esemény-előfizetést.

az eventgrid event-subscription create --name
                                       [--aad-tenant-id]
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--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]
                                       [--source-resource-id]
                                       [--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-témakörhöz az alapértelmezett szűrők használatával.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Hozzon létre egy új esemény-előfizetést egy Azure-előfizetéshez az alapértelmezett szűrők használatával.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Hozzon létre egy új esemény-előfizetést egy erőforráscsoporthoz az alapértelmezett szűrők használatával.

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Hozzon létre egy új esemény-előfizetést egy tárfiókhoz az alapértelmezett szűrők használatával.

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Hozzon létre egy új esemény-előfizetést egy tárfiókhoz speciális szűrők használatával.

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

Hozzon létre egy új esemény-előfizetést egy Azure-előfizetéshez egy tárgyelőtagot megadva egy szűrővel.

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --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 erőforráscsoporthoz egy szűrővel, amely a tárgy utótagját adja meg.

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

Hozzon létre egy új esemény-előfizetést egy Azure-előfizetéshez alapértelmezett szűrőkkel, és célként egy EventHubot.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

Hozzon létre egy új esemény-előfizetést egy Azure-előfizetéshez alapértelmezett szűrőkkel, és célként egy Azure Storage-üzenetsort.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

Hozzon létre egy új esemény-előfizetést egy Azure-előfizetéshez alapértelmezett szűrőkkel, és célként egy Azure ServiceBusQueue-t.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --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 tárfiókhoz, ahol a holtpont célhelye és az egyéni újrapróbálkozási szabályzat legfeljebb 10 kézbesítési kísérletből és egy 2 órás eseményTTL-ből áll (amelyik korábban történik).

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

Hozzon létre egy új esemény-előfizetést egy tartományi témakörhöz.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Hozzon létre egy új esemény-előfizetést (egy tárfiókhoz) lejárati dátummal.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

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

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --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-témakörhöz, célként az Azure-függvényt használva.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --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-témakörhöz az EventHub használatával, célként a rendszer által hozzárendelt MSI-identitással és az MSI-identitással rendelkező holtleíróval

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

Hozzon létre egy új esemény-előfizetést egy Event Grid-témakörhöz a Storage-üzenetsor célhelyként való használatával, 5 perces üzenetttl-üzenettel

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --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 Event Grid-témakörhöz a StorageQueue használatával, célként a rendszer által hozzárendelt MSI-identitással

az eventgrid event-subscription create -n {EventSubscriptionName} --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type StorageQueue --delivery-identity systemassigned --delivery-identity-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-témakörhöz, amelyen engedélyezve van a speciális szűrés a tömbökön

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --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.

Opcionális paraméterek

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

Az Azure Active Directory-bérlőazonosító a kézbesítési kérelmek tulajdonosi jogkivonataként szereplő hozzáférési jogkivonat lekéréséhez. Csak a webhookok esetében alkalmazható célhelyként.

--advanced-filter

A speciális szűrők lehetővé teszik 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, amely lekéri azt a hozzáférési jogkivonatot, amely tulajdonosi jogkivonatként szerepel majd 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 kézbesíthetetlen eseményeket kell tárolnia ehhez az esemény-előfizetéshez.

--deadletter-identity

A holtleíró célerőforrás identitástípusa.

elfogadott értékek: systemassigned
--deadletter-identity-endpoint

Egy Azure Storage-blobtároló célhelyének Azure-erőforrás-azonosítója olyan identitással, ahol az EventGridnek kézbesíthetetlen eseményeket kell tárolnia ehhez az esemény-előfizetéshez.

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

--delivery-identity

A kézbesítési cél erőforrás identitástípusa (például tárolási üzenetsor vagy eventhub).

elfogadott értékek: systemassigned
--delivery-identity-endpoint

Identitással rendelkező végpont, ahol az EventGridnek az esemény-előfizetésnek megfelelő eseményeket kell továbbítania. A webhook végponttípusának 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.

--delivery-identity-endpoint-type

A célvégpont típusa erőforrás-identitással.

elfogadott értékek: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Lehetővé teszi a speciális szűrők kiértékelését értékek tömbje alapján ahelyett, hogy egyetlen értéket várnak.

elfogadott értékek: false, true
--endpoint

Végpont, ahol az EventGridnek ennek az esemény-előfizetésnek megfelelő eseményeket kell kézbesítenie. A webhook végponttípusának 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.

alapértelmezett érték: webhook
--event-delivery-schema

Az a séma, amelyben eseményeket kell kézbesíteni ehhez az esemény-előfizetéshez. 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 élettartamának ideje (percekben). 1 és 1440 közötti számnak kell lennie.

alapértelmezett érték: 1440
--expiration-date

Dátum vagy dátum (UTC, 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. Az Event Grid-témakörökben az eseménytípusok az ügyfél által definiáltak. Azure-események, például tárfiókok, IoT Hub stb. esetében 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öteg eseményeinek 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 Storage-üzenetsor üzenetének élettartama másodpercben.

--source-resource-id

Annak az Azure-erőforrásnak a teljes azonosítója, amelyhez létre kell hozni az esemény-előfizetést.

--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 event-subscription delete

Esemény-előfizetés törlése.

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Példák

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

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

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

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Event Grid-tartomány esemény-előfizetésének törlése.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Egy Azure-előfizetés esemény-előfizetésének törlése.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

Egy erőforráscsoport esemény-előfizetésének törlése.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Egy tárfiók esemény-előfizetésének törlése.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

Kötelező paraméterek

--name -n

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

Opcionális paraméterek

--source-resource-id

Annak az Azure-erőforrásnak a teljes azonosítója, amelynek esemény-előfizetését törölni kell.

az eventgrid event-subscription list

Esemény-előfizetések listázása.

Az Event Grid regionális és globális esemény-előfizetéseket is támogat: a regionális erőforrásokon (például tárfiókokon vagy Event Grid-témakörökön) futó esemény-előfizetések regionálisak, míg a globális erőforrásokon (például egy Azure-előfizetésen vagy erőforráscsoporton) futó esemény-előfizetések globálisak. Ezért az esemény-előfizetéseket többféleképpen is listázhatja:

  1. Ha annak az erőforrásnak az erőforrás-azonosítója alapján szeretné listázni az esemény-előfizetéseket, adja meg a --source-resource-id paramétert. Nincs más paraméter megadva.
  2. Témakörtípus (például tárfiókok) szerinti listázáshoz adja meg a --topic-type paramétert és a --location (pl. "westus2") paramétert. Globális témakörtípusok (például "Microsoft.Resources.Subscriptions" esetén) adja meg a hely értékét "globálisként".
  3. Egy régió összes esemény-előfizetésének listázásához (az összes témakörtípusra kiterjedően) csak a --location paramétert adja meg.
  4. A fenti 2. és a 3. szám esetében is megadható a --resource-group paraméter, ha csak egy erőforráscsoport alapján szeretne szűrni.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Példák

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

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

A tárfiókhoz létrehozott összes esemény-előfizetés listázása.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

Az Azure-előfizetéshez létrehozott összes esemény-előfizetés listázása.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

Az erőforráscsoporthoz létrehozott összes esemény-előfizetés listázása.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Egy Event Grid-tartomány összes esemény-előfizetésének listázása.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

Egy Event Grid-tartományi témakör összes esemény-előfizetésének listázása.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Listázzon minden Storage-esemény-előfizetést (a jelenleg kiválasztott Azure-előfizetés alatt) a westus2-ben.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Listázzon minden Storage-esemény-előfizetést (az adott erőforráscsoport alatt) a westus2-ben.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Listázhatja az összes regionális vagy globális esemény-előfizetést (az aktuálisan kiválasztott Azure-előfizetés alatt).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

Listázhatja egy adott erőforráscsoport összes regionális vagy globális esemény-előfizetését.

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

Listázz minden esemény-előfizetést egy Event Grid-tartományhoz, amelynek a neve az "XYZ" mintát tartalmazza

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Egy Event Grid-tartomány összes esemény-előfizetésének listázása, kivéve a "name1" nevű esemény-előfizetést

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

Opcionális paraméterek

--location -l

Tartózkodási hely beállításnál. Értékek innen: az account list-locations. Az alapértelmezett helyet a használatával az configure --defaults location=<location>konfigurálhatja.

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

--resource-group -g

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

--source-resource-id

Annak az Azure-erőforrásnak a teljes azonosítója, amelynek esemény-előfizetését fel kell sorolni.

--topic-type-name

Annak a témakörtípusnak a neve, amelynek esemény-előfizetéseit fel kell sorolni. Ha ez meg van adva, meg kell adnia a --location értéket is.

az eventgrid event-subscription show

Az esemény-előfizetés részleteinek lekérése.

az eventgrid event-subscription show --name
                                     [--include-attrib-secret {false, true}]
                                     [--include-full-endpoint-url {false, true}]
                                     [--source-resource-id]

Példák

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

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

Egy Azure-előfizetés esemény-előfizetésének részleteinek megjelenítése.

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

Egy erőforráscsoport esemény-előfizetésének részleteinek megjelenítése.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

Tárfiók esemény-előfizetésének részleteinek megjelenítése.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

Megjelenítheti egy erőforráscsoport esemény-előfizetésének részleteit, beleértve a statikus kézbesítési attribútum titkos kulcsait is.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 \
    --include-static-delivery-attribute-secret

Kötelező paraméterek

--name -n

Az esemény-előfizetés 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
--source-resource-id

Annak az Azure-erőforrásnak a teljes azonosítója, amelynek esemény-előfizetését meg kell jeleníteni.

az eventgrid event-subscription update

Esemény-előfizetés frissítése.

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Példák

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

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Frissítsen egy Azure-előfizetés esemény-előfizetését egy új, szűrővel rendelkező tárgyvégzésére.

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

Frissítsen egy erőforráscsoport esemény-előfizetését egy új végpont és egy új, szűrővel rendelkező tárgyvégpont megadásához.

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

A tárfiók esemény-előfizetésének frissítése a belefoglalt eseménytípusok új listájának megadásához.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Frissítsen egy tárfiók esemény-előfizetését, hogy tartalmazza a holtpont célhelyét.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Speciális szűrőkkel frissítheti egy tárfiók esemény-előfizetését.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

Frissítsen egy tárfiók esemény-előfizetését úgy, hogy az 5 percre beállított üzenetttl-ttl-et is tartalmazza.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --storage-queue-msg-ttl 300

Esemény-előfizetés frissítése a tömbökön engedélyezett speciális szűréssel

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --enable-advanced-filtering-on-arrays true

Kötelező paraméterek

--name -n

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

Opcionális paraméterek

--add

Adjon hozzá egy objektumot az objektumok listájához egy elérési út és egy kulcsértékpár megadásával. Példa: --add property.listProperty <key=value, string vagy JSON string>.

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

--deadletter-identity

A holtleíró célerőforrás identitástípusa.

elfogadott értékek: systemassigned
--deadletter-identity-endpoint

Egy Azure Storage-blobtároló célhelyének Azure-erőforrás-azonosítója identitással, 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ó.

--delivery-identity

A kézbesítési cél erőforrás identitástípusa (például tárolási üzenetsor vagy eventhub).

elfogadott értékek: systemassigned
--delivery-identity-endpoint

Olyan identitással rendelkező 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.

--delivery-identity-endpoint-type

A célvégpont típusa erőforrás-identitással.

elfogadott értékek: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--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.

alapértelmezett érték: webhook
--force-string

A "set" vagy a "add" használatakor a JSON-ra való konvertálás helyett őrizze meg a sztringkonstansokat.

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

--remove

Tulajdonság vagy elem eltávolítása egy listából. Példa: --remove property.list OR --remove propertyToRemove.

--set

Objektum frissítése a beállítandó tulajdonság elérési útjának és értékének megadásával. Példa: --set property1.property2=.

--source-resource-id

Annak az Azure-erőforrásnak a teljes azonosítója, amelynek az esemény-előfizetését frissíteni kell.

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