az eventgrid domain event-subscription
Gestire le sottoscrizioni di eventi del dominio.
Comandi
Nome | Descrizione | Tipo | Status |
---|---|---|---|
az eventgrid domain event-subscription create |
Creare una nuova sottoscrizione di eventi per un dominio. |
Memoria centrale | Disponibilità generale |
az eventgrid domain event-subscription delete |
Eliminare una sottoscrizione di eventi di un dominio. |
Memoria centrale | Disponibilità generale |
az eventgrid domain event-subscription list |
Elencare le sottoscrizioni di eventi di un dominio specifico. |
Memoria centrale | Disponibilità generale |
az eventgrid domain event-subscription show |
Ottenere i dettagli di una sottoscrizione di eventi di un dominio. |
Memoria centrale | Disponibilità generale |
az eventgrid domain event-subscription update |
Aggiornare una sottoscrizione di eventi di un dominio. |
Memoria centrale | Disponibilità generale |
az eventgrid domain event-subscription create
Creare una nuova sottoscrizione di eventi per un dominio.
az eventgrid domain event-subscription create --domain-name
--name
--resource-group
[--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 dominio di Griglia di eventi usando i filtri predefiniti.
az eventgrid domain event-subscription create --name es1 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
Creare una nuova sottoscrizione di eventi per un dominio di Griglia di eventi, con un filtro che specifica un prefisso soggetto.
az eventgrid domain event-subscription create --name es4 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefix
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 domain event-subscription create -n es2 \
-g rg1 --domain-name domain1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0
Creare una nuova sottoscrizione di eventi per un dominio 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 domain event-subscription create --name es2 \
-g rg1 --domain-name domain1 \
--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 dominio di Griglia di eventi usando webhook abilitato per Azure Active Directory come destinazione.
az eventgrid domain event-subscription create --name es1 \
-g rg1 --domain-name domain1 \
--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 dominio di Griglia di eventi usando Funzione di Azure come destinazione.
az eventgrid domain event-subscription create -n es1 \
-g rg1 --domain-name domain1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction
Creare una nuova sottoscrizione di eventi per un dominio di Griglia di eventi usando Archiviazione Coda come destinazione con una durata di 5 minuti
az eventgrid domain event-subscription create -n es1 \
-g rg1 --domain-name domain1 \
--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 dominio di Griglia di eventi e abilitare il filtro avanzato per le matrici
az eventgrid domain event-subscription create -n es1 \
-g rg1 --domain-name domain1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
--enable-advanced-filtering-on-arrays true
Parametri necessari
Nome del dominio.
Nome della sottoscrizione di eventi.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
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 domain event-subscription delete
Eliminare una sottoscrizione di eventi di un dominio.
az eventgrid domain event-subscription delete --domain-name
--name
--resource-group
[--yes]
Esempio
Eliminare una sottoscrizione di eventi per un dominio di Griglia di eventi.
az eventgrid domain event-subscription delete --name es1 \
-g rg1 --domain-name domain1 \
Parametri necessari
Nome del dominio.
Nome della sottoscrizione di eventi.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
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 domain event-subscription list
Elencare le sottoscrizioni di eventi di un dominio specifico.
az eventgrid domain event-subscription list --domain-name
--resource-group
[--odata-query]
Esempio
Elencare tutte le sottoscrizioni di eventi create per un dominio di Griglia di eventi.
az eventgrid domain event-subscription list -g rg1 --domain-name domain1
Parametri necessari
Nome del dominio.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
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 domain event-subscription show
Ottenere i dettagli di una sottoscrizione di eventi di un dominio.
az eventgrid domain event-subscription show --domain-name
--name
--resource-group
[--full-ed-url {false, true}]
[--include-attrib-secret {false, true}]
Esempio
Visualizzare i dettagli di una sottoscrizione di eventi per un dominio di Griglia di eventi.
az eventgrid domain event-subscription show --name es1 \
-g rg1 --domain-name domain1
Visualizzare i dettagli di una sottoscrizione di eventi per un dominio di Griglia di eventi includono tutti i segreti dell'attributo di recapito statico.
az eventgrid domain event-subscription show --name es1 \
-g rg1 --domain-name domain1 --include-attrib-secret
Parametri necessari
Nome del dominio.
Nome della sottoscrizione di eventi.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
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 domain event-subscription update
Aggiornare una sottoscrizione di eventi di un dominio.
az eventgrid domain event-subscription update --domain-name
--name
--resource-group
[--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 dominio di Griglia di eventi per specificare un nuovo endpoint.
az eventgrid domain event-subscription update --name es1 \
-g rg1 --domain-name domain1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code
Aggiornare una sottoscrizione di eventi per un dominio di Griglia di eventi per specificare un nuovo filtro subject-ends-with.
az eventgrid domain event-subscription update --name es2 \
-g rg1 --domain-name domain1 \
--subject-ends-with .jpg
Aggiornare una sottoscrizione di eventi per un dominio di Griglia di eventi per specificare un nuovo endpoint e un nuovo oggetto-end con filtro un nuovo elenco di tipi di eventi inclusi.
az eventgrid domain event-subscription update --name es3 \
-g rg1 --domain-name domain1 \
--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 dominio Griglia di eventi di Azure per includere una destinazione non recapitabili.
az eventgrid domain event-subscription update --name es2 \
-g rg1 --domain-name domain1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1
Aggiornare una sottoscrizione di eventi per un dominio Griglia di eventi di Azure usando filtri avanzati.
az eventgrid domain event-subscription update --name es3 \
-g rg1 --domain-name domain1 \
--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 dominio di Griglia di eventi con Archiviazione Coda come destinazione con ttl di 5 minuti
az eventgrid domain event-subscription update -n es1 \
-g rg1 --domain-name domain1 \
--storage-queue-msg-ttl 300
Aggiornare una sottoscrizione di eventi per un dominio di Griglia di eventi con filtri avanzati sulle matrici abilitate
az eventgrid domain event-subscription update -n es1 \
-g rg1 --domain-name domain1 \
--enable-advanced-filtering-on-arrays true
Parametri necessari
Nome del dominio.
Nome della sottoscrizione di eventi.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>
.
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.