az eventgrid event-subscription

Riferimento

Nota

Questo gruppo di comandi include comandi definiti sia nell'interfaccia della riga di comando di Azure che in almeno un'estensione. Installare ogni estensione per trarre vantaggio dalle funzionalità estese. Altre informazioni sulle estensioni.

Gestire le sottoscrizioni di eventi.

Gestire le sottoscrizioni di eventi per un argomento di Griglia di eventi, un dominio, un argomento di dominio, una sottoscrizione di Azure, un gruppo di risorse o per qualsiasi altra risorsa di Azure che supporta le notifiche degli eventi.

Comandi

Nome	Descrizione	Tipo	Stato
az eventgrid event-subscription create	Creare una nuova sottoscrizione di eventi.	Memoria centrale	Disponibilità generale
az eventgrid event-subscription create (eventgrid estensione)	Creare una nuova sottoscrizione di eventi.	Estensione	Anteprima
az eventgrid event-subscription delete	Eliminare una sottoscrizione di eventi.	Memoria centrale	Disponibilità generale
az eventgrid event-subscription delete (eventgrid estensione)	Eliminare una sottoscrizione di eventi.	Estensione	Anteprima
az eventgrid event-subscription list	Elencare le sottoscrizioni di eventi.	Memoria centrale	Disponibilità generale
az eventgrid event-subscription list (eventgrid estensione)	Elencare le sottoscrizioni di eventi.	Estensione	Anteprima
az eventgrid event-subscription show	Ottenere i dettagli di una sottoscrizione di eventi.	Memoria centrale	Disponibilità generale
az eventgrid event-subscription show (eventgrid estensione)	Ottenere i dettagli di una sottoscrizione di eventi.	Estensione	Anteprima
az eventgrid event-subscription update	Aggiornare una sottoscrizione di eventi.	Memoria centrale	Disponibilità generale
az eventgrid event-subscription update (eventgrid estensione)	Aggiornare una sottoscrizione di eventi.	Estensione	Anteprima

az eventgrid event-subscription create

Modifica

Creare una nuova sottoscrizione di eventi.

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]

Esempio

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi usando i filtri predefiniti.

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

Creare una nuova sottoscrizione di eventi per una sottoscrizione di Azure usando i filtri predefiniti.

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

Creare una nuova sottoscrizione di eventi per un gruppo di risorse usando i filtri predefiniti.

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

Creare una nuova sottoscrizione di eventi per un account di archiviazione usando i filtri predefiniti.

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

Creare una nuova sottoscrizione di eventi per un account di archiviazione usando filtri avanzati.

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

Creare una nuova sottoscrizione di eventi per una sottoscrizione di Azure con un filtro che specifica un prefisso soggetto.

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

Creare una nuova sottoscrizione di eventi per un gruppo di risorse con un filtro che specifica un suffisso del soggetto.

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

Creare una nuova sottoscrizione di eventi per una sottoscrizione di Azure, usando i filtri predefiniti e un Hub eventi come destinazione.

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

Creare una nuova sottoscrizione di eventi per una sottoscrizione di Azure, usando filtri predefiniti e una coda di Archiviazione di Azure come destinazione.

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

Creare una nuova sottoscrizione di eventi per una sottoscrizione di Azure, usando i filtri predefiniti e un'istanza di Azure ServiceBusQueue come destinazione.

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

Creare una nuova sottoscrizione di eventi per un dominio di Griglia di eventi, usando i filtri predefiniti e CloudEvent V 1.0 come schema di recapito.

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

Creare una nuova sottoscrizione di eventi per un account di archiviazione, con una destinazione non recapitabili e criteri di ripetizione personalizzati con un massimo di 10 tentativi di recapito e un TTL evento di 2 ore (a condizione che si verifichi in precedenza).

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

Creare una nuova sottoscrizione di eventi per un argomento di dominio.

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

Creare una nuova sottoscrizione di eventi (per un account di archiviazione) con una data di scadenza.

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"

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi usando webhook abilitato per Azure Active Directory come destinazione.

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

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi usando Funzioni di Azure come destinazione.

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

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi, usando Eventhub con l'identità MSI assegnata dal sistema come destinazione e con deadletter con identità MSI

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}

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi usando Archiviazione Coda come destinazione con ttl del messaggio a 5 minuti

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

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi usando Archiviazione Queue con identità MSI assegnata come destinazione

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

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi con filtro avanzato abilitato per le matrici

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

Parametri necessari

--name -n

Nome della sottoscrizione di eventi.

Parametri facoltativi

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

ID tenant di Azure Active Directory per ottenere il token di accesso che verrà incluso come token di connessione nelle richieste di recapito. Applicabile solo per il webhook come destinazione.

--advanced-filter

Un filtro avanzato consente di filtrare gli eventi in base a una proprietà evento specifica.

Utilizzo: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR VALUE [VALUE ...] StringIn: --advanced-filter data.StringIn: --advanced-filter data. Colore StringIn Blu Rosso Arancione Giallo StringNotIn: --advanced-filter data. StringNotIn Blu Blu Arancione Giallo Stringa contiene: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png StringNotEndsWith: --advanced-filter subject StringNotEndsWith img png NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5.10 20.30 40.50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 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 true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull È possibile specificare più filtri avanzati usando più --advanced-filter argomenti.

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

ID applicazione o Uri di Azure Active Directory per ottenere il token di accesso che verrà incluso come token di connessione nelle richieste di recapito. Applicabile solo per il webhook come destinazione.

--deadletter-endpoint

ID risorsa di Azure di una destinazione del contenitore BLOB Archiviazione di Azure in cui EventGrid deve generare eventi non recapitabili per questa sottoscrizione di eventi.

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

--deadletter-identity

Anteprima

Tipo di identità della risorsa di destinazione non recapitabili.

valori accettati: systemassigned

--deadletter-identity-endpoint

ID risorsa di Azure di una destinazione del contenitore BLOB Archiviazione di Azure con identità in cui EventGrid deve generare eventi non recapitabili per questa sottoscrizione di eventi.

--delivery-attribute-mapping

Aggiungere il mapping dell'attributo di recapito per inviare informazioni aggiuntive tramite intestazioni HTTP durante il recapito degli eventi. Questo attributo è valido per tutti i tipi di destinazione tranne Archiviazione Queue. È possibile specificare più attributi usando più --delivery-attribute-mapping argomenti.

Utilizzo: --delivery-attribute-mapping attribute-name attribute-type attribute-value [attribute-is-secret] Mapping attributi statici: --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 dinamico somevalue Sia statico che dinamico: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--delivery-identity

Anteprima

Tipo di identità della risorsa di destinazione del recapito(ad esempio, coda di archiviazione o hub eventi).

valori accettati: systemassigned

--delivery-identity-endpoint

Anteprima

Endpoint con identità in cui EventGrid deve recapitare eventi corrispondenti a questa sottoscrizione di eventi. Per il tipo di endpoint webhook, deve essere l'URL del webhook corrispondente. Per altri tipi di endpoint, deve essere l'identificatore della risorsa di Azure dell'endpoint.

--delivery-identity-endpoint-type

Anteprima

Tipo dell'endpoint di destinazione con identità della risorsa.

valori accettati: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

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

Consente di valutare i filtri avanzati rispetto a una matrice di valori anziché prevedere un valore singolare.

valori accettati: false, true

--endpoint

Endpoint in cui EventGrid deve recapitare eventi corrispondenti a questa sottoscrizione di eventi. Per il tipo di endpoint webhook, deve essere l'URL del webhook corrispondente. Per altri tipi di endpoint, deve essere l'identificatore della risorsa di Azure dell'endpoint. È previsto che l'endpoint di destinazione sia già stato creato e disponibile per l'uso prima di eseguire qualsiasi comando di Griglia di eventi.

--endpoint-type

Tipo dell'endpoint di destinazione.

valore predefinito: webhook

--event-delivery-schema

Schema in cui gli eventi devono essere recapitati per questa sottoscrizione di eventi. Per impostazione predefinita, gli eventi verranno recapitati nello stesso schema in cui vengono pubblicati (in base allo schema di input dell'argomento corrispondente).

valori accettati: cloudeventschemav1_0, custominputschema, eventgridschema

--event-ttl

Durata dell'evento (in minuti). Deve essere un numero compreso tra 1 e 1440.

valore predefinito: 1440

--expiration-date

Data o datetime (in formato UTC, ad esempio '2018-11-30T11:59:59+00:00' o '2018-11-30') dopo la scadenza della sottoscrizione dell'evento. Per impostazione predefinita, non è prevista alcuna scadenza per la sottoscrizione di eventi.

--included-event-types

Elenco delimitato da spazi di tipi di evento, ad esempio Microsoft.Archiviazione. BLOBCreated e Microsoft. Archiviazione. BlobDeleted). Per sottoscrivere tutti i tipi di evento predefiniti, non specificare alcun valore per questo argomento. Per gli argomenti di Griglia di eventi, i tipi di evento sono definiti dal cliente. Per gli eventi di Azure, ad esempio account Archiviazione, hub IoT e così via, è possibile eseguire query sui tipi di evento usando questo comando dell'interfaccia della riga di comando "az eventgrid topic-type list-event-types".

--labels

Elenco delimitato da spazi di etichette da associare a questa sottoscrizione di eventi.

--max-delivery-attempts

Numero massimo di tentativi di recapito. Deve essere un numero compreso tra 1 e 30.

valore predefinito: 30

--max-events-per-batch

Numero massimo di eventi in un batch. Deve essere un numero compreso tra 1 e 5000.

--preferred-batch-size-in-kilobytes

Dimensioni batch preferite in kilobyte. Deve essere un numero compreso tra 1 e 1024.

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

Archiviazione tempo di attesa del messaggio della coda in secondi.

--source-resource-id

Identificatore completo della risorsa di Azure a cui deve essere creata la sottoscrizione di eventi.

Utilizzo: --source-resource-id Azure-Resource-ID per la sottoscrizione di Azure: --source-resource-id /subscriptions/{SubID} Per il gruppo di risorse: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 Per l'argomento EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 Per l'account di archiviazione: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Archiviazione/storageaccounts/sa1 Per il dominio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1 Per il dominio EventGrid: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/domains/d1/topics/t1.

--subject-begins-with

Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un prefisso. I caratteri jolly non sono supportati.

--subject-case-sensitive

Specificare per indicare se i campi oggetto devono essere confrontati in modo con distinzione tra maiuscole e minuscole. True se il flag è presente.

valori accettati: false, true

valore predefinito: False

--subject-ends-with

Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un suffisso. I caratteri jolly non sono supportati.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az eventgrid event-subscription create (eventgrid estensione)

Anteprima

Il gruppo di comandi 'az eventgrid' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare una nuova sottoscrizione di eventi.

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]

Esempio

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi usando i filtri predefiniti.

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

Creare una nuova sottoscrizione di eventi per una sottoscrizione di Azure usando i filtri predefiniti.

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

Creare una nuova sottoscrizione di eventi per un gruppo di risorse usando i filtri predefiniti.

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

Creare una nuova sottoscrizione di eventi per un account di archiviazione usando i filtri predefiniti.

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

Creare una nuova sottoscrizione di eventi per un account di archiviazione usando filtri avanzati.

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

Creare una nuova sottoscrizione di eventi per una sottoscrizione di Azure con un filtro che specifica un prefisso soggetto.

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

Creare una nuova sottoscrizione di eventi per un gruppo di risorse con un filtro che specifica un suffisso del soggetto.

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

Creare una nuova sottoscrizione di eventi per una sottoscrizione di Azure, usando i filtri predefiniti e un Hub eventi come destinazione.

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

Creare una nuova sottoscrizione di eventi per una sottoscrizione di Azure, usando filtri predefiniti e una coda di Archiviazione di Azure come destinazione.

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

Creare una nuova sottoscrizione di eventi per una sottoscrizione di Azure, usando i filtri predefiniti e un'istanza di Azure ServiceBusQueue come destinazione.

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

Creare una nuova sottoscrizione di eventi per un dominio di Griglia di eventi, usando i filtri predefiniti e CloudEvent V 1.0 come schema di recapito.

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

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

Creare una nuova sottoscrizione di eventi per un argomento di dominio.

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

Creare una nuova sottoscrizione di eventi (per un account di archiviazione) con una data di scadenza.

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"

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi usando webhook abilitato per Azure Active Directory come destinazione.

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

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi usando Funzioni di Azure come destinazione.

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

Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi, usando Eventhub con l'identità MSI assegnata dal sistema come destinazione e con deadletter con identità MSI

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}

Parametri necessari

--name -n

Nome della sottoscrizione di eventi.

Parametri facoltativi

--advanced-filter

Un filtro avanzato consente di filtrare gli eventi in base a una proprietà evento specifica.

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

--azure-active-directory-tenant-id

ID tenant di Azure Active Directory per ottenere il token di accesso che verrà incluso come token di connessione nelle richieste di recapito. Applicabile solo per il webhook come destinazione.

--deadletter-endpoint

ID risorsa di Azure di una destinazione del contenitore BLOB Archiviazione di Azure in cui EventGrid deve generare eventi non recapitabili per questa sottoscrizione di eventi.

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

--deadletter-identity

Tipo di identità della risorsa di destinazione non recapitabili.

valori accettati: systemassigned

--deadletter-identity-endpoint

ID risorsa di Azure di una destinazione del contenitore BLOB Archiviazione di Azure con identità in cui EventGrid deve generare eventi non recapitabili per questa sottoscrizione di eventi.

--delivery-identity

Tipo di identità della risorsa di destinazione del recapito(ad esempio, coda di archiviazione o hub eventi).

valori accettati: systemassigned

--delivery-identity-endpoint

--delivery-identity-endpoint-type

Tipo dell'endpoint di destinazione con identità della risorsa.

valori accettati: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

--endpoint

--endpoint-type

Tipo dell'endpoint di destinazione.

valori accettati: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

valore predefinito: webhook

--event-delivery-schema

valori accettati: cloudeventschemav1_0, custominputschema, eventgridschema

--event-ttl

Durata dell'evento (in minuti). Deve essere un numero compreso tra 1 e 1440.

valore predefinito: 1440

--expiration-date

--included-event-types

Elenco delimitato da spazi di tipi di evento. Esempio: Microsoft. Archiviazione. BlobCreated Microsoft. Archiviazione. BlobDeleted. Per sottoscrivere tutti i tipi di evento predefiniti, non specificare alcun valore per questo argomento.

--labels

Elenco delimitato da spazi di etichette da associare a questa sottoscrizione di eventi.

--max-delivery-attempts

Numero massimo di tentativi di recapito. Deve essere un numero compreso tra 1 e 30.

valore predefinito: 30

--max-events-per-batch

Numero massimo di eventi in un batch. Deve essere un numero compreso tra 1 e 5000.

--preferred-batch-size-in-kilobytes

Dimensioni batch preferite in kilobyte. Deve essere un numero compreso tra 1 e 1024.

--source-resource-id

Identificatore completo della risorsa di Azure a cui deve essere creata la sottoscrizione di eventi.

--subject-begins-with

Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un prefisso. I caratteri jolly non sono supportati.

--subject-case-sensitive

Specificare per indicare se i campi oggetto devono essere confrontati in modo con distinzione tra maiuscole e minuscole. True se il flag è presente.

valori accettati: false, true

valore predefinito: False

--subject-ends-with

Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un suffisso. I caratteri jolly non sono supportati.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az eventgrid event-subscription delete

Modifica

Eliminare una sottoscrizione di eventi.

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

Esempio

Eliminare una sottoscrizione di eventi per un argomento di Griglia di eventi.

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

Eliminare una sottoscrizione di eventi per un argomento di dominio di Griglia di eventi.

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

Eliminare una sottoscrizione di eventi per un dominio di Griglia di eventi.

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

Eliminare una sottoscrizione di eventi per una sottoscrizione di Azure.

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

Eliminare una sottoscrizione di eventi per un gruppo di risorse.

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

Eliminare una sottoscrizione di eventi per un account di archiviazione.

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

Parametri necessari

--name -n

Nome della sottoscrizione di eventi.

Parametri facoltativi

--source-resource-id

Identificatore completo della risorsa di Azure la cui sottoscrizione di eventi deve essere eliminata.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az eventgrid event-subscription delete (eventgrid estensione)

Anteprima

Il gruppo di comandi 'az eventgrid' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare una sottoscrizione di eventi.

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

Esempio

Eliminare una sottoscrizione di eventi per un argomento di Griglia di eventi.

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

Eliminare una sottoscrizione di eventi per un argomento di dominio di Griglia di eventi.

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

Eliminare una sottoscrizione di eventi per un dominio di Griglia di eventi.

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

Eliminare una sottoscrizione di eventi per una sottoscrizione di Azure.

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

Eliminare una sottoscrizione di eventi per un gruppo di risorse.

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

Eliminare una sottoscrizione di eventi per un account di archiviazione.

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

Parametri necessari

--name -n

Nome della sottoscrizione di eventi.

Parametri facoltativi

--source-resource-id

Identificatore completo della risorsa di Azure la cui sottoscrizione di eventi deve essere eliminata.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az eventgrid event-subscription list

Modifica

Elencare le sottoscrizioni di eventi.

Griglia di eventi supporta sottoscrizioni di eventi internazionali e globali: le sottoscrizioni di eventi nelle risorse regionali (ad esempio gli account Archiviazione o gli argomenti di Griglia di eventi) sono a livello di area, mentre le sottoscrizioni di eventi sulle risorse globali (ad esempio una sottoscrizione di Azure o un gruppo di risorse) sono globali. Di conseguenza, è possibile elencare le sottoscrizioni di eventi in diversi modi:

Per elencare in base all'ID risorsa della risorsa di cui si desidera elencare le sottoscrizioni di eventi, specificare il parametro --source-resource-id. Non è necessario specificare altri parametri.
Per elencare in base a un tipo di argomento (ad esempio, account di archiviazione), specificare il parametro --topic-type insieme al parametro --location (ad esempio "westus2"). Per i tipi di argomento globali ,ad esempio "Microsoft.Resources.Subscriptions", specificare il valore della posizione come "globale".
Per elencare tutte le sottoscrizioni di eventi in un'area (in tutti i tipi di argomenti), specificare solo il parametro --location.
Per entrambi i #2 e 3 precedenti, per filtrare solo in base a un gruppo di risorse, è anche possibile specificare il parametro --resource-group.

az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Esempio

Elencare tutte le sottoscrizioni di eventi create per un argomento di Griglia di eventi.

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

Elencare tutte le sottoscrizioni di eventi create per un account di archiviazione.

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

Elencare tutte le sottoscrizioni di eventi create per una sottoscrizione di Azure.

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

Elencare tutte le sottoscrizioni di eventi create per un gruppo di risorse.

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

Elencare tutte le sottoscrizioni di eventi per un dominio di Griglia di eventi.

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

Elencare tutte le sottoscrizioni di eventi per un argomento di dominio di Griglia di eventi.

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

Elencare tutte le sottoscrizioni di eventi Archiviazione (nella sottoscrizione di Azure attualmente selezionata) in westus2.

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

Elencare tutte le sottoscrizioni di eventi Archiviazione (nel gruppo di risorse specificato) in westus2.

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

Elencare tutte le sottoscrizioni di eventi internazionali o globali (nella sottoscrizione di Azure attualmente selezionata).

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

Elencare tutte le sottoscrizioni di eventi internazionali o globali in un gruppo di risorse specificato.

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

Elencare tutte le sottoscrizioni di eventi per un dominio di Griglia di eventi il cui nome contiene il modello "XYZ"

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

Elencare tutte le sottoscrizioni di eventi per un dominio di Griglia di eventi ad eccezione della sottoscrizione di eventi con nome "name1"

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

Parametri facoltativi

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--odata-query

Query OData utilizzata per filtrare i risultati dell'elenco. Il filtro è attualmente consentito solo per la proprietà Name. Le operazioni supportate includono: CONTAINS, eq (per uguale), ne (per non uguale), AND, OR e NOT.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--source-resource-id

Identificatore completo della risorsa di Azure la cui sottoscrizione di eventi deve essere elencata.

--topic-type-name

Nome del tipo di argomento le cui sottoscrizioni di eventi devono essere elencate. Quando viene specificato, è necessario specificare anche --location.

Esempio 1: Elencare tutte le sottoscrizioni di eventi Archiviazione in WestUS2 --resource-group TestRG --topic-type-name Microsoft.Archiviazione. Archiviazione Accounts --location westus2 Esempio 2: Elencare tutte le sottoscrizioni di eventi nelle sottoscrizioni di Azure --topic-type-name Microsoft.Resources.Subscriptions --location global.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az eventgrid event-subscription list (eventgrid estensione)

Anteprima

Il gruppo di comandi 'az eventgrid' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare le sottoscrizioni di eventi.

Per elencare in base all'ID risorsa della risorsa di cui si desidera elencare le sottoscrizioni di eventi, specificare il parametro --source-resource-id. Non è necessario specificare altri parametri.
Per elencare in base a un tipo di argomento (ad esempio, account di archiviazione), specificare il parametro --topic-type insieme al parametro --location (ad esempio "westus2"). Per i tipi di argomento globali ,ad esempio "Microsoft.Resources.Subscriptions", specificare il valore della posizione come "globale".
Per elencare tutte le sottoscrizioni di eventi in un'area (in tutti i tipi di argomenti), specificare solo il parametro --location.
Per entrambi i #2 e 3 precedenti, per filtrare solo in base a un gruppo di risorse, è anche possibile specificare il parametro --resource-group.

az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Esempio

Elencare tutte le sottoscrizioni di eventi create per un argomento di Griglia di eventi.

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

Elencare tutte le sottoscrizioni di eventi create per un account di archiviazione.

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

Elencare tutte le sottoscrizioni di eventi create per una sottoscrizione di Azure.

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

Elencare tutte le sottoscrizioni di eventi create per un gruppo di risorse.

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

Elencare tutte le sottoscrizioni di eventi per un dominio di Griglia di eventi.

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

Elencare tutte le sottoscrizioni di eventi per un argomento di dominio di Griglia di eventi.

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

Elencare tutte le sottoscrizioni di eventi Archiviazione (nella sottoscrizione di Azure attualmente selezionata) in westus2.

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

Elencare tutte le sottoscrizioni di eventi Archiviazione (nel gruppo di risorse specificato) in westus2.

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

Elencare tutte le sottoscrizioni di eventi internazionali o globali (nella sottoscrizione di Azure attualmente selezionata).

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

Elencare tutte le sottoscrizioni di eventi internazionali o globali in un gruppo di risorse specificato.

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

Elencare tutte le sottoscrizioni di eventi per un dominio di Griglia di eventi il cui nome contiene il modello "XYZ"

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

Elencare tutte le sottoscrizioni di eventi per un dominio di Griglia di eventi ad eccezione della sottoscrizione di eventi con nome "name1"

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

Parametri facoltativi

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--odata-query

Query utilizzata per filtrare i risultati usando la sintassi OData.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--source-resource-id

Identificatore completo della risorsa di Azure la cui sottoscrizione di eventi deve essere elencata.

--topic-type-name

Nome del tipo di argomento le cui sottoscrizioni di eventi devono essere elencate. Quando viene specificato, è necessario specificare anche --location.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az eventgrid event-subscription show

Modifica

Ottenere i dettagli di una sottoscrizione di eventi.

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

Esempio

Visualizzare i dettagli di una sottoscrizione di eventi per un argomento di Griglia di eventi.

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

Visualizzare i dettagli di una sottoscrizione di eventi per una sottoscrizione di Azure.

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

Visualizzare i dettagli di una sottoscrizione di eventi per un gruppo di risorse.

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

Visualizzare i dettagli di una sottoscrizione di eventi per un account di archiviazione.

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

Visualizzare i dettagli di una sottoscrizione di eventi per un gruppo di risorse, inclusi eventuali segreti dell'attributo di recapito statico.

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

Parametri necessari

--name -n

Nome della sottoscrizione di eventi.

Parametri facoltativi

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

Indicare se devono essere restituiti segreti dell'attributo di recapito statico. True se il flag è presente.

valori accettati: false, true

valore predefinito: False

--include-full-endpoint-url

Specificare per indicare se deve essere restituito l'URL completo dell'endpoint. True se il flag è presente.

valori accettati: false, true

valore predefinito: False

--source-resource-id

Identificatore completo della risorsa di Azure la cui sottoscrizione di eventi deve essere visualizzata.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az eventgrid event-subscription show (eventgrid estensione)

Anteprima

Il gruppo di comandi 'az eventgrid' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere i dettagli di una sottoscrizione di eventi.

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

Esempio

Visualizzare i dettagli di una sottoscrizione di eventi per un argomento di Griglia di eventi.

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

Visualizzare i dettagli di una sottoscrizione di eventi per una sottoscrizione di Azure.

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

Visualizzare i dettagli di una sottoscrizione di eventi per un gruppo di risorse.

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

Visualizzare i dettagli di una sottoscrizione di eventi per un account di archiviazione.

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

Parametri necessari

--name -n

Nome della sottoscrizione di eventi.

Parametri facoltativi

--include-full-endpoint-url

Specificare per indicare se deve essere restituito l'URL completo dell'endpoint. True se il flag è presente.

valori accettati: false, true

valore predefinito: False

--source-resource-id

Identificatore completo della risorsa di Azure la cui sottoscrizione di eventi deve essere visualizzata.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az eventgrid event-subscription update

Modifica

Aggiornare una sottoscrizione di eventi.

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]

Esempio

Aggiornare una sottoscrizione di eventi per un argomento di Griglia di eventi per specificare un nuovo endpoint.

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

Aggiornare una sottoscrizione di eventi per una sottoscrizione di Azure per specificare un nuovo filtro subject-ends-with.

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

Aggiornare una sottoscrizione di eventi per un gruppo di risorse per specificare un nuovo endpoint e un nuovo filtro con oggetto.Update an event subscription for a resource group to specify a new endpoint and a new subject-ends-with 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

Aggiornare una sottoscrizione di eventi per un account di archiviazione per specificare un nuovo elenco di tipi di evento inclusi.

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

Aggiornare una sottoscrizione di eventi per un account di archiviazione per includere una destinazione non recapitabili.

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

Aggiornare una sottoscrizione di eventi per un account di archiviazione usando filtri avanzati.

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

Aggiornare una sottoscrizione di eventi per un account di archiviazione per includere il valore ttl del messaggio impostato su 5 minuti.

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

Aggiornare una sottoscrizione di eventi con il filtro avanzato abilitato nelle matrici

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

Parametri necessari

--name -n

Nome della sottoscrizione di eventi.

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

valore predefinito: []

--advanced-filter

Un filtro avanzato consente di filtrare gli eventi in base a una proprietà evento specifica.

--deadletter-endpoint

ID risorsa di Azure di una destinazione del contenitore BLOB Archiviazione di Azure in cui EventGrid deve generare eventi non recapitabili per questa sottoscrizione di eventi.

--deadletter-identity

Anteprima

Tipo di identità della risorsa di destinazione non recapitabili.

valori accettati: systemassigned

--deadletter-identity-endpoint

ID risorsa di Azure di una destinazione del contenitore BLOB Archiviazione di Azure con identità in cui EventGrid deve generare eventi non recapitabili per questa sottoscrizione di eventi.

--delivery-attribute-mapping

--delivery-identity

Anteprima

Tipo di identità della risorsa di destinazione del recapito(ad esempio, coda di archiviazione o hub eventi).

valori accettati: systemassigned

--delivery-identity-endpoint

Anteprima

--delivery-identity-endpoint-type

Anteprima

Tipo dell'endpoint di destinazione con identità della risorsa.

valori accettati: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

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

Consente di valutare i filtri avanzati rispetto a una matrice di valori anziché prevedere un valore singolare.

valori accettati: false, true

--endpoint

--endpoint-type

Tipo dell'endpoint di destinazione.

valore predefinito: webhook

--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

valore predefinito: False

--included-event-types

--labels

Elenco delimitato da spazi di etichette da associare a questa sottoscrizione di eventi.

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

Archiviazione tempo di attesa del messaggio della coda in secondi.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

valore predefinito: []

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

valore predefinito: []

--source-resource-id

Identificatore completo della risorsa di Azure la cui sottoscrizione di eventi deve essere aggiornata.

--subject-begins-with

Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un prefisso. I caratteri jolly non sono supportati.

--subject-ends-with

Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un suffisso. I caratteri jolly non sono supportati.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az eventgrid event-subscription update (eventgrid estensione)

Anteprima

Il gruppo di comandi 'az eventgrid' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare una sottoscrizione di eventi.

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]

Esempio

Aggiornare una sottoscrizione di eventi per un argomento di Griglia di eventi per specificare un nuovo endpoint.

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

Aggiornare una sottoscrizione di eventi per una sottoscrizione di Azure per specificare un nuovo filtro subject-ends-with.

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

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

Aggiornare una sottoscrizione di eventi per un account di archiviazione per specificare un nuovo elenco di tipi di evento inclusi.

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

Aggiornare una sottoscrizione di eventi per un account di archiviazione per includere una destinazione non recapitabili.

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

Aggiornare una sottoscrizione di eventi per un account di archiviazione usando filtri avanzati.

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

Parametri necessari

--name -n

Nome della sottoscrizione di eventi.

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, string or JSON string>.

valore predefinito: []

--advanced-filter

Un filtro avanzato consente di filtrare gli eventi in base a una proprietà evento specifica.

--deadletter-endpoint

ID risorsa di Azure di una destinazione del contenitore BLOB Archiviazione di Azure in cui EventGrid deve generare eventi non recapitabili per questa sottoscrizione di eventi.

--deadletter-identity

Tipo di identità della risorsa di destinazione non recapitabili.

valori accettati: systemassigned

--deadletter-identity-endpoint

ID risorsa di Azure di una destinazione del contenitore BLOB Archiviazione di Azure con identità in cui EventGrid deve generare eventi non recapitabili per questa sottoscrizione di eventi.

--delivery-identity

Tipo di identità della risorsa di destinazione del recapito(ad esempio, coda di archiviazione o hub eventi).

valori accettati: systemassigned

--delivery-identity-endpoint

--delivery-identity-endpoint-type

Tipo dell'endpoint di destinazione con identità della risorsa.

valori accettati: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

--endpoint

--endpoint-type

Tipo dell'endpoint di destinazione.

valori accettati: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

valore predefinito: webhook

--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

valore predefinito: False

--included-event-types

--labels

Elenco delimitato da spazi di etichette da associare a questa sottoscrizione di eventi.

--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list <indexToRemove> OR --remove propertyToRemove.

valore predefinito: []

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=<value>.

valore predefinito: []

--source-resource-id

Identificatore completo della risorsa di Azure la cui sottoscrizione di eventi deve essere aggiornata.

--subject-begins-with

Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un prefisso. I caratteri jolly non sono supportati.

--subject-ends-with

Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un suffisso. I caratteri jolly non sono supportati.

Parametri globali

--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

valori accettati: json, jsonc, none, table, tsv, yaml, yamlc

valore predefinito: json

--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az eventgrid event-subscription

Comandi

az eventgrid event-subscription create

Esempio

Parametri necessari

Parametri facoltativi

az eventgrid event-subscription create (eventgrid estensione)

Esempio

Parametri necessari

Parametri facoltativi

az eventgrid event-subscription delete

Esempio

Parametri necessari

Parametri facoltativi

az eventgrid event-subscription delete (eventgrid estensione)

Esempio

Parametri necessari

Parametri facoltativi

az eventgrid event-subscription list

Esempio

Parametri facoltativi

az eventgrid event-subscription list (eventgrid estensione)

Esempio

Parametri facoltativi

az eventgrid event-subscription show

Esempio

Parametri necessari

Parametri facoltativi

az eventgrid event-subscription show (eventgrid estensione)

Esempio

Parametri necessari

Parametri facoltativi

az eventgrid event-subscription update

Esempio

Parametri necessari

Parametri facoltativi

az eventgrid event-subscription update (eventgrid estensione)

Esempio

Parametri necessari

Parametri facoltativi

Commenti e suggerimenti

Risorse aggiuntive