Dela via


az eventgrid event-subscription

Kommentar

Den här kommandogruppen har kommandon som definieras i både Azure CLI och minst ett tillägg. Installera varje tillägg för att dra nytta av dess utökade funktioner. Läs mer om tillägg.

Hantera händelseprenumerationer.

Hantera händelseprenumerationer för ett Event Grid-ämne, domän, domänämne, Azure-prenumeration, resursgrupp eller för andra Azure-resurser som stöder händelsemeddelanden.

Kommandon

Name Description Typ Status
az eventgrid event-subscription create

Skapa en ny händelseprenumeration.

Kärna Allmän tillgänglighet
az eventgrid event-subscription create (eventgrid anknytning)

Skapa en ny händelseprenumeration.

Anknytning Förhandsgranska
az eventgrid event-subscription delete

Ta bort en händelseprenumeration.

Kärna Allmän tillgänglighet
az eventgrid event-subscription delete (eventgrid anknytning)

Ta bort en händelseprenumeration.

Anknytning Förhandsgranska
az eventgrid event-subscription list

Lista händelseprenumerationer.

Kärna Allmän tillgänglighet
az eventgrid event-subscription list (eventgrid anknytning)

Lista händelseprenumerationer.

Anknytning Förhandsgranska
az eventgrid event-subscription show

Hämta information om en händelseprenumeration.

Kärna Allmän tillgänglighet
az eventgrid event-subscription show (eventgrid anknytning)

Hämta information om en händelseprenumeration.

Anknytning Förhandsgranska
az eventgrid event-subscription update

Uppdatera en händelseprenumeration.

Kärna Allmän tillgänglighet
az eventgrid event-subscription update (eventgrid anknytning)

Uppdatera en händelseprenumeration.

Anknytning Förhandsgranska

az eventgrid event-subscription create

Skapa en ny händelseprenumeration.

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]

Exempel

Skapa en ny händelseprenumeration för ett Event Grid-ämne med hjälp av standardfilter.

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

Skapa en ny händelseprenumeration för en Azure-prenumeration med hjälp av standardfilter.

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

Skapa en ny händelseprenumeration för en resursgrupp med hjälp av standardfilter.

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

Skapa en ny händelseprenumeration för ett lagringskonto med hjälp av standardfilter.

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

Skapa en ny händelseprenumeration för ett lagringskonto med hjälp av avancerade filter.

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

Skapa en ny händelseprenumeration för en Azure-prenumeration med ett filter som anger ett ämnesprefix.

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

Skapa en ny händelseprenumeration för en resursgrupp med ett filter som anger ett ämnessuffix.

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

Skapa en ny händelseprenumeration för en Azure-prenumeration med standardfilter och en EventHub som mål.

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

Skapa en ny händelseprenumeration för en Azure-prenumeration med standardfilter och en Azure Storage-kö som mål.

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

Skapa en ny händelseprenumeration för en Azure-prenumeration med standardfilter och en Azure ServiceBusQueue som mål.

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

Skapa en ny händelseprenumeration för en Event Grid-domän med standardfilter och CloudEvent V 1.0 som leveransschema.

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

Skapa en ny händelseprenumeration för ett lagringskonto med ett deadletter-mål och en anpassad återförsöksprincip på högst 10 leveransförsök och en händelse-TTL på 2 timmar (beroende på vilket som inträffar tidigare).

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

Skapa en ny händelseprenumeration för ett domänämne.

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

Skapa en ny händelseprenumeration (för ett lagringskonto) med ett förfallodatum.

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"

Skapa en ny händelseprenumeration för ett Event Grid-ämne med Azure Active Directory-aktiverad Webhook som mål .

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

Skapa en ny händelseprenumeration för ett Event Grid-ämne med Azure Function som mål.

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

Skapa en ny händelseprenumeration för ett Event Grid-ämne med Eventhub med systemtilldelad MSI-identitet som mål och med deadletter med MSI-identitet

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}

Skapa en ny händelseprenumeration för ett Event Grid-ämne med lagringskö som mål med meddelande-ttl i 5 minuter

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

Skapa en ny händelseprenumeration för ett Event Grid-ämne med StorageQueue med systemtilldelad MSI-identitet som mål

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

Skapa en ny händelseprenumeration för ett Event Grid-ämne med avancerad filtrering aktiverad på matriser

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

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

Valfria parametrar

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

Azure Active Directory-klient-ID:t för att hämta åtkomsttoken som ska inkluderas som ägartoken i leveransbegäranden. Gäller endast för webhook som mål.

--advanced-filter

Ett avancerat filter möjliggör filtrering av händelser baserat på en specifik händelseegenskap.

Användning: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-VÄRDE [VÄRDE ...] StringIn: --advanced-filter data. FärgsträngI blå röd orange gul stringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg 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 NumberNotInRange 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 BoolEqual sant IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Flera avancerade filter kan anges med fler än ett --advanced-filter argument.

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

Azure Active Directory-program-ID eller URI för att hämta åtkomsttoken som ska inkluderas som ägartoken i leveransbegäranden. Gäller endast för webhook som mål.

--deadletter-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål där EventGrid bör döda händelser som inte kan levereras för den här händelseprenumerationen.

Exempel: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--deadletter-identity
Förhandsgranskning

Identitetstypen för målresursen deadletter.

Godkända värden: systemassigned
--deadletter-identity-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål med identitet där EventGrid ska döda händelser som inte kan levereras för den här händelseprenumerationen.

--delivery-attribute-mapping

Lägg till leveransattributmappning för att skicka ytterligare information via HTTP-huvuden när händelser levereras. Det här attributet är giltigt för alla måltyper utom StorageQueue. Flera attribut kan anges med fler än ett --delivery-attribute-mapping argument.

Användning: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Förhandsgranskning

Identitetstypen för leveransmålresursen (t.ex. lagringskö eller eventhub).

Godkända värden: systemassigned
--delivery-identity-endpoint
Förhandsgranskning

Slutpunkt med identitet där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten.

--delivery-identity-endpoint-type
Förhandsgranskning

Typ av målslutpunkt med resursidentitet.

Godkända värden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Gör att avancerade filter kan utvärderas mot en matris med värden i stället för att förvänta sig ett singularvärde.

Godkända värden: false, true
--endpoint

Slutpunkt där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten. Det förväntas att målslutpunkten redan har skapats och är tillgänglig för användning innan ett Event Grid-kommando körs.

--endpoint-type

Typ av målslutpunkt.

Standardvärde: webhook
--event-delivery-schema

Schemat där händelser ska levereras för den här händelseprenumerationen. Som standard levereras händelser i samma schema där de publiceras (baserat på motsvarande ämnes indataschema).

Godkända värden: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Händelsetid till live (i minuter). Måste vara ett tal mellan 1 och 1440.

Standardvärde: 1440
--expiration-date

Datum eller datetime (i UTC, t.ex. "2018-11-30T11:59:59+00:00" eller "2018-11-30") varefter händelseprenumerationen upphör att gälla. Som standard går det inte att förfalla för händelseprenumerationen.

--included-event-types

En blankstegsavgränsad lista över händelsetyper (t.ex. Microsoft.Storage.BlobCreated och Microsoft.Storage.BlobDeleted). Om du vill prenumerera på alla standardhändelsetyper ska du inte ange något värde för det här argumentet. För event grid-ämnen är händelsetyper kunddefinierade. För Azure-händelser, t.ex. lagringskonton, IoT Hub osv., kan du fråga deras händelsetyper med hjälp av det här CLI-kommandot "az eventgrid topic-type list-event-types".

--labels

En blankstegsavgränsad lista med etiketter som ska associeras med den här händelseprenumerationen.

--max-delivery-attempts

Maximalt antal leveransförsök. Måste vara ett tal mellan 1 och 30.

Standardvärde: 30
--max-events-per-batch

Maximalt antal händelser i en batch. Måste vara ett tal mellan 1 och 5 000.

--preferred-batch-size-in-kilobytes

Önskad batchstorlek i kilobyte. Måste vara ett tal mellan 1 och 1024.

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

Lagringskö meddelandetid att leva i sekunder.

--source-resource-id

Fullständigt kvalificerad identifierare för den Azure-resurs som händelseprenumerationen måste skapas till.

Användning: --source-resource-id Azure-Resource-ID För Azure-prenumeration: --source-resource-id /subscriptions/{SubID} För resursgrupp: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 För EventGrid-ämne: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 För lagringskonto: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 För EventGrid-domän: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett prefix. Jokertecken stöds inte.

--subject-case-sensitive

Ange om ämnesfälten ska jämföras på ett skiftlägeskänsligt sätt. Sant om flaggan finns.

Godkända värden: false, true
Standardvärde: False
--subject-ends-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett suffix. Jokertecken stöds inte.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid event-subscription create (eventgrid anknytning)

Förhandsgranskning

Kommandogruppen "az eventgrid" finns i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Skapa en ny händelseprenumeration.

az eventgrid event-subscription create --name
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--azure-active-directory-tenant-id]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--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]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Exempel

Skapa en ny händelseprenumeration för ett Event Grid-ämne med hjälp av standardfilter.

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

Skapa en ny händelseprenumeration för en Azure-prenumeration med hjälp av standardfilter.

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

Skapa en ny händelseprenumeration för en resursgrupp med hjälp av standardfilter.

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

Skapa en ny händelseprenumeration för ett lagringskonto med hjälp av standardfilter.

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

Skapa en ny händelseprenumeration för ett lagringskonto med hjälp av avancerade filter.

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

Skapa en ny händelseprenumeration för en Azure-prenumeration med ett filter som anger ett ämnesprefix.

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

Skapa en ny händelseprenumeration för en resursgrupp med ett filter som anger ett ämnessuffix.

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

Skapa en ny händelseprenumeration för en Azure-prenumeration med standardfilter och en EventHub som mål.

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

Skapa en ny händelseprenumeration för en Azure-prenumeration med standardfilter och en Azure Storage-kö som mål.

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

Skapa en ny händelseprenumeration för en Azure-prenumeration med standardfilter och en Azure ServiceBusQueue som mål.

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

Skapa en ny händelseprenumeration för en Event Grid-domän med standardfilter och CloudEvent V 1.0 som leveransschema.

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

Skapa en ny händelseprenumeration för ett lagringskonto med ett deadletter-mål och en anpassad återförsöksprincip på högst 10 leveransförsök och en händelse-TTL på 2 timmar (beroende på vilket som inträffar tidigare).

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

Skapa en ny händelseprenumeration för ett domänämne.

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

Skapa en ny händelseprenumeration (för ett lagringskonto) med ett förfallodatum.

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"

Skapa en ny händelseprenumeration för ett Event Grid-ämne med Azure Active Directory-aktiverad Webhook som mål .

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

Skapa en ny händelseprenumeration för ett Event Grid-ämne med Azure Function som mål.

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

Skapa en ny händelseprenumeration för ett Event Grid-ämne med Eventhub med systemtilldelad MSI-identitet som mål och med deadletter med MSI-identitet

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}

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

Valfria parametrar

--advanced-filter

Ett avancerat filter möjliggör filtrering av händelser baserat på en specifik händelseegenskap.

Användning: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-VÄRDE [VÄRDE ...] StringIn: --advanced-filter data. FärgsträngI blå röd orange gul stringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 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 Flera avancerade filter kan anges med fler än ett --advanced-filter argument.

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

Azure Active Directory-program-ID eller URI för att hämta åtkomsttoken som ska inkluderas som ägartoken i leveransbegäranden. Gäller endast för webhook som mål.

--azure-active-directory-tenant-id

Azure Active Directory-klient-ID:t för att hämta åtkomsttoken som ska inkluderas som ägartoken i leveransbegäranden. Gäller endast för webhook som mål.

--deadletter-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål där EventGrid bör döda händelser som inte kan levereras för den här händelseprenumerationen.

Exempel: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--deadletter-identity

Identitetstypen för målresursen deadletter.

Godkända värden: systemassigned
--deadletter-identity-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål med identitet där EventGrid ska döda händelser som inte kan levereras för den här händelseprenumerationen.

--delivery-identity

Identitetstypen för leveransmålresursen (t.ex. lagringskö eller eventhub).

Godkända värden: systemassigned
--delivery-identity-endpoint

Slutpunkt med identitet där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten.

--delivery-identity-endpoint-type

Typ av målslutpunkt med resursidentitet.

Godkända värden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Slutpunkt där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten.

--endpoint-type

Typ av målslutpunkt.

Godkända värden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Standardvärde: webhook
--event-delivery-schema

Schemat där händelser ska levereras för den här händelseprenumerationen. Som standard levereras händelser i samma schema där de publiceras (baserat på motsvarande ämnes indataschema).

Godkända värden: cloudeventschemav1_0, custominputschema, eventgridschema
--event-ttl

Händelsetid till live (i minuter). Måste vara ett tal mellan 1 och 1440.

Standardvärde: 1440
--expiration-date

Datum eller datetime (i UTC, t.ex. "2018-11-30T11:59:59+00:00" eller "2018-11-30") varefter händelseprenumerationen upphör att gälla. Som standard går det inte att förfalla för händelseprenumerationen.

--included-event-types

En blankstegsavgränsad lista över händelsetyper. Exempel: Microsoft.Storage.BlobSkapat Microsoft.Storage.BlobDeleted. Om du vill prenumerera på alla standardhändelsetyper ska du inte ange något värde för det här argumentet.

--labels

En blankstegsavgränsad lista med etiketter som ska associeras med den här händelseprenumerationen.

--max-delivery-attempts

Maximalt antal leveransförsök. Måste vara ett tal mellan 1 och 30.

Standardvärde: 30
--max-events-per-batch

Maximalt antal händelser i en batch. Måste vara ett tal mellan 1 och 5 000.

--preferred-batch-size-in-kilobytes

Önskad batchstorlek i kilobyte. Måste vara ett tal mellan 1 och 1024.

--source-resource-id

Fullständigt kvalificerad identifierare för den Azure-resurs som händelseprenumerationen måste skapas till.

Användning: --source-resource-id Azure-Resource-ID För Azure-prenumeration: --source-resource-id /subscriptions/{SubID} För resursgrupp: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 För EventGrid-ämne: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 För lagringskonto: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 För EventGrid-domän: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett prefix. Jokertecken stöds inte.

--subject-case-sensitive

Ange om ämnesfälten ska jämföras på ett skiftlägeskänsligt sätt. Sant om flaggan finns.

Godkända värden: false, true
Standardvärde: False
--subject-ends-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett suffix. Jokertecken stöds inte.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid event-subscription delete

Ta bort en händelseprenumeration.

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

Exempel

Ta bort en händelseprenumeration för ett Event Grid-ämne.

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

Ta bort en händelseprenumeration för ett Event Grid-domänavsnitt.

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

Ta bort en händelseprenumeration för en Event Grid-domän.

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

Ta bort en händelseprenumeration för en Azure-prenumeration.

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

Ta bort en händelseprenumeration för en resursgrupp.

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

Ta bort en händelseprenumeration för ett lagringskonto.

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

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

Valfria parametrar

--source-resource-id

Fullständigt kvalificerad identifierare för den Azure-resurs vars händelseprenumeration måste tas bort.

Användning: --source-resource-id Azure-Resource-ID För Azure-prenumeration: --source-resource-id /subscriptions/{SubID} För resursgrupp: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 För EventGrid-ämne: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 För lagringskonto: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 För EventGrid-domän: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid event-subscription delete (eventgrid anknytning)

Förhandsgranskning

Kommandogruppen "az eventgrid" finns i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Ta bort en händelseprenumeration.

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

Exempel

Ta bort en händelseprenumeration för ett Event Grid-ämne.

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

Ta bort en händelseprenumeration för ett Event Grid-domänavsnitt.

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

Ta bort en händelseprenumeration för en Event Grid-domän.

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

Ta bort en händelseprenumeration för en Azure-prenumeration.

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

Ta bort en händelseprenumeration för en resursgrupp.

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

Ta bort en händelseprenumeration för ett lagringskonto.

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

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

Valfria parametrar

--source-resource-id

Fullständigt kvalificerad identifierare för den Azure-resurs vars händelseprenumeration måste tas bort.

Användning: --source-resource-id Azure-Resource-ID För Azure-prenumeration: --source-resource-id /subscriptions/{SubID} För resursgrupp: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 För EventGrid-ämne: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 För lagringskonto: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 För EventGrid-domän: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid event-subscription list

Lista händelseprenumerationer.

Event Grid stöder både regionala och globala händelseprenumerationer: Händelseprenumerationer på regionala resurser (till exempel Lagringskonton eller Event Grid-ämnen) är regionala, medan händelseprenumerationer på globala resurser (till exempel en Azure-prenumeration eller resursgrupp) är globala. Därför kan du lista händelseprenumerationer på några olika sätt:

  1. Ange parametern --source-resource-id för den resurs vars händelseprenumerationer du vill visa. Inga andra parametrar får anges.
  2. Om du vill lista efter en ämnestyp (t.ex. lagringskonton) anger du parametern --topic-type tillsammans med parametern --location (t.ex. "westus2"). För globala ämnestyper (t.ex. "Microsoft.Resources.Subscriptions" anger du platsvärdet som "global".
  3. Om du vill visa en lista över alla händelseprenumerationer i en region (över alla ämnestyper) anger du endast parametern --location.
  4. För både #2 och #3 ovan kan du dessutom ange parametern --resource-group om du bara vill filtrera efter en resursgrupp.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Exempel

Visa en lista över alla händelseprenumerationer som skapats för ett Event Grid-ämne.

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

Visa en lista över alla händelseprenumerationer som skapats för ett lagringskonto.

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

Visa en lista över alla händelseprenumerationer som skapats för en Azure-prenumeration.

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

Visa en lista över alla händelseprenumerationer som skapats för en resursgrupp.

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

Visa en lista över alla händelseprenumerationer för en Event Grid-domän.

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

Visa en lista över alla händelseprenumerationer för ett Event Grid-domänavsnitt.

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

Visa en lista över alla lagringshändelseprenumerationer (under den för närvarande valda Azure-prenumerationen) i westus2.

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

Visa en lista över alla lagringshändelseprenumerationer (under den angivna resursgruppen) i westus2.

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

Visa en lista över alla regionala eller globala händelseprenumerationer (under den valda Azure-prenumerationen).

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

Visa en lista över alla regionala eller globala händelseprenumerationer under en angiven resursgrupp.

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

Visa en lista över alla händelseprenumerationer för en Event Grid-domän vars namn innehåller mönstret "XYZ"

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

Visa en lista över alla händelseprenumerationer för en Event Grid-domän förutom händelseprenumerationen med namnet "name1"

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

Valfria parametrar

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--odata-query

OData-frågan som används för att filtrera listresultatet. Filtrering tillåts för närvarande endast på egenskapen Namn. De åtgärder som stöds är: CONTAINS, eq (för lika), ne (för inte lika), AND, OR och NOT.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--source-resource-id

Fullständigt kvalificerad identifierare för den Azure-resurs vars händelseprenumeration måste visas.

Användning: --source-resource-id Azure-Resource-ID För Azure-prenumeration: --source-resource-id /subscriptions/{SubID} För resursgrupp: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 För EventGrid-ämne: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 För lagringskonto: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 För EventGrid-domän: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Namn på den ämnestyp vars händelseprenumerationer måste visas. När detta anges måste du också ange --location.

Exempel 1: Lista alla lagringshändelseprenumerationer i WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Exempel 2: Lista alla händelseprenumerationer på Azure-prenumerationer --topic-type-name Microsoft.Resources.Subscriptions --location global.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid event-subscription list (eventgrid anknytning)

Förhandsgranskning

Kommandogruppen "az eventgrid" finns i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Lista händelseprenumerationer.

Event Grid stöder både regionala och globala händelseprenumerationer: Händelseprenumerationer på regionala resurser (till exempel Lagringskonton eller Event Grid-ämnen) är regionala, medan händelseprenumerationer på globala resurser (till exempel en Azure-prenumeration eller resursgrupp) är globala. Därför kan du lista händelseprenumerationer på några olika sätt:

  1. Ange parametern --source-resource-id för den resurs vars händelseprenumerationer du vill visa. Inga andra parametrar får anges.
  2. Om du vill lista efter en ämnestyp (t.ex. lagringskonton) anger du parametern --topic-type tillsammans med parametern --location (t.ex. "westus2"). För globala ämnestyper (t.ex. "Microsoft.Resources.Subscriptions" anger du platsvärdet som "global".
  3. Om du vill visa en lista över alla händelseprenumerationer i en region (över alla ämnestyper) anger du endast parametern --location.
  4. För både #2 och #3 ovan kan du dessutom ange parametern --resource-group om du bara vill filtrera efter en resursgrupp.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Exempel

Visa en lista över alla händelseprenumerationer som skapats för ett Event Grid-ämne.

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

Visa en lista över alla händelseprenumerationer som skapats för ett lagringskonto.

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

Visa en lista över alla händelseprenumerationer som skapats för en Azure-prenumeration.

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

Visa en lista över alla händelseprenumerationer som skapats för en resursgrupp.

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

Visa en lista över alla händelseprenumerationer för en Event Grid-domän.

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

Visa en lista över alla händelseprenumerationer för ett Event Grid-domänavsnitt.

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

Visa en lista över alla lagringshändelseprenumerationer (under den för närvarande valda Azure-prenumerationen) i westus2.

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

Visa en lista över alla lagringshändelseprenumerationer (under den angivna resursgruppen) i westus2.

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

Visa en lista över alla regionala eller globala händelseprenumerationer (under den valda Azure-prenumerationen).

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

Visa en lista över alla regionala eller globala händelseprenumerationer under en angiven resursgrupp.

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

Visa en lista över alla händelseprenumerationer för en Event Grid-domän vars namn innehåller mönstret "XYZ"

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

Visa en lista över alla händelseprenumerationer för en Event Grid-domän förutom händelseprenumerationen med namnet "name1"

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

Valfria parametrar

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--odata-query

Frågan som används för att filtrera resultaten med hjälp av OData-syntax.

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--source-resource-id

Fullständigt kvalificerad identifierare för den Azure-resurs vars händelseprenumeration måste visas.

Användning: --source-resource-id Azure-Resource-ID För Azure-prenumeration: --source-resource-id /subscriptions/{SubID} För resursgrupp: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 För EventGrid-ämne: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 För lagringskonto: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 För EventGrid-domän: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--topic-type-name

Namn på den ämnestyp vars händelseprenumerationer måste visas. När detta anges måste du också ange --location.

Exempel 1: Lista alla lagringshändelseprenumerationer i WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Exempel 2: Lista alla händelseprenumerationer på Azure-prenumerationer --topic-type-name Microsoft.Resources.Subscriptions --location global.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid event-subscription show

Hämta information om en händelseprenumeration.

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

Exempel

Visa information om en händelseprenumeration för ett Event Grid-ämne.

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

Visa information om en händelseprenumeration för en Azure-prenumeration.

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

Visa information om en händelseprenumeration för en resursgrupp.

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

Visa information om en händelseprenumeration för ett lagringskonto.

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

Visa information om en händelseprenumeration för en resursgrupp, inklusive eventuella hemligheter för statiska leveransattribut.

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

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

Valfria parametrar

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

Ange om några hemligheter för statiska leveransattribut ska returneras. Sant om flaggan finns.

Godkända värden: false, true
Standardvärde: False
--include-full-endpoint-url

Ange om den fullständiga slutpunkts-URL:en ska returneras. Sant om flaggan finns.

Godkända värden: false, true
Standardvärde: False
--source-resource-id

Fullständigt kvalificerad identifierare för den Azure-resurs vars händelseprenumeration måste visas.

Användning: --source-resource-id Azure-Resource-ID För Azure-prenumeration: --source-resource-id /subscriptions/{SubID} För resursgrupp: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 För EventGrid-ämne: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 För lagringskonto: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 För EventGrid-domän: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid event-subscription show (eventgrid anknytning)

Förhandsgranskning

Kommandogruppen "az eventgrid" finns i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Hämta information om en händelseprenumeration.

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

Exempel

Visa information om en händelseprenumeration för ett Event Grid-ämne.

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

Visa information om en händelseprenumeration för en Azure-prenumeration.

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

Visa information om en händelseprenumeration för en resursgrupp.

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

Visa information om en händelseprenumeration för ett lagringskonto.

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

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

Valfria parametrar

--include-full-endpoint-url

Ange om den fullständiga slutpunkts-URL:en ska returneras. Sant om flaggan finns.

Godkända värden: false, true
Standardvärde: False
--source-resource-id

Fullständigt kvalificerad identifierare för den Azure-resurs vars händelseprenumeration måste visas.

Användning: --source-resource-id Azure-Resource-ID För Azure-prenumeration: --source-resource-id /subscriptions/{SubID} För resursgrupp: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 För EventGrid-ämne: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 För lagringskonto: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 För EventGrid-domän: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid event-subscription update

Uppdatera en händelseprenumeration.

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]

Exempel

Uppdatera en händelseprenumeration för ett Event Grid-ämne för att ange en ny slutpunkt.

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

Uppdatera en händelseprenumeration för en Azure-prenumeration för att ange ett nytt ämnesslut med filter.

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

Uppdatera en händelseprenumeration för en resursgrupp för att ange en ny slutpunkt och ett nytt ämnesslut med filter.

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

Uppdatera en händelseprenumeration för ett lagringskonto för att ange en ny lista över inkluderade händelsetyper.

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

Uppdatera en händelseprenumeration för ett lagringskonto för att inkludera ett deadletter-mål.

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

Uppdatera en händelseprenumeration för ett lagringskonto med hjälp av avancerade filter.

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

Uppdatera en händelseprenumeration för ett lagringskonto så att meddelandet ttl anges till 5 minuter.

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

Uppdatera en händelseprenumeration med avancerad filtrering aktiverat på matriser

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

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

Standardvärde: []
--advanced-filter

Ett avancerat filter möjliggör filtrering av händelser baserat på en specifik händelseegenskap.

Användning: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-VÄRDE [VÄRDE ...] StringIn: --advanced-filter data. FärgsträngI blå röd orange gul stringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg 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 NumberNotInRange 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 BoolEqual sant IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Flera avancerade filter kan anges med fler än ett --advanced-filter argument.

--deadletter-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål där EventGrid bör döda händelser som inte kan levereras för den här händelseprenumerationen.

--deadletter-identity
Förhandsgranskning

Identitetstypen för målresursen deadletter.

Godkända värden: systemassigned
--deadletter-identity-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål med identitet där EventGrid ska döda händelser som inte kan levereras för den här händelseprenumerationen.

--delivery-attribute-mapping

Lägg till leveransattributmappning för att skicka ytterligare information via HTTP-huvuden när händelser levereras. Det här attributet är giltigt för alla måltyper utom StorageQueue. Flera attribut kan anges med fler än ett --delivery-attribute-mapping argument.

Användning: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity
Förhandsgranskning

Identitetstypen för leveransmålresursen (t.ex. lagringskö eller eventhub).

Godkända värden: systemassigned
--delivery-identity-endpoint
Förhandsgranskning

Slutpunkt med identitet där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten.

--delivery-identity-endpoint-type
Förhandsgranskning

Typ av målslutpunkt med resursidentitet.

Godkända värden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--enable-advanced-filtering-on-arrays --enable-af-arr

Gör att avancerade filter kan utvärderas mot en matris med värden i stället för att förvänta sig ett singularvärde.

Godkända värden: false, true
--endpoint

Slutpunkt där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten. Det förväntas att målslutpunkten redan har skapats och är tillgänglig för användning innan ett Event Grid-kommando körs.

--endpoint-type

Typ av målslutpunkt.

Standardvärde: webhook
--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

Standardvärde: False
--included-event-types

En blankstegsavgränsad lista över händelsetyper (t.ex. Microsoft.Storage.BlobCreated och Microsoft.Storage.BlobDeleted). Om du vill prenumerera på alla standardhändelsetyper ska du inte ange något värde för det här argumentet. För event grid-ämnen är händelsetyper kunddefinierade. För Azure-händelser, t.ex. lagringskonton, IoT Hub osv., kan du fråga deras händelsetyper med hjälp av det här CLI-kommandot "az eventgrid topic-type list-event-types".

--labels

En blankstegsavgränsad lista med etiketter som ska associeras med den här händelseprenumerationen.

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

Lagringskö meddelandetid att leva i sekunder.

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

Standardvärde: []
--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

Standardvärde: []
--source-resource-id

Fullständigt kvalificerad identifierare för den Azure-resurs vars händelseprenumeration måste uppdateras.

Användning: --source-resource-id Azure-Resource-ID För Azure-prenumeration: --source-resource-id /subscriptions/{SubID} För resursgrupp: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 För EventGrid-ämne: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 För lagringskonto: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 För EventGrid-domän: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett prefix. Jokertecken stöds inte.

--subject-ends-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett suffix. Jokertecken stöds inte.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az eventgrid event-subscription update (eventgrid anknytning)

Förhandsgranskning

Kommandogruppen "az eventgrid" finns i förhandsversion och under utveckling. Referens- och supportnivåer: https://aka.ms/CLI_refstatus

Uppdatera en händelseprenumeration.

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

Exempel

Uppdatera en händelseprenumeration för ett Event Grid-ämne för att ange en ny slutpunkt.

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

Uppdatera en händelseprenumeration för en Azure-prenumeration för att ange ett nytt ämnesslut med filter.

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

Uppdatera en händelseprenumeration för en resursgrupp för att ange en ny slutpunkt och ett nytt ämnesslut med filter.

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

Uppdatera en händelseprenumeration för ett lagringskonto för att ange en ny lista över inkluderade händelsetyper.

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

Uppdatera en händelseprenumeration för ett lagringskonto för att inkludera ett deadletter-mål.

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

Uppdatera en händelseprenumeration för ett lagringskonto med hjälp av avancerade filter.

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

Obligatoriska parametrar

--name -n

Namn på händelseprenumerationen.

Valfria parametrar

--add

Lägg till ett objekt i en lista över objekt genom att ange en sökväg och nyckelvärdepar. Exempel: --add property.listProperty <key=value, string or JSON string>.

Standardvärde: []
--advanced-filter

Ett avancerat filter möjliggör filtrering av händelser baserat på en specifik händelseegenskap.

Användning: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-VÄRDE [VÄRDE ...] StringIn: --advanced-filter data. FärgsträngI blå röd orange gul stringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 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 Flera avancerade filter kan anges med fler än ett --advanced-filter argument.

--deadletter-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål där EventGrid bör döda händelser som inte kan levereras för den här händelseprenumerationen.

--deadletter-identity

Identitetstypen för målresursen deadletter.

Godkända värden: systemassigned
--deadletter-identity-endpoint

Azure-resurs-ID:t för ett Azure Storage-blobcontainermål med identitet där EventGrid ska döda händelser som inte kan levereras för den här händelseprenumerationen.

--delivery-identity

Identitetstypen för leveransmålresursen (t.ex. lagringskö eller eventhub).

Godkända värden: systemassigned
--delivery-identity-endpoint

Slutpunkt med identitet där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten.

--delivery-identity-endpoint-type

Typ av målslutpunkt med resursidentitet.

Godkända värden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--endpoint

Slutpunkt där EventGrid ska leverera händelser som matchar den här händelseprenumerationen. För webhook-slutpunktstyp bör detta vara motsvarande webhook-URL. För andra slutpunktstyper bör detta vara Azure-resursidentifieraren för slutpunkten.

--endpoint-type

Typ av målslutpunkt.

Godkända värden: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Standardvärde: webhook
--force-string

När du använder "set" eller "add" bevarar du strängliteraler i stället för att försöka konvertera till JSON.

Standardvärde: False
--included-event-types

En blankstegsavgränsad lista över händelsetyper. Exempel: Microsoft.Storage.BlobSkapat Microsoft.Storage.BlobDeleted. Om du vill prenumerera på alla standardhändelsetyper ska du inte ange något värde för det här argumentet.

--labels

En blankstegsavgränsad lista med etiketter som ska associeras med den här händelseprenumerationen.

--remove

Ta bort en egenskap eller ett element från en lista. Exempel: --remove property.list <indexToRemove> ELLER --remove propertyToRemove.

Standardvärde: []
--set

Uppdatera ett objekt genom att ange en egenskapssökväg och ett värde som ska anges. Exempel: --set property1.property2=<value>.

Standardvärde: []
--source-resource-id

Fullständigt kvalificerad identifierare för den Azure-resurs vars händelseprenumeration måste uppdateras.

Användning: --source-resource-id Azure-Resource-ID För Azure-prenumeration: --source-resource-id /subscriptions/{SubID} För resursgrupp: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 För EventGrid-ämne: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 För lagringskonto: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 För EventGrid-domän: -- source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 For EventGrid domain topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett prefix. Jokertecken stöds inte.

--subject-ends-with

En valfri sträng för att filtrera händelser för en händelseprenumeration baserat på ett suffix. Jokertecken stöds inte.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.