az eventgrid topic

Riferimento

Gestire gli argomenti di Griglia di eventi di Azure.

Comandi

Nome	Descrizione	Tipo	Status
az eventgrid topic create	Creare un argomento.	Nucleo	GA
az eventgrid topic delete	Eliminare un argomento.	Nucleo	GA
az eventgrid topic event-subscription	Gestire le sottoscrizioni di eventi dell'argomento.	Nucleo	GA
az eventgrid topic event-subscription create	Creare una nuova sottoscrizione di eventi per un argomento.	Nucleo	GA
az eventgrid topic event-subscription delete	Eliminare una sottoscrizione di eventi di un argomento.	Nucleo	GA
az eventgrid topic event-subscription list	Elencare le sottoscrizioni di eventi di un argomento specifico.	Nucleo	GA
az eventgrid topic event-subscription show	Ottenere i dettagli di una sottoscrizione di eventi di un argomento.	Nucleo	GA
az eventgrid topic event-subscription update	Aggiornare una sottoscrizione di eventi di un argomento.	Nucleo	GA
az eventgrid topic key	Gestire le chiavi di accesso condiviso di un argomento.	Nucleo	GA
az eventgrid topic key list	Elencare le chiavi di accesso condiviso di un argomento.	Nucleo	GA
az eventgrid topic key regenerate	Rigenerare una chiave di accesso condiviso di un argomento.	Nucleo	GA
az eventgrid topic list	Elencare gli argomenti disponibili.	Nucleo	GA
az eventgrid topic show	Ottenere i dettagli di un argomento.	Nucleo	GA
az eventgrid topic update	Aggiornare un argomento.	Nucleo	GA

az eventgrid topic create

Modifica

Creare un argomento.

az eventgrid topic create --name
                          --resource-group
                          [--extended-location-name]
                          [--extended-location-type {customlocation}]
                          [--identity {noidentity, systemassigned}]
                          [--inbound-ip-rules]
                          [--input-mapping-default-values]
                          [--input-mapping-fields]
                          [--input-schema {cloudeventschemav1_0, customeventschema, eventgridschema}]
                          [--kind {azure, azurearc}]
                          [--location]
                          [--mi-system-assigned]
                          [--mi-user-assigned]
                          [--public-network-access {disabled, enabled}]
                          [--sku {basic, premium}]
                          [--tags]

Esempio

Creare un nuovo argomento.

az eventgrid topic create -g rg1 --name topic1 -l westus2

Creare un nuovo argomento con mapping di input personalizzati.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --input-schema customeventschema --input-mapping-fields topic=myTopicField eventType=myEventTypeField --input-mapping-default-values subject=DefaultSubject dataVersion=1.0

Creare un nuovo argomento che accetti eventi pubblicati nello schema CloudEvents V1.0.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --input-schema cloudeventschemav1_0

Creare un nuovo argomento che consenta regole IP in ingresso specifiche con sku basic e identità assegnata dal sistema

az eventgrid topic create -g rg1 --name topic1 -l westus2 --public-network-access enabled --inbound-ip-rules 10.0.0.0/8 Allow --inbound-ip-rules 10.2.0.0/8 Allow --sku Basic --identity systemassigned

Creare un nuovo argomento in Azure.

az eventgrid topic create -g rg1 --name topic1 -l westus2

Creare un nuovo argomento in Azure.

az eventgrid topic create -g rg1 --name topic1 -l westus2 --kind azure

Creare un nuovo argomento in AzureArc destinato a una posizione personalizzata.

az eventgrid topic create -g rg1 --name topic1 -l eastus2euap --kind azurearc --extended-location-name /subscriptions/<subid>/resourcegroups/<rgname>/providers/microsoft.extendedlocation/customlocations/<cust-loc-name> --extended-location-type customlocation --input-schema CloudEventSchemaV1_0

Parametri necessari

--name -n

Nome dell'argomento.

--resource-group -g

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

Parametri facoltativi

--extended-location-name

Anteprima

Nome della posizione estesa se kind==azurearc.

--extended-location-type

Anteprima

Tipo di posizione estesa se kind==azurearc.

Valori accettati: customlocation

--identity

Anteprima Deprecato

L'argomento 'identity' è stato deprecato e verrà rimosso in una versione futura.

Tipo di identità gestita per la risorsa. Sarà deprecato e sostituito da --mi-system-assigned-identity in futuro.

Valori accettati: noidentity, systemassigned

--inbound-ip-rules

Elenco delle regole IP in ingresso.

Elenco di regole IP in ingresso che specificano l'indirizzo IP nella notazione CIDR, ad esempio 10.0.0.0/8 insieme all'azione corrispondente da eseguire in base alla corrispondenza o nessuna corrispondenza di IpMask. I valori possibili includono - Consenti.

--input-mapping-default-values

Quando input-schema viene specificato come customeventschema, questo parametro può essere usato per specificare i mapping di input in base ai valori predefiniti. È possibile usare questo parametro quando lo schema personalizzato non include un campo che corrisponde a uno dei tre campi supportati da questo parametro. Specificare i mapping separati da spazi nel formato 'key=value'. I nomi delle chiavi consentiti sono 'subject', 'eventtype', 'dataversion'. I nomi dei valori corrispondenti devono specificare i valori predefiniti da usare per il mapping e verranno usati solo quando l'evento pubblicato non ha un mapping valido per un determinato campo.

--input-mapping-fields

Quando input-schema viene specificato come customeventschema, questo parametro viene usato per specificare i mapping di input in base ai nomi dei campi. Specificare i mapping separati da spazi nel formato 'key=value'. I nomi delle chiavi consentiti sono 'id', 'topic', 'eventtime', 'subject', 'eventtype', 'dataversion'. I nomi dei valori corrispondenti devono specificare i nomi dei campi nello schema di input personalizzato. Se non viene fornito un mapping per "id" o "eventtime", Griglia di eventi genererà automaticamente un valore predefinito per questi due campi.

--input-schema

Schema in cui gli eventi in ingresso verranno pubblicati in questo argomento/dominio. Se si specifica customeventschema come valore per questo parametro, è necessario specificare anche i valori per almeno uno di --input_mapping_default_values / --input_mapping_fields.

Valori accettati: cloudeventschemav1_0, customeventschema, eventgridschema

Valore predefinito: eventgridschema

--kind

Anteprima

Tipo di risorsa dell'argomento.

Valori accettati: azure, azurearc

Valore predefinito: Azure

--location -l

Ubicazione. Valori da: az account list-locations. È possibile configurare il percorso predefinito usando az configure --defaults location=<location>.

--mi-system-assigned

La presenza di questo parametro indica che verrà usata l'identità gestita SystemAssigned.

--mi-user-assigned

Anteprima

Aggiungere identità assegnate dall'utente quando identityType è utente o misto. Questo attributo è valido per tutti i tipi di destinazione ad eccezione di StorageQueue. È possibile specificare più attributi usando più di un argomento --mi-user-assigned.

--public-network-access

Determina se il traffico è consentito in rete pubblica. Per impostazione predefinita, è abilitata. È possibile limitare ulteriormente gli indirizzi IP specifici configurando .

Valori accettati: disabled, enabled

--sku

Anteprima

Nome sku della risorsa.

Valori accettati: basic, premium

Valore predefinito: Basic

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--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

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

az eventgrid topic delete

Modifica

Eliminare un argomento.

az eventgrid topic delete [--ids]
                          [--name]
                          [--resource-group]
                          [--subscription]

Esempio

Eliminare un argomento.

az eventgrid topic delete -g rg1 --name topic1

Parametri facoltativi

--ids

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

--name -n

Nome dell'argomento.

--resource-group -g

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

--subscription

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

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--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

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

az eventgrid topic list

Modifica

Elencare gli argomenti disponibili.

az eventgrid topic list [--odata-query]
                        [--resource-group]

Esempio

Elencare tutti gli argomenti nella sottoscrizione di Azure corrente.

az eventgrid topic list

Elencare tutti gli argomenti in un gruppo di risorse.

az eventgrid topic list -g rg1

Elencare tutti gli argomenti in un gruppo di risorse il cui nome contiene il modello "XYZ"

az eventgrid topic list -g rg1 --odata-query "Contains(name, 'XYZ')"

Elencare tutti gli argomenti in un gruppo di risorse ad eccezione del dominio con nome "name1"

az eventgrid topic list -g rg1 --odata-query "NOT (name eq 'name1')"

Parametri facoltativi

--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 usando az configure --defaults group=<name>.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--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

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

az eventgrid topic show

Modifica

Ottenere i dettagli di un argomento.

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

Esempio

Visualizzare i dettagli di un argomento.

az eventgrid topic show -g rg1 -n topic1

Visualizzare i dettagli di un argomento in base all'ID risorsa.

az eventgrid topic show --ids /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Parametri facoltativi

--ids

--name -n

Nome dell'argomento.

--resource-group -g

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

--subscription

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

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--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

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

az eventgrid topic update

Modifica

Aggiornare un argomento.

az eventgrid topic update [--identity {noidentity, systemassigned}]
                          [--ids]
                          [--inbound-ip-rules]
                          [--mi-system-assigned]
                          [--mi-user-assigned]
                          [--name]
                          [--public-network-access {disabled, enabled}]
                          [--resource-group]
                          [--sku {basic, premium}]
                          [--subscription]
                          [--tags]

Esempio

Aggiornare le proprietà di un argomento esistente con nuove informazioni di sku, identità e accesso alla rete pubblica.

az eventgrid topic update -g rg1 --name topic1 --sku Premium --identity systemassigned --public-network-access enabled --inbound-ip-rules 10.0.0.0/8 Allow --inbound-ip-rules 10.2.0.0/8 Allow --tags Dept=IT --sku basic

Parametri facoltativi

--identity

Anteprima Deprecato

L'argomento 'identity' è stato deprecato e verrà rimosso in una versione futura.

Tipo di identità gestita per la risorsa. Sarà deprecato e sostituito da --mi-system-assigned-identity in futuro.

Valori accettati: noidentity, systemassigned

--ids

--inbound-ip-rules

--mi-system-assigned

La presenza di questo parametro indica che verrà usata l'identità gestita SystemAssigned.

--mi-user-assigned

Anteprima

--name -n

Nome dell'argomento.

--public-network-access

Determina se il traffico è consentito in rete pubblica. Per impostazione predefinita, è abilitata. È possibile limitare ulteriormente gli indirizzi IP specifici configurando .

Valori accettati: disabled, enabled

--resource-group -g

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

--sku

Anteprima

Nome sku della risorsa.

Valori accettati: basic, premium

--subscription

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

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

Parametri globali

--debug

Aumentare il livello di dettaglio della registrazione per visualizzare tutti i log di debug.

--help -h

Mostra questo messaggio della Guida e esci.

--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

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

Condividi tramite

az eventgrid topic

Comandi

az eventgrid topic create

Esempio

Parametri necessari

Parametri facoltativi

az eventgrid topic delete

Esempio

Parametri facoltativi

az eventgrid topic list

Esempio

Parametri facoltativi

az eventgrid topic show

Esempio

Parametri facoltativi

az eventgrid topic update

Esempio

Parametri facoltativi

Risorse aggiuntive