az eventgrid topic

Referenz

Verwalten von Azure Event Grid Themen.

Befehle

az eventgrid topic create	Erstellen Sie ein Thema.
az eventgrid topic delete	Löschen eines Themas.
az eventgrid topic event-subscription	Verwalten von Ereignisabonnements des Themas.
az eventgrid topic event-subscription create	Erstellen Sie ein neues Ereignisabonnement für ein Thema.
az eventgrid topic event-subscription delete	Löschen eines Ereignisabonnements eines Themas.
az eventgrid topic event-subscription list	Listen von Ereignisabonnements eines bestimmten Themas auf.
az eventgrid topic event-subscription show	Rufen Sie die Details eines Ereignisabonnements eines Themas ab.
az eventgrid topic event-subscription update	Aktualisieren eines Ereignisabonnements eines Themas.
az eventgrid topic key	Verwalten von freigegebenen Zugriffsschlüsseln eines Themas.
az eventgrid topic key list	Listen Sie freigegebene Zugriffstasten eines Themas auf.
az eventgrid topic key regenerate	Generieren Sie einen freigegebenen Zugriffsschlüssel eines Themas.
az eventgrid topic list	Liste verfügbarer Themen auf.
az eventgrid topic private-endpoint-connection	Verwalten von privaten Endpunktverbindungen eines Themas.
az eventgrid topic private-endpoint-connection approve	Genehmigen einer privaten Endpunktverbindungsanforderung für ein Thema.
az eventgrid topic private-endpoint-connection delete	Löschen einer privaten Endpunktverbindung für ein Thema.
az eventgrid topic private-endpoint-connection list	Listet die Eigenschaften aller privaten Endpunktverbindungen für ein Thema auf.
az eventgrid topic private-endpoint-connection reject	Ablehnen einer privaten Endpunktverbindungsanforderung für ein Thema.
az eventgrid topic private-endpoint-connection show	Zeigen Sie die Eigenschaften einer privaten Endpunktverbindung für ein Thema an.
az eventgrid topic private-link-resource	Verwalten der privaten Linkressource eines Themas.
az eventgrid topic private-link-resource list	Listet die Eigenschaften aller privaten Linkressourcen für ein Thema auf.
az eventgrid topic private-link-resource show	Zeigen Sie die Eigenschaften einer privaten Linkressource für ein Thema an.
az eventgrid topic show	Rufen Sie die Details eines Themas ab.
az eventgrid topic update	Aktualisieren eines Themas.

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

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

Erstellen eines neuen Themas, das bestimmte eingehende IP-Regeln mit Basic Sku und System zugewiesener Identität ermöglicht

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 Eines neuen Themas in Azure.

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

Erstellen Eines neuen Themas in Azure.

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

Erstellen Sie ein neues Thema in AzureArc, das auf einen benutzerdefinierten Speicherort ausgerichtet ist.

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

Der name des erweiterten Speicherorts, wenn dies der Typ ist==azurearc.

--extended-location-type

Der erweiterte Standorttyp, wenn dies der Typ ist.

Zulässige Werte: customlocation

--identity

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

Zulässige Werte: noidentity, systemassigned

--inbound-ip-rules

Liste der eingehenden IP-Regeln.

--input-mapping-default-values

Wenn 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 Felder entspricht, die von diesem Parameter unterstützt werden. Geben Sie leer getrennte 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 eingabeschema als customeventschema angegeben wird, wird dieser Parameter verwendet, um Eingabezuordnungen basierend auf Feldnamen anzugeben. Geben Sie leer getrennte Zuordnungen im Format "key=value" an. Zulässige Schlüsselnamen sind "id", "thema", "eventtime", "subject", "eventtype", "dataversion". Die entsprechenden Wertnamen sollten die Namen der Felder im benutzerdefinierten Eingabeschema angeben. Wenn eine Zuordnung für "id" oder "eventtime" nicht bereitgestellt wird, generiert Ereignisraster automatisch einen Standardwert für diese beiden Felder.

--input-schema

Schema, in dem eingehende Ereignisse in diesem Thema/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 bereitstellen.

Zulässige Werte: cloudeventschemav1_0, customeventschema, eventgridschema

Standardwert: eventgridschema

--kind

Die Art der Themenressource.

Zulässige Werte: azure, azurearc

Standardwert: Azure

--location -l

Der Standort. Werte aus: az account list-locations. Sie können den standardmäßig verwendeten Standort mit az configure --defaults location=<location> konfigurieren.

--mi-system-assigned

Die Anwesenheit dieses Param gibt an, dass die verwaltete SystemAssigned-Identität verwendet wird.

--mi-user-assigned

Fügen Sie Benutzer zugewiesene Identitäten hinzu, wenn IdentityType Benutzer oder gemischt ist. Dieses Attribut ist für alle Zieltypen gültig, außer StorageQueue. Mehrere Attribute können mithilfe mehrerer --mi-user-assigned Argumente angegeben werden.

--public-network-access

Dies bestimmt, ob der Datenverkehr über das öffentliche Netzwerk zulässig ist. Standardmäßig ist es aktiviert. Sie können weitere Einschränkungen für bestimmte IPs ausführen, indem Sie konfigurieren.

Zulässige Werte: disabled, enabled

--sku

Der Sku-Name der Ressource.

Zulässige Werte: basic, premium

Standardwert: Basic

--tags

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

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az eventgrid topic delete

Bearbeiten

Löschen eines Themas.

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

Beispiele

Löschen eines Themas.

az eventgrid topic delete -g rg1 --name topic1

Optionale Parameter

--ids

Eine oder mehrere Ressourcen-IDs (durch Leerzeichen getrennt). Es sollte eine vollständige Ressourcen-ID sein, die alle Informationen der Argumente "Resource Id" enthält. Sie sollten entweder --ids oder andere Argumente "Resource 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.

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az eventgrid topic list

Bearbeiten

Liste verfügbarer Themen auf.

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

Beispiele

Listet alle Themen im aktuellen Azure-Abonnement auf.

az eventgrid topic list

Listet alle Themen in einer Ressourcengruppe auf.

az eventgrid topic list -g rg1

Alle Themen in einer Ressourcengruppe auflisten, deren Name das Muster "XYZ" enthält

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

Alle Themen in einer Ressourcengruppe auflisten, außer 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. Die Filterung ist derzeit nur für die Name-Eigenschaft zulässig. Die unterstützten Vorgänge umfassen: ENTHÄLT, eq (für gleichheit), ne (nicht gleich), AND, OR und NOT.

--resource-group -g

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

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az eventgrid topic show

Bearbeiten

Rufen Sie die Details eines Themas ab.

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

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

--name -n

Name des Themas.

--resource-group -g

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

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

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}]
                          [--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

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

Zulässige Werte: noidentity, systemassigned

--ids

--inbound-ip-rules

Liste der eingehenden IP-Regeln, die IP-Adresse in CIDR-Notation angeben, z. B. 10.0.0.0/8 zusammen mit entsprechenden Aktionen, die basierend auf der Übereinstimmung oder keine Übereinstimmung der IpMask ausgeführt werden.

--mi-system-assigned

Die Anwesenheit dieses Param gibt an, dass die verwaltete SystemAssigned-Identität verwendet wird.

--mi-user-assigned

--name -n

Name des Themas.

--public-network-access

Zulässige Werte: disabled, enabled

--resource-group -g

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

--sku

Der Sku-Name der Ressource.

Zulässige Werte: basic, premium

--tags

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

Globale Parameter

--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az eventgrid topic

Befehle

az eventgrid topic create

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid topic delete

Beispiele

Optionale Parameter

az eventgrid topic list

Beispiele

Optionale Parameter

az eventgrid topic show

Beispiele

Optionale Parameter

az eventgrid topic update

Beispiele

Optionale Parameter

Feedback