Freigeben über

az eventgrid topic

Verwalten von Azure Event Grid-Themen.

Befehle

Name Beschreibung Typ Status
az eventgrid topic create

Erstellen sie ein Thema.

 Core GA
az eventgrid topic delete

Löschen eines Themas.

 Core GA
az eventgrid topic event-subscription

Verwalten von Ereignisabonnements des Themas.

 Core GA
az eventgrid topic event-subscription create

Erstellen Sie ein neues Ereignisabonnement für ein Thema.

 Core GA
az eventgrid topic event-subscription delete

Löschen eines Ereignisabonnements eines Themas.

 Core GA
az eventgrid topic event-subscription list

Auflisten von Ereignisabonnements eines bestimmten Themas.

 Core GA
az eventgrid topic event-subscription show

Rufen Sie die Details eines Ereignisabonnements eines Themas ab.

 Core GA
az eventgrid topic event-subscription update

Aktualisieren sie ein Ereignisabonnement eines Themas.

 Core GA
az eventgrid topic key

Verwalten von freigegebenen Zugriffstasten eines Themas.

 Core GA
az eventgrid topic key list

Auflisten freigegebener Zugriffstasten eines Themas.

 Core GA
az eventgrid topic key regenerate

Generieren Sie einen freigegebenen Zugriffsschlüssel eines Themas neu.

 Core GA
az eventgrid topic list

Liste der verfügbaren Themen auf.

 Core GA
az eventgrid topic show

Rufen Sie die Details eines Themas ab.

 Core GA
az eventgrid topic update

Aktualisieren eines Themas.

 Core 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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

--extended-location-name
Vorschau

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

Eigenschaft Wert
Parametergruppe: Azure Arc Arguments
--extended-location-type
Vorschau

Der erweiterte Standorttyp, falls art==azurearc.

Eigenschaft Wert
Parametergruppe: Azure Arc Arguments
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.

Eigenschaft Wert
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.

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

Die Art der Themenressource.

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

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

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

Der Sku-Name der Ressource.

Eigenschaft Wert
Standardwert: Basic
Zulässige Werte: basic, premium
--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.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Name des Themas.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--verbose

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

Eigenschaft Wert
Standardwert: False

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

Eigenschaft Wert
Standardwert: json
Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
--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.

Eigenschaft Wert
Standardwert: False

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--name -n

Name des Themas.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--resource-group -g

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--subscription

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
Globale Parameter
--debug

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

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--verbose

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

Eigenschaft Wert
Standardwert: False

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

Die folgenden Parameter sind optional, aber je nach Kontext kann mindestens ein Parameter erforderlich sein, damit der Befehl erfolgreich ausgeführt werden kann.

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

Eigenschaft Wert
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.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--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.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--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.

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

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

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--sku
Vorschau

Der Sku-Name der Ressource.

Eigenschaft Wert
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.

Eigenschaft Wert
Parametergruppe: Resource Id Arguments
--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.

Eigenschaft Wert
Standardwert: False
--help -h

Diese Hilfemeldung anzeigen und schließen.

--only-show-errors

Nur Fehler anzeigen, Warnungen unterdrücken.

Eigenschaft Wert
Standardwert: False
--output -o

Ausgabeformat.

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

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

--verbose

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

Eigenschaft Wert
Standardwert: False