az eventgrid topic event-subscription
Gestire le sottoscrizioni di eventi dell'argomento.
Comandi
Nome | Descrizione | Tipo | Status |
---|---|---|---|
az eventgrid topic event-subscription create |
Creare una nuova sottoscrizione di eventi per un argomento. |
Memoria centrale | Disponibilità generale |
az eventgrid topic event-subscription delete |
Eliminare una sottoscrizione di eventi di un argomento. |
Memoria centrale | Disponibilità generale |
az eventgrid topic event-subscription list |
Elencare le sottoscrizioni di eventi di un argomento specifico. |
Memoria centrale | Disponibilità generale |
az eventgrid topic event-subscription show |
Ottenere i dettagli di una sottoscrizione di eventi di un argomento. |
Memoria centrale | Disponibilità generale |
az eventgrid topic event-subscription update |
Aggiornare una sottoscrizione di eventi di un argomento. |
Memoria centrale | Disponibilità generale |
az eventgrid topic event-subscription create
Creare una nuova sottoscrizione di eventi per un argomento.
az eventgrid topic event-subscription create --name
--resource-group
--topic-name
[--aad-app-id]
[--aad-tenant-id]
[--advanced-filter]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--enable-advanced-filtering-on-arrays {false, true}]
[--endpoint]
[--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
[--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
[--event-ttl]
[--expiration-date]
[--included-event-types]
[--labels]
[--max-delivery-attempts]
[--max-events-per-batch]
[--pref-batch-size-kb]
[--qttl]
[--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 topic event-subscription create --name es1 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi con un filtro che specifica un prefisso del soggetto.
az eventgrid topic event-subscription create --name es4 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi, usando i filtri predefiniti e CloudEvent V 1.0 come schema di recapito.
az eventgrid topic event-subscription create -n es2 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi, con una destinazione non recapitata e un criterio di ripetizione dei tentativi personalizzati con un massimo di 10 tentativi di recapito e un TTL evento di 2 ore (a condizione che si verifichi in precedenza) e la data di scadenza.
az eventgrid topic event-subscription create --name es2 \
-g rg1 --topic-name topic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
--max-delivery-attempts 10 --event-ttl 120 --expiration-date "2022-10-31"
Creare una nuova sottoscrizione di eventi per un argomento di Griglia di eventi usando webhook abilitato per Azure Active Directory come destinazione.
az eventgrid topic event-subscription create --name es1 \
-g rg1 --topic-name 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 topic event-subscription create -n es1 \
-g rg1 --topic-name 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 Archiviazione Coda come destinazione con una durata di 5 minuti
az eventgrid topic event-subscription create -n es1 \
-g rg1 --topic-name 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 e abilitare il filtro avanzato per le matrici
az eventgrid topic event-subscription create -n es1 \
-g rg1 --topic-name topic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
--enable-advanced-filtering-on-arrays true
Parametri necessari
Nome della sottoscrizione di eventi.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Nome dell'argomento.
Parametri facoltativi
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.
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.
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.
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.
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.
Consente di valutare i filtri avanzati rispetto a una matrice di valori anziché prevedere un valore singolare.
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.
Tipo dell'endpoint di destinazione.
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).
Durata dell'evento (in minuti). Deve essere un numero compreso tra 1 e 1440.
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.
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".
Elenco delimitato da spazi di etichette da associare a questa sottoscrizione di eventi.
Numero massimo di tentativi di recapito. Deve essere un numero compreso tra 1 e 30.
Numero massimo di eventi in un batch. Deve essere un numero compreso tra 1 e 5000.
Dimensioni batch preferite in kilobyte. Deve essere un numero compreso tra 1 e 1024.
Archiviazione tempo di attesa del messaggio della coda in secondi.
Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un prefisso. I caratteri jolly non sono supportati.
Specificare per indicare se i campi oggetto devono essere confrontati in modo con distinzione tra maiuscole e minuscole. True se il flag è presente.
Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un suffisso. I caratteri jolly non sono supportati.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az eventgrid topic event-subscription delete
Eliminare una sottoscrizione di eventi di un argomento.
az eventgrid topic event-subscription delete --name
--resource-group
--topic-name
[--yes]
Esempio
Eliminare una sottoscrizione di eventi per un argomento di Griglia di eventi.
az eventgrid topic event-subscription delete --name es1 \
-g rg1 --topic-name topic1 \
Parametri necessari
Nome della sottoscrizione di eventi.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Nome dell'argomento.
Parametri facoltativi
Indica che non è richiesta la conferma.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az eventgrid topic event-subscription list
Elencare le sottoscrizioni di eventi di un argomento specifico.
az eventgrid topic event-subscription list --resource-group
--topic-name
[--odata-query]
Esempio
Elencare tutte le sottoscrizioni di eventi create per un argomento di Griglia di eventi.
az eventgrid topic event-subscription list -g rg1 --topic-name topic1
Parametri necessari
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Nome dell'argomento.
Parametri facoltativi
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.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az eventgrid topic event-subscription show
Ottenere i dettagli di una sottoscrizione di eventi di un argomento.
az eventgrid topic event-subscription show --name
--resource-group
--topic-name
[--full-ed-url {false, true}]
[--include-attrib-secret {false, true}]
Esempio
Visualizzare i dettagli di una sottoscrizione di eventi per un argomento di Griglia di eventi.
az eventgrid topic event-subscription show --name es1 \
-g rg1 --topic-name topic1
Visualizzare i dettagli di una sottoscrizione di eventi per un argomento di Griglia di eventi includono eventuali segreti dell'attributo di recapito statico.
az eventgrid topic event-subscription show --name es1 \
-g rg1 --topic-name topic1 --include-attrib-secret
Parametri necessari
Nome della sottoscrizione di eventi.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Nome dell'argomento.
Parametri facoltativi
Specificare per indicare se deve essere restituito l'URL completo dell'endpoint. True se il flag è presente.
Indicare se devono essere restituiti segreti dell'attributo di recapito statico. True se il flag è presente.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
az eventgrid topic event-subscription update
Aggiornare una sottoscrizione di eventi di un argomento.
az eventgrid topic event-subscription update --name
--resource-group
--topic-name
[--advanced-filter]
[--deadletter-endpoint]
[--delivery-attribute-mapping]
[--enable-advanced-filtering-on-arrays {false, true}]
[--endpoint]
[--included-event-types]
[--labels]
[--qttl]
[--subject-begins-with]
[--subject-ends-with]
[--update-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
Esempio
Aggiornare una sottoscrizione di eventi per un argomento di Griglia di eventi per specificare un nuovo endpoint.
az eventgrid topic event-subscription update --name es1 \
-g rg1 --topic-name topic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Aggiornare una sottoscrizione di eventi per un argomento di Griglia di eventi per specificare un nuovo filtro subject-ends-with.
az eventgrid topic event-subscription update --name es2 \
-g rg1 --topic-name topic1 \
--subject-ends-with .jpg
Aggiornare una sottoscrizione di eventi per un argomento di Griglia di eventi per specificare un nuovo endpoint e un nuovo oggetto-end-with filtrare un nuovo elenco di tipi di eventi inclusi.
az eventgrid topic event-subscription update --name es3 \
-g rg1 --topic-name topic1 \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted
Aggiornare una sottoscrizione di eventi per un argomento Griglia di eventi di Azure, in modo da includere una destinazione non recapitabili.
az eventgrid topic event-subscription update --name es2 \
-g rg1 --topic-name topic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Aggiornare una sottoscrizione di eventi per un argomento Griglia di eventi di Azure usando filtri avanzati.
az eventgrid topic event-subscription update --name es3 \
-g rg1 --topic-name topic1 \
--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 argomento di Griglia di eventi con Archiviazione Coda come destinazione con ttl di 5 minuti
az eventgrid topic event-subscription update -n es1 \
-g rg1 --topic-name topic1 \
--storage-queue-msg-ttl 300
Aggiornare una sottoscrizione di eventi per un argomento di Griglia di eventi con filtri avanzati sulle matrici abilitate
az eventgrid topic event-subscription update -n es1 \
-g rg1 --topic-name topic1 \
--enable-advanced-filtering-on-arrays true
Parametri necessari
Nome della sottoscrizione di eventi.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
Nome dell'argomento.
Parametri facoltativi
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.
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.
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.
Consente di valutare i filtri avanzati rispetto a una matrice di valori anziché prevedere un valore singolare.
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.
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".
Elenco delimitato da spazi di etichette da associare a questa sottoscrizione di eventi.
Archiviazione tempo di attesa del messaggio della coda in secondi.
Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un prefisso. I caratteri jolly non sono supportati.
Stringa facoltativa per filtrare gli eventi per una sottoscrizione di eventi in base a un suffisso. I caratteri jolly non sono supportati.
Tipo dell'endpoint di destinazione.
Parametri globali
Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.
Visualizza questo messaggio della guida ed esce.
Mostra solo gli errori, eliminando gli avvisi.
Formato di output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID
.
Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.