Freigeben über

az eventgrid topic

  • Referenz

Verwalten von Azure Event Grid-Themen.

Befehle

Name Beschreibung Typ Status
az eventgrid topic create

Erstellen sie ein Thema.

 Kern GA
az eventgrid topic delete

Löschen eines Themas.

 Kern GA
az eventgrid topic event-subscription

Verwalten von Ereignisabonnements des Themas.

 Kern GA
az eventgrid topic event-subscription create

Erstellen Sie ein neues Ereignisabonnement für ein Thema.

 Kern GA
az eventgrid topic event-subscription delete

Löschen eines Ereignisabonnements eines Themas.

 Kern GA
az eventgrid topic event-subscription list

Auflisten von Ereignisabonnements eines bestimmten Themas.

 Kern GA
az eventgrid topic event-subscription show

Rufen Sie die Details eines Ereignisabonnements eines Themas ab.

 Kern GA
az eventgrid topic event-subscription update

Aktualisieren sie ein Ereignisabonnement eines Themas.

 Kern GA
az eventgrid topic key

Verwalten von freigegebenen Zugriffstasten eines Themas.

 Kern GA
az eventgrid topic key list

Auflisten freigegebener Zugriffstasten eines Themas.

 Kern GA
az eventgrid topic key regenerate

Generieren Sie einen freigegebenen Zugriffsschlüssel eines Themas neu.

 Kern GA
az eventgrid topic list

Liste der verfügbaren Themen auf.

 Kern GA
az eventgrid topic show

Rufen Sie die Details eines Themas ab.

 Kern GA
az eventgrid topic update

Aktualisieren eines Themas.

 Kern GA

az eventgrid topic create

Bearbeiten

Erstellen sie ein Thema.

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]

Beispiele

Erstellen Sie ein neues Thema.

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

Erstellen Sie ein neues Thema mit benutzerdefinierten Eingabezuordnungen.

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

Erstellen Sie ein neues Thema, das Ereignisse akzeptiert, die im CloudEvents V1.0-Schema veröffentlicht wurden.

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

Erstellen eines neuen Themas, das bestimmte eingehende IP-Regeln mit der standard-Sku und der vom System zugewiesenen Identität zulässt

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

Erstellen Sie ein neues Thema in Azure.

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

Erstellen Sie ein neues Thema in Azure.

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

Erstellen Sie ein neues Thema in AzureArc für einen benutzerdefinierten Speicherort.

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

Erforderliche Parameter

--name -n

Name des Themas.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Optionale Parameter

--extended-location-name
Vorschau

Der name des erweiterten Speicherorts, falls art==azurearc.

--extended-location-type
Vorschau

Der erweiterte Standorttyp, falls art==azurearc.

Zulässige Werte: customlocation
--identity
Vorschau Als veraltet markiert

Das Argument 'Identity' ist veraltet und wird in einer zukünftigen Version entfernt.

Der verwaltete Identitätstyp für die Ressource. Wird in Zukunft veraltet und durch --mi-system-assigned-identity ersetzt.

Zulässige Werte: noidentity, systemassigned
--inbound-ip-rules

Liste der eingehenden IP-Regeln.

Liste der eingehenden IP-Regeln, die IP-Adresse in CIDR-Notation angeben, z. B. 10.0.0.0/8 zusammen mit der entsprechenden Aktion, die basierend auf der Übereinstimmung oder ohne Übereinstimmung der IpMask ausgeführt werden soll. Mögliche Werte sind : Zulassen.

--input-mapping-default-values

Wenn das Eingabeschema als customeventschema angegeben wird, kann dieser Parameter verwendet werden, um Eingabezuordnungen basierend auf Standardwerten anzugeben. Sie können diesen Parameter verwenden, wenn Ihr benutzerdefiniertes Schema kein Feld enthält, das einem der drei von diesem Parameter unterstützten Felder entspricht. Geben Sie leertrennte Zuordnungen im Format "key=value" an. Zulässige Schlüsselnamen sind "subject", "eventtype", "dataversion". Die entsprechenden Wertnamen sollten die Standardwerte angeben, die für die Zuordnung verwendet werden sollen, und sie werden nur verwendet, wenn das veröffentlichte Ereignis keine gültige Zuordnung für ein bestimmtes Feld aufweist.

--input-mapping-fields

Wenn das Eingabeschema als customeventschema angegeben wird, wird dieser Parameter verwendet, um Eingabezuordnungen basierend auf Feldnamen anzugeben. Geben Sie leertrennte Zuordnungen im Format "key=value" an. Zulässige Schlüsselnamen sind "id", "topic", "eventtime", "subject", "eventtype", "dataversion". Die entsprechenden Wertnamen sollten die Namen der Felder im benutzerdefinierten Eingabeschema angeben. Wenn keine Zuordnung für "ID" oder "eventtime" angegeben wird, generiert Das Ereignisraster automatisch einen Standardwert für diese beiden Felder.

--input-schema

Schema, in dem eingehende Ereignisse in diesem Thema/dieser Domäne veröffentlicht werden. Wenn Sie "customeventschema" als Wert für diesen Parameter angeben, müssen Sie auch Werte für mindestens einen von --input_mapping_default_values / --input_mapping_fields angeben.

Zulässige Werte: cloudeventschemav1_0, customeventschema, eventgridschema
Standardwert: eventgridschema
--kind
Vorschau

Die Art der Themenressource.

Zulässige Werte: azure, azurearc
Standardwert: Azure
--location -l

Ort. Werte aus: az account list-locations. Sie können den Standardspeicherort mithilfe von az configure --defaults location=<location>konfigurieren.

--mi-system-assigned

Wenn dieser Param vorhanden ist, wird angegeben, dass die vom SystemAssigned verwaltete Identität verwendet wird.

--mi-user-assigned
Vorschau

Fügen Sie zugewiesene Identitäten hinzu, wenn identityType benutzer- oder gemischt ist. Dieses Attribut ist für alle Zieltypen mit Ausnahme von StorageQueue gültig. Mehrere Attribute können mithilfe von mehr als einem --mi-user-assigned Argument angegeben werden.

--public-network-access

Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert. Sie können auf bestimmte IPs weiter einschränken, indem Sie diese konfigurieren.

Zulässige Werte: disabled, enabled
--sku
Vorschau

Der Sku-Name der Ressource.

Zulässige Werte: basic, premium
Standardwert: Basic
--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az eventgrid topic delete

Bearbeiten

Löschen eines Themas.

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

Beispiele

Löschen eines Themas.

az eventgrid topic delete -g rg1 --name topic1

Optionale Parameter

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name des Themas.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az eventgrid topic list

Bearbeiten

Liste der verfügbaren Themen auf.

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

Beispiele

Alle Themen im aktuellen Azure-Abonnement auflisten.

az eventgrid topic list

Alle Themen in einer Ressourcengruppe auflisten.

az eventgrid topic list -g rg1

Auflisten aller Themen in einer Ressourcengruppe, deren Name das Muster "XYZ" enthält

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

Auflisten aller Themen in einer Ressourcengruppe mit Ausnahme der Domäne mit dem Namen "name1"

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

Optionale Parameter

--odata-query

Die OData-Abfrage, die zum Filtern der Listenergebnisse verwendet wird. Filterung ist derzeit nur für die Name-Eigenschaft zulässig. Zu den unterstützten Vorgängen gehören: CONTAINS, eq (for equal), ne (for not equal), AND, OR and NOT.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az eventgrid topic show

Bearbeiten

Rufen Sie die Details eines Themas ab.

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

Beispiele

Zeigen Sie die Details eines Themas an.

az eventgrid topic show -g rg1 -n topic1

Zeigen Sie die Details eines Themas basierend auf der Ressourcen-ID an.

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

Optionale Parameter

--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--name -n

Name des Themas.

--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.

az eventgrid topic update

Bearbeiten

Aktualisieren eines Themas.

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]

Beispiele

Aktualisieren Sie die Eigenschaften eines vorhandenen Themas mit neuen SKU-, Identitäts- und Öffentlichen Netzwerkzugriffsinformationen.

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

Optionale Parameter

--identity
Vorschau Als veraltet markiert

Das Argument 'Identity' ist veraltet und wird in einer zukünftigen Version entfernt.

Der verwaltete Identitätstyp für die Ressource. Wird in Zukunft veraltet und durch --mi-system-assigned-identity ersetzt.

Zulässige Werte: noidentity, systemassigned
--ids

Mindestens eine Ressourcen-IDs (durch Leerzeichen getrennt). Dabei sollte es sich um eine vollständige Ressourcen-ID mit allen Informationen der Argumente "Ressourcen-ID" sein. Sie sollten entweder --ids oder andere Argumente für die Ressourcen-ID angeben.

--inbound-ip-rules

Liste der eingehenden IP-Regeln, die IP-Adresse in CIDR-Notation angeben, z. B. 10.0.0.0/8 zusammen mit der entsprechenden Aktion, die basierend auf der Übereinstimmung oder ohne Übereinstimmung der IpMask ausgeführt werden soll. Mögliche Werte sind : Zulassen.

--mi-system-assigned

Wenn dieser Param vorhanden ist, wird angegeben, dass die vom SystemAssigned verwaltete Identität verwendet wird.

--mi-user-assigned
Vorschau

Fügen Sie zugewiesene Identitäten hinzu, wenn identityType benutzer- oder gemischt ist. Dieses Attribut ist für alle Zieltypen mit Ausnahme von StorageQueue gültig. Mehrere Attribute können mithilfe von mehr als einem --mi-user-assigned Argument angegeben werden.

--name -n

Name des Themas.

--public-network-access

Dadurch wird ermittelt, ob Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist sie aktiviert. Sie können auf bestimmte IPs weiter einschränken, indem Sie diese konfigurieren.

Zulässige Werte: disabled, enabled
--resource-group -g

Name der Ressourcengruppe. Sie können die Standardgruppe mit az configure --defaults group=<name>konfigurieren.

--sku
Vorschau

Der Sku-Name der Ressource.

Zulässige Werte: basic, premium
--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--tags

Durch Leerzeichen getrennte Tags: key[=value] [key[=value] ...]. Verwenden Sie "", um vorhandene Tags zu löschen.

Globale Parameter
--debug

Erhöhen Sie die Ausführlichkeit der Protokollierung, um alle Debugprotokolle anzuzeigen.

--help -h

Diese Hilfenachricht anzeigen und beenden.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Name oder ID des Abonnements. Sie können das Standardabonnement mithilfe von az account set -s NAME_OR_IDkonfigurieren.

--verbose

Erhöhen Sie die Ausführlichkeit der Protokollierung. Verwenden Sie "-debug" für vollständige Debugprotokolle.