Condividi tramite

az eventgrid namespace topic event-subscription

  • Anteprima
  • Riferimento

Nota

Questo riferimento fa parte dell'estensione griglia di eventi per l'interfaccia della riga di comando di Azure (versione 2.51.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az eventgrid namespace topic event-subscription . Altre informazioni sulle estensioni.

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

Gestire la sottoscrizione di eventi dell'argomento dello spazio dei nomi eventgrid.

Comandi

Nome Descrizione Tipo Status
az eventgrid namespace topic event-subscription create

Creare una sottoscrizione di eventi di un argomento dello spazio dei nomi.

 Estensione Anteprima
az eventgrid namespace topic event-subscription delete

Eliminare una sottoscrizione di eventi esistente di un argomento dello spazio dei nomi.

 Estensione Anteprima
az eventgrid namespace topic event-subscription list

Elencare le sottoscrizioni di eventi che appartengono a un argomento specifico dello spazio dei nomi.

 Estensione Anteprima
az eventgrid namespace topic event-subscription show

Visualizzare una sottoscrizione di eventi di un argomento dello spazio dei nomi.

 Estensione Anteprima
az eventgrid namespace topic event-subscription update

Aggiornare una sottoscrizione di eventi di un argomento dello spazio dei nomi.

 Estensione Anteprima
az eventgrid namespace topic event-subscription wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

 Estensione Anteprima

az eventgrid namespace topic event-subscription create

Anteprima

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

Creare una sottoscrizione di eventi di un argomento dello spazio dei nomi.

az eventgrid namespace topic event-subscription create --event-subscription-name
                                                       --namespace-name
                                                       --resource-group
                                                       --topic-name
                                                       [--delivery-configuration]
                                                       [--event-delivery-schema {CloudEventSchemaV1_0}]
                                                       [--filters-configuration]
                                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]

Esempio

Crea sottoscrizione di eventi

az eventgrid namespace topic event-subscription create -g rg --topic-name topic -n event-subscription --namespace-name name --delivery-configuration "{deliveryMode:Queue,queue:{receiveLockDurationInSeconds:60,maxDeliveryCount:4,eventTimeToLive:P1D}}"

Parametri necessari

--event-subscription-name --name -n

Nome della sottoscrizione di eventi da creare. I nomi delle sottoscrizioni di eventi devono avere una lunghezza compresa tra 3 e 100 caratteri e usare solo lettere alfanumerici.

--namespace-name

Nome dello spazio dei nomi.

--resource-group -g

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

--topic-name

Nome dell'argomento dello spazio dei nomi.

Parametri facoltativi

--delivery-configuration

Informazioni sulla configurazione di recapito della sottoscrizione di eventi. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--event-delivery-schema

Schema di recapito degli eventi per la sottoscrizione di eventi.

Valori accettati: CloudEventSchemaV1_0
--filters-configuration

Informazioni sul filtro per la sottoscrizione di eventi. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
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 namespace topic event-subscription delete

Anteprima

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

Eliminare una sottoscrizione di eventi esistente di un argomento dello spazio dei nomi.

az eventgrid namespace topic event-subscription delete [--event-subscription-name]
                                                       [--ids]
                                                       [--namespace-name]
                                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                       [--resource-group]
                                                       [--subscription]
                                                       [--topic-name]
                                                       [--yes]

Esempio

Eliminare la sottoscrizione di eventi

az eventgrid namespace topic event-subscription delete -g rg --topic-name topic -n event-subscription --namespace-name name

Parametri facoltativi

--event-subscription-name --name -n

Nome della sottoscrizione di eventi da creare. I nomi delle sottoscrizioni di eventi devono avere una lunghezza compresa tra 3 e 100 caratteri e usare solo lettere alfanumerici.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--namespace-name

Nome dello spazio dei nomi.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--topic-name

Nome dell'argomento dello spazio dei nomi.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
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 namespace topic event-subscription list

Anteprima

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

Elencare le sottoscrizioni di eventi che appartengono a un argomento specifico dello spazio dei nomi.

az eventgrid namespace topic event-subscription list --namespace-name
                                                     --resource-group
                                                     --topic-name
                                                     [--filter]
                                                     [--max-items]
                                                     [--next-token]
                                                     [--top]

Esempio

Elencare la sottoscrizione di eventi

az eventgrid namespace topic event-subscription list -g rg --topic-name topic --namespace-name name

Parametri necessari

--namespace-name

Nome dello spazio dei nomi.

--resource-group -g

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

--topic-name

Nome dell'argomento dello spazio dei nomi.

Parametri facoltativi

--filter

Query utilizzata per filtrare i risultati della ricerca usando la sintassi OData. Il filtro è consentito solo per la proprietà 'name' e con un numero limitato di operazioni OData. Queste operazioni sono: la funzione 'contains' e le operazioni logiche seguenti: not, e, o, eq (per uguale) e ne (per non uguale). Non sono supportate operazioni aritmetiche. Di seguito è riportato un esempio di filtro valido: $filter=contains(namE, 'PATTERN') e nome ne 'PATTERN-1'. Di seguito non è riportato un esempio di filtro valido: $filter=location eq 'westus'.

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token nell'argomento --next-token di un comando successivo.

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

--top

Numero di risultati da restituire per pagina per l'operazione di elenco. L'intervallo valido per il parametro top è compreso tra 1 e 100. Se non specificato, il numero predefinito di risultati da restituire è 20 elementi per pagina.

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 namespace topic event-subscription show

Anteprima

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

Visualizzare una sottoscrizione di eventi di un argomento dello spazio dei nomi.

az eventgrid namespace topic event-subscription show [--event-subscription-name]
                                                     [--ids]
                                                     [--namespace-name]
                                                     [--resource-group]
                                                     [--subscription]
                                                     [--topic-name]

Esempio

Mostra sottoscrizione di eventi

az eventgrid namespace topic event-subscription show -g rg --topic-name topic -n event-subscription --namespace-name name

Parametri facoltativi

--event-subscription-name --name -n

Nome della sottoscrizione di eventi da creare. I nomi delle sottoscrizioni di eventi devono avere una lunghezza compresa tra 3 e 100 caratteri e usare solo lettere alfanumerici.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--namespace-name

Nome dello spazio dei nomi.

--resource-group -g

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

--subscription

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

--topic-name

Nome dell'argomento dello spazio dei nomi.

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 namespace topic event-subscription update

Anteprima

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

Aggiornare una sottoscrizione di eventi di un argomento dello spazio dei nomi.

az eventgrid namespace topic event-subscription update [--add]
                                                       [--delivery-configuration]
                                                       [--event-delivery-schema {CloudEventSchemaV1_0}]
                                                       [--event-subscription-name]
                                                       [--filters-configuration]
                                                       [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                                       [--ids]
                                                       [--namespace-name]
                                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                                       [--remove]
                                                       [--resource-group]
                                                       [--set]
                                                       [--subscription]
                                                       [--topic-name]

Esempio

Aggiornare la sottoscrizione di eventi

az eventgrid namespace topic event-subscription create -g rg --topic-name topic -n event-subscription --namespace-name name --filters-configuration "{includedEventTypes:['All']}"

Parametri facoltativi

--add

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

--delivery-configuration

Informazioni sulla configurazione di recapito della sottoscrizione di eventi. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--event-delivery-schema

Schema di recapito degli eventi per la sottoscrizione di eventi.

Valori accettati: CloudEventSchemaV1_0
--event-subscription-name --name -n

Nome della sottoscrizione di eventi da creare. I nomi delle sottoscrizioni di eventi devono avere una lunghezza compresa tra 3 e 100 caratteri e usare solo lettere alfanumerici.

--filters-configuration

Informazioni sul filtro per la sottoscrizione di eventi. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--force-string

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

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--namespace-name

Nome dello spazio dei nomi.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--remove

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

--resource-group -g

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

--set

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

--subscription

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

--topic-name

Nome dell'argomento dello spazio dei nomi.

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 namespace topic event-subscription wait

Anteprima

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

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

az eventgrid namespace topic event-subscription wait [--created]
                                                     [--custom]
                                                     [--deleted]
                                                     [--event-subscription-name]
                                                     [--exists]
                                                     [--ids]
                                                     [--interval]
                                                     [--namespace-name]
                                                     [--resource-group]
                                                     [--subscription]
                                                     [--timeout]
                                                     [--topic-name]
                                                     [--updated]

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--event-subscription-name --name -n

Nome della sottoscrizione di eventi da creare. I nomi delle sottoscrizioni di eventi devono avere una lunghezza compresa tra 3 e 100 caratteri e usare solo lettere alfanumerici.

--exists

Attendere che la risorsa esista.

Valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--namespace-name

Nome dello spazio dei nomi.

--resource-group -g

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

--subscription

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

--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--topic-name

Nome dell'argomento dello spazio dei nomi.

--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False
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.