az eventgrid partner topic event-subscription

Referenz

Hinweis

Diese Befehlsgruppe verfügt über Befehle, die sowohl in Azure CLI als auch in mindestens einer Erweiterung definiert sind. Installieren Sie jede Erweiterung, um von ihren erweiterten Funktionen zu profitieren. Weitere Informationen zu Erweiterungen

Verwalten von Ereignisabonnements des Partnerthemas.

Befehle

Name	Beschreibung	Typ	Status
az eventgrid partner topic event-subscription create	Erstellen Sie ein neues Ereignisabonnement für ein Partnerthema.	Core	Allgemein verfügbar
az eventgrid partner topic event-subscription create (eventgrid Erweiterung)	Erstellen Sie ein neues Ereignisabonnement für ein Partnerthema.	Durchwahl	Vorschau
az eventgrid partner topic event-subscription delete	Löschen eines Ereignisabonnements eines Partnerthemas.	Core	Allgemein verfügbar
az eventgrid partner topic event-subscription delete (eventgrid Erweiterung)	Löschen eines Ereignisabonnements eines Partnerthemas.	Durchwahl	Vorschau
az eventgrid partner topic event-subscription list	Auflisten von Ereignisabonnements eines bestimmten Partnerthemas.	Core	Allgemein verfügbar
az eventgrid partner topic event-subscription list (eventgrid Erweiterung)	Auflisten von Ereignisabonnements eines bestimmten Partnerthemas.	Durchwahl	Vorschau
az eventgrid partner topic event-subscription show	Rufen Sie die Details eines Ereignisabonnements eines Partnerthemas ab.	Core	Allgemein verfügbar
az eventgrid partner topic event-subscription show (eventgrid Erweiterung)	Rufen Sie die Details eines Ereignisabonnements eines Partnerthemas ab.	Durchwahl	Vorschau
az eventgrid partner topic event-subscription update	Aktualisieren sie ein Ereignisabonnement eines Partnerthemas.	Core	Allgemein verfügbar
az eventgrid partner topic event-subscription update (eventgrid Erweiterung)	Aktualisieren sie ein Ereignisabonnement eines Partnerthemas.	Durchwahl	Vorschau

az eventgrid partner topic event-subscription create

Bearbeiten

Erstellen Sie ein neues Ereignisabonnement für ein Partnerthema.

az eventgrid partner topic event-subscription create --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--aad-tenant-id]
                                                     [--advanced-filter]
                                                     [--azure-active-directory-application-id-or-uri]
                                                     [--deadletter-endpoint]
                                                     [--delivery-attribute-mapping]
                                                     [--enable-advanced-filtering-on-arrays {false, true}]
                                                     [--endpoint]
                                                     [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                     [--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
                                                     [--event-ttl]
                                                     [--expiration-date]
                                                     [--included-event-types]
                                                     [--labels]
                                                     [--max-delivery-attempts]
                                                     [--max-events-per-batch]
                                                     [--preferred-batch-size-in-kilobytes]
                                                     [--qttl]
                                                     [--subject-begins-with]
                                                     [--subject-case-sensitive {false, true}]
                                                     [--subject-ends-with]

Beispiele

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisraster-Partnerthema mithilfe von Standardfiltern.

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisraster-Partnerthema mit einem Filter, der ein Betreffpräfix angibt.

az eventgrid partner topic event-subscription create --name es4 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisraster-Partnerthema mit Standardfiltern und CloudEvent V 1.0 als Übermittlungsschema.

az eventgrid partner topic event-subscription create -n es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Erstellen Sie ein neues Ereignisabonnement für ein Event Grid-Partnertopic mit einem Deadletter-Ziel und einer benutzerdefinierten Wiederholungsrichtlinie von maximal 10 Übermittlungsversuchen und einer Ereignis-TTL von 2 Stunden (je nachdem, was früher geschieht) und Ablaufdatum.

az eventgrid partner topic event-subscription create --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120 --expiration-date "2022-10-31"

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisraster-Partnerthema, wobei Azure Active Directory Webhook als Ziel aktiviert hat.

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisraster-Partnerthema mit Azure Function als Ziel.

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Erstellen eines neuen Ereignisabonnements für ein Ereignisraster-Partnerthema mithilfe der Speicherwarteschlange als Ziel mit nachrichtenttl bei 5 Minuten

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Erstellen eines neuen Ereignisabonnements für ein Ereignisraster-Partnerthema mit erweiterter Filterung nach aktivierten Arrays

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

--partner-topic-name

Den Namen des Partnerthemas.

--resource-group -g

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

Optionale Parameter

--aad-tenant-id --azure-active-directory-tenant-id

Die Azure Active Directory-Mandanten-ID, um das Zugriffstoken abzurufen, das als Bearertoken in Übermittlungsanforderungen eingeschlossen wird. Gilt nur für Webhook als Ziel.

--advanced-filter

Ein erweiterter Filter ermöglicht das Filtern von Ereignissen basierend auf einer bestimmten Ereigniseigenschaft.

Verwendung: --advanced-filter KEY[. INNERKEY] FILTEROPERATOR-WERT [WERT...] StringIn: --advanced-filter data. Color StringIn Blue Red Orange Yellow StringNotIn: --advanced-filter data. Color StringNotIn Blue Red Orange Yellow StringContains: --advanced-filter subject StringContains Blue Red StringNotContains: --advanced-filter subject StringNotContains Blue Red StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringNotBeginsWith: --advanced-filter subject StringNotBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png stringNotEndsWith: --advanced-filter subject StringNotEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberInRange --advanced-filter data.property1 NumberInRange 5,10 20,30 40,50 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 NumberNotInRange: --advanced-filter data.property2 NumberNotInRange 100.110 200.210 300.310 NumberLessThan: --advanced-filter data.property3 NumberLessThan 100 NumberLessThanOrEquals: --advanced-filter data.property2 NumberLessThanOrEquals 100 NumberGreaterThan: --advanced-filter data.property3 NumberGreaterThan 100 NumberGreaterThanOrEquals: --advanced-filter data.property2 NumberGreaterThanOrEquals 100 BoolEquals: --advanced-filter data.property3 BoolEqual true IsNullOrUndefined: --advanced-filter data.property3 IsNullOrUndefined IsNotNull: --advanced-filter data.property3 IsNotNull Multiple advanced filters can be specified by using more than one --advanced-filter argument.

--azure-active-directory-application-id-or-uri

Die Azure Active Directory-Anwendungs-ID oder der URI zum Abrufen des Zugriffstokens, das als Bearertoken in Übermittlungsanforderungen eingeschlossen wird. Gilt nur für Webhook als Ziel.

--deadletter-endpoint

Die Azure-Ressourcen-ID eines Azure Storage-Blob-Containerziels, in dem EventGrid nicht zustellbare Ereignisse für dieses Ereignisabonnement speichern soll.

Beispiel: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--delivery-attribute-mapping

Fügen Sie die Zuordnung von Übermittlungsattributen hinzu, um zusätzliche Informationen über HTTP-Header zu senden, wenn Ereignisse bereitgestellt werden. Dieses Attribut ist für alle Zieltypen mit Ausnahme von StorageQueue gültig. Mehrere Attribute können mithilfe --delivery-attribute-mapping mehrerer Argumente angegeben werden.

Verwendung: --delivery-attribute-mapping attribut-type attribute-type attribute-value [attribute-is-secret] Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue false Static Attribute Mapping: --delivery-attribute-mapping somename static somevalue true Dynamic Attribute Mapping: --delivery-attribute-mapping somename dynamic somename dynamic somevalue Both Static and Dynamic: -- delivery-attribute-mapping somename dynamic somevalue --delivery-attribute-mapping somename2 static somevalue.

--enable-advanced-filtering-on-arrays --enable-af-arr

Ermöglicht die Auswertung erweiterter Filter anhand eines Wertearrays, anstatt einen Singularwert zu erwarten.

Zulässige Werte: false, true

--endpoint

Endpunkt, in dem EventGrid Ereignisse bereitstellen soll, die diesem Ereignisabonnement entsprechen. Für den Webhook-Endpunkttyp sollte dies die entsprechende Webhook-URL sein. Bei anderen Endpunkttypen sollte dies der Azure-Ressourcenbezeichner des Endpunkts sein. Es wird erwartet, dass der Zielendpunkt bereits erstellt und zur Verwendung verfügbar ist, bevor ein Ereignisrasterbefehl ausgeführt wird.

--endpoint-type

Der Typ des Zielendpunkts.

Zulässige Werte: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

Standardwert: webhook

--event-delivery-schema

Das Schema, in dem Ereignisse für dieses Ereignisabonnement übermittelt werden sollen. Standardmäßig werden Ereignisse im selben Schema übermittelt, in dem sie veröffentlicht werden (basierend auf dem Eingabeschema des entsprechenden Themas).

Zulässige Werte: cloudeventschemav1_0, custominputschema, eventgridschema

--event-ttl

Ereigniszeit für live (in Minuten). Muss eine Zahl zwischen 1 und 1440 sein.

Standardwert: 1440

--expiration-date

Datum oder Datetime (in UTC, z. B. "2018-11-30T11:59:59+00:00" oder "2018-11-30"), nach dem das Ereignisabonnement abläuft. Standardmäßig ist kein Ablauf für das Ereignisabonnement vorhanden.

--included-event-types

Eine durch Leerzeichen getrennte Liste von Ereignistypen (z. B. Microsoft.Storage.BlobCreated und Microsoft.Storage.BlobDeleted). Um alle Standardereignistypen zu abonnieren, geben Sie keinen Wert für dieses Argument an. Für Ereignisrasterthemen sind Ereignistypen kundendefiniert. Für Azure-Ereignisse, z. B. Speicherkonten, IoT Hub usw., können Sie ihre Ereignistypen mit diesem CLI-Befehl "az eventgrid topic-type list-event-types" abfragen.

--labels

Eine durch Leerzeichen getrennte Liste von Bezeichnungen, die diesem Ereignisabonnement zugeordnet werden sollen.

--max-delivery-attempts

Maximale Anzahl von Übermittlungsversuchen. Muss eine Zahl zwischen 1 und 30 sein.

Standardwert: 30

--max-events-per-batch

Maximale Anzahl von Ereignissen in einem Batch. Muss eine Zahl im Bereich 1 bis 5.000 sein.

--preferred-batch-size-in-kilobytes

Bevorzugte Batchgröße in Kilobyte. Muss eine Zahl im Bereich 1 bis 1.024 sein.

--qttl --storage-queue-msg-ttl

Speicherwarteschlangen-Nachrichtenzeit, um in Sekunden zu leben.

--subject-begins-with

Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Präfix. Platzhalterzeichen werden nicht unterstützt.

--subject-case-sensitive

Geben Sie an, ob die Betrefffelder in einer Groß-/Kleinschreibung verglichen werden sollen. True, wenn die Kennzeichnung vorhanden ist.

Zulässige Werte: false, true

Standardwert: False

--subject-ends-with

Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Suffix. Platzhalterzeichen werden nicht unterstützt.

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.

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

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 partner topic event-subscription create (eventgrid Erweiterung)

Vorschau

Die Befehlsgruppe "az eventgrid" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Erstellen Sie ein neues Ereignisabonnement für ein Partnerthema.

az eventgrid partner topic event-subscription create --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--advanced-filter]
                                                     [--azure-active-directory-application-id-or-uri]
                                                     [--azure-active-directory-tenant-id]
                                                     [--deadletter-endpoint]
                                                     [--endpoint]
                                                     [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                     [--event-delivery-schema {cloudeventschemav1_0, custominputschema, eventgridschema}]
                                                     [--event-ttl]
                                                     [--expiration-date]
                                                     [--included-event-types]
                                                     [--labels]
                                                     [--max-delivery-attempts]
                                                     [--max-events-per-batch]
                                                     [--preferred-batch-size-in-kilobytes]
                                                     [--subject-begins-with]
                                                     [--subject-case-sensitive {false, true}]
                                                     [--subject-ends-with]

Beispiele

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisraster-Partnerthema mithilfe von Standardfiltern.

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisraster-Partnerthema mit einem Filter, der ein Betreffpräfix angibt.

az eventgrid partner topic event-subscription create --name es4 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisraster-Partnerthema mit Standardfiltern und CloudEvent V 1.0 als Übermittlungsschema.

az eventgrid partner topic event-subscription create -n es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

az eventgrid partner topic event-subscription create --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 \
    --max-delivery-attempts 10 --event-ttl 120 --expiration-date "2022-10-31"

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisraster-Partnerthema, wobei Azure Active Directory Webhook als Ziel aktiviert hat.

az eventgrid partner topic event-subscription create --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --azure-active-directory-tenant-id azureactivedirectorytenantid
    --azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruri

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisraster-Partnerthema mit Azure Function als Ziel.

az eventgrid partner topic event-subscription create -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

--partner-topic-name

Den Namen des Partnerthemas.

--resource-group -g

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

Optionale Parameter

--advanced-filter

Ein erweiterter Filter ermöglicht das Filtern von Ereignissen basierend auf einer bestimmten Ereigniseigenschaft.

--azure-active-directory-application-id-or-uri

Die Azure Active Directory-Anwendungs-ID oder der URI zum Abrufen des Zugriffstokens, das als Bearertoken in Übermittlungsanforderungen eingeschlossen wird. Gilt nur für Webhook als Ziel.

--azure-active-directory-tenant-id

Die Azure Active Directory-Mandanten-ID, um das Zugriffstoken abzurufen, das als Bearertoken in Übermittlungsanforderungen eingeschlossen wird. Gilt nur für Webhook als Ziel.

--deadletter-endpoint

Die Azure-Ressourcen-ID eines Azure Storage-Blob-Containerziels, in dem EventGrid nicht zustellbare Ereignisse für dieses Ereignisabonnement speichern soll.

Beispiel: --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/containerName.

--endpoint

--endpoint-type

Der Typ des Zielendpunkts.

Zulässige Werte: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

Standardwert: webhook

--event-delivery-schema

Zulässige Werte: cloudeventschemav1_0, custominputschema, eventgridschema

--event-ttl

Ereigniszeit für live (in Minuten). Muss eine Zahl zwischen 1 und 1440 sein.

Standardwert: 1440

--expiration-date

Datum oder Datetime (in UTC, z. B. "2018-11-30T11:59:59+00:00" oder "2018-11-30"), nach dem das Ereignisabonnement abläuft. Standardmäßig ist kein Ablauf für das Ereignisabonnement vorhanden.

--included-event-types

Eine durch Leerzeichen getrennte Liste von Ereignistypen. Beispiel: Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted. Wenn Sie alle Standardereignistypen abonnieren möchten, geben Sie keinen Wert für dieses Argument an.

--labels

Eine durch Leerzeichen getrennte Liste von Bezeichnungen, die diesem Ereignisabonnement zugeordnet werden sollen.

--max-delivery-attempts

Maximale Anzahl von Übermittlungsversuchen. Muss eine Zahl zwischen 1 und 30 sein.

Standardwert: 30

--max-events-per-batch

Maximale Anzahl von Ereignissen in einem Batch. Muss eine Zahl im Bereich 1 bis 5.000 sein.

--preferred-batch-size-in-kilobytes

Bevorzugte Batchgröße in Kilobyte. Muss eine Zahl im Bereich 1 bis 1.024 sein.

--subject-begins-with

Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Präfix. Platzhalterzeichen werden nicht unterstützt.

--subject-case-sensitive

Geben Sie an, ob die Betrefffelder in einer Groß-/Kleinschreibung verglichen werden sollen. True, wenn die Kennzeichnung vorhanden ist.

Zulässige Werte: false, true

Standardwert: False

--subject-ends-with

Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Suffix. Platzhalterzeichen werden nicht unterstützt.

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.

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

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 partner topic event-subscription delete

Bearbeiten

Löschen eines Ereignisabonnements eines Partnerthemas.

az eventgrid partner topic event-subscription delete --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--yes]

Beispiele

Löschen eines Ereignisabonnements für ein Ereignisraster-Partnerthema.

az eventgrid partner topic event-subscription delete --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

--partner-topic-name

Den Namen des Partnerthemas.

--resource-group -g

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

Optionale Parameter

--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False

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.

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

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 partner topic event-subscription delete (eventgrid Erweiterung)

Vorschau

Die Befehlsgruppe "az eventgrid" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Löschen eines Ereignisabonnements eines Partnerthemas.

az eventgrid partner topic event-subscription delete --name
                                                     --partner-topic-name
                                                     --resource-group

Beispiele

Löschen eines Ereignisabonnements für ein Ereignisraster-Partnerthema.

az eventgrid partner topic event-subscription delete --name es1 \
    -g rg1 --partner-topic-name partnertopic1 \

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

--partner-topic-name

Den Namen des Partnerthemas.

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

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

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 partner topic event-subscription list

Bearbeiten

Auflisten von Ereignisabonnements eines bestimmten Partnerthemas.

az eventgrid partner topic event-subscription list --partner-topic-name
                                                   --resource-group
                                                   [--odata-query]

Beispiele

Auflisten aller Ereignisabonnements, die für ein Event Grid-Partnerthema erstellt wurden.

az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1

Erforderliche Parameter

--partner-topic-name

Den Namen des Partnerthemas.

--resource-group -g

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

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.

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.

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

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 partner topic event-subscription list (eventgrid Erweiterung)

Vorschau

Die Befehlsgruppe "az eventgrid" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Auflisten von Ereignisabonnements eines bestimmten Partnerthemas.

az eventgrid partner topic event-subscription list --partner-topic-name
                                                   --resource-group
                                                   [--odata-query]

Beispiele

Auflisten aller Ereignisabonnements, die für ein Event Grid-Partnerthema erstellt wurden.

az eventgrid partner topic event-subscription list -g rg1 --partner-topic-name partnertopic1

Erforderliche Parameter

--partner-topic-name

Den Namen des Partnerthemas.

--resource-group -g

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

Optionale Parameter

--odata-query

Die Abfrage zum Filtern der Ergebnisse mithilfe der OData-Syntax.

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.

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

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

Bearbeiten

Rufen Sie die Details eines Ereignisabonnements eines Partnerthemas ab.

az eventgrid partner topic event-subscription show --name
                                                   --partner-topic-name
                                                   --resource-group
                                                   [--include-attrib-secret {false, true}]
                                                   [--include-full-endpoint-url {false, true}]

Beispiele

Zeigen Sie die Details eines Ereignisabonnements für ein Event Grid-Partnerthema an.

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1

Anzeigen der Details eines Ereignisabonnements für ein Event Grid-Partnerthema und Einschließen statischer Attributschlüssel

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1 --include-static-delivery-attribute-secret

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

--partner-topic-name

Den Namen des Partnerthemas.

--resource-group -g

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

Optionale Parameter

--include-attrib-secret --include-static-delivery-attribute-secret

Gibt an, ob geheime Schlüssel für statische Übermittlungsattribute zurückgegeben werden sollen. True, wenn die Kennzeichnung vorhanden ist.

Zulässige Werte: false, true

Standardwert: False

--include-full-endpoint-url

Geben Sie an, ob die vollständige Endpunkt-URL zurückgegeben werden soll. True, wenn die Kennzeichnung vorhanden ist.

Zulässige Werte: false, true

Standardwert: False

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.

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

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 partner topic event-subscription show (eventgrid Erweiterung)

Vorschau

Die Befehlsgruppe "az eventgrid" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Rufen Sie die Details eines Ereignisabonnements eines Partnerthemas ab.

az eventgrid partner topic event-subscription show --name
                                                   --partner-topic-name
                                                   --resource-group
                                                   [--include-full-endpoint-url {false, true}]

Beispiele

Zeigen Sie die Details eines Ereignisabonnements für ein Event Grid-Partnerthema an.

az eventgrid partner topic event-subscription show --name es1 \
     -g rg1 --partner-topic-name partnertopic1

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

--partner-topic-name

Den Namen des Partnerthemas.

--resource-group -g

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

Optionale Parameter

--include-full-endpoint-url

Geben Sie an, ob die vollständige Endpunkt-URL zurückgegeben werden soll. True, wenn die Kennzeichnung vorhanden ist.

Zulässige Werte: false, true

Standardwert: False

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.

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

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

Bearbeiten

Aktualisieren sie ein Ereignisabonnement eines Partnerthemas.

az eventgrid partner topic event-subscription update --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--advanced-filter]
                                                     [--deadletter-endpoint]
                                                     [--delivery-attribute-mapping]
                                                     [--enable-advanced-filtering-on-arrays {false, true}]
                                                     [--endpoint]
                                                     [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                     [--included-event-types]
                                                     [--labels]
                                                     [--qttl]
                                                     [--subject-begins-with]
                                                     [--subject-ends-with]

Beispiele

Aktualisieren Sie ein Ereignisabonnement für ein Ereignisraster-Partnerthema, um einen neuen Endpunkt anzugeben.

az eventgrid partner topic event-subscription update --name es1 \
    -g rg1 --partner-topic-name partnertopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Aktualisieren Sie ein Ereignisabonnement für ein Ereignisraster-Partnerthema, um einen neuen Subject-Ends-With-Filter anzugeben.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .jpg

Aktualisieren Sie ein Ereignisabonnement für ein Ereignisraster-Partnerthema, um einen neuen Endpunkt und eine neue Betreff-End-Liste mit einer neuen Liste der enthaltenen Ereignistypen anzugeben.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Aktualisieren Sie ein Ereignisabonnement für ein Azure Event Grid-Partnerthema, um ein Deadletter-Ziel einzuschließen.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Aktualisieren Eines Ereignisabonnements für ein Azure Event Grid-Partnerthema mithilfe erweiterter Filter.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Aktualisieren eines Ereignisabonnements für ein Ereignisraster-Partnerthema mithilfe der Speicherwarteschlange als Ziel mit nachrichtenttl bei 5 Minuten

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --storage-queue-msg-ttl 300

Aktualisieren eines Ereignisabonnements für ein Ereignisraster-Partnerthema mit erweiterter Filterung nach aktivierten Arrays

az eventgrid partner topic event-subscription update -n es1 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
    --enable-advanced-filtering-on-arrays true

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

--partner-topic-name

Den Namen des Partnerthemas.

--resource-group -g

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

Optionale Parameter

--advanced-filter

Ein erweiterter Filter ermöglicht das Filtern von Ereignissen basierend auf einer bestimmten Ereigniseigenschaft.

--deadletter-endpoint

Die Azure-Ressourcen-ID eines Azure Storage-Blob-Containerziels, in dem EventGrid nicht zustellbare Ereignisse für dieses Ereignisabonnement speichern soll.

--delivery-attribute-mapping

--enable-advanced-filtering-on-arrays --enable-af-arr

Ermöglicht die Auswertung erweiterter Filter anhand eines Wertearrays, anstatt einen Singularwert zu erwarten.

Zulässige Werte: false, true

--endpoint

--endpoint-type

Der Typ des Zielendpunkts.

Zulässige Werte: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

Standardwert: webhook

--included-event-types

--labels

Eine durch Leerzeichen getrennte Liste von Bezeichnungen, die diesem Ereignisabonnement zugeordnet werden sollen.

--qttl --storage-queue-msg-ttl

Speicherwarteschlangen-Nachrichtenzeit, um in Sekunden zu leben.

--subject-begins-with

Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Präfix. Platzhalterzeichen werden nicht unterstützt.

--subject-ends-with

Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Suffix. Platzhalterzeichen werden nicht unterstützt.

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.

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

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 partner topic event-subscription update (eventgrid Erweiterung)

Vorschau

Die Befehlsgruppe "az eventgrid" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus

Aktualisieren sie ein Ereignisabonnement eines Partnerthemas.

az eventgrid partner topic event-subscription update --name
                                                     --partner-topic-name
                                                     --resource-group
                                                     [--advanced-filter]
                                                     [--deadletter-endpoint]
                                                     [--endpoint]
                                                     [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                                     [--included-event-types]
                                                     [--labels]
                                                     [--subject-begins-with]
                                                     [--subject-ends-with]

Beispiele

Aktualisieren Sie ein Ereignisabonnement für ein Ereignisraster-Partnerthema, um einen neuen Endpunkt anzugeben.

az eventgrid partner topic event-subscription update --name es1 \
    -g rg1 --partner-topic-name partnertopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Aktualisieren Sie ein Ereignisabonnement für ein Ereignisraster-Partnerthema, um einen neuen Subject-Ends-With-Filter anzugeben.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .jpg

Aktualisieren Sie ein Ereignisabonnement für ein Ereignisraster-Partnerthema, um einen neuen Endpunkt und eine neue Betreff-End-Liste mit einer neuen Liste der enthaltenen Ereignistypen anzugeben.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Aktualisieren Sie ein Ereignisabonnement für ein Azure Event Grid-Partnerthema, um ein Deadletter-Ziel einzuschließen.

az eventgrid partner topic event-subscription update --name es2 \
    -g rg1 --partner-topic-name partnertopic1 \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Aktualisieren Eines Ereignisabonnements für ein Azure Event Grid-Partnerthema mithilfe erweiterter Filter.

az eventgrid partner topic event-subscription update --name es3 \
    -g rg1 --partner-topic-name partnertopic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --advanced-filter data.blobType StringIn BlockBlob
    --advanced-filter data.url StringBeginsWith https://myaccount.blob.core.windows.net

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

--partner-topic-name

Den Namen des Partnerthemas.

--resource-group -g

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

Optionale Parameter

--advanced-filter

Ein erweiterter Filter ermöglicht das Filtern von Ereignissen basierend auf einer bestimmten Ereigniseigenschaft.

--deadletter-endpoint

Die Azure-Ressourcen-ID eines Azure Storage-Blob-Containerziels, in dem EventGrid nicht zustellbare Ereignisse für dieses Ereignisabonnement speichern soll.

--endpoint

--endpoint-type

Der Typ des Zielendpunkts.

Zulässige Werte: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook

Standardwert: webhook

--included-event-types

--labels

Eine durch Leerzeichen getrennte Liste von Bezeichnungen, die diesem Ereignisabonnement zugeordnet werden sollen.

--subject-begins-with

Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Präfix. Platzhalterzeichen werden nicht unterstützt.

--subject-ends-with

Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Suffix. Platzhalterzeichen werden nicht unterstützt.

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.

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

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.

Freigeben über

az eventgrid partner topic event-subscription

Befehle

az eventgrid partner topic event-subscription create

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid partner topic event-subscription create (eventgrid Erweiterung)

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid partner topic event-subscription delete

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid partner topic event-subscription delete (eventgrid Erweiterung)

Beispiele

Erforderliche Parameter

az eventgrid partner topic event-subscription list

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid partner topic event-subscription list (eventgrid Erweiterung)

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid partner topic event-subscription show

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid partner topic event-subscription show (eventgrid Erweiterung)

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid partner topic event-subscription update

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid partner topic event-subscription update (eventgrid Erweiterung)

Beispiele

Erforderliche Parameter

Optionale Parameter

Zusätzliche Ressourcen