az eventgrid system-topic event-subscription
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 Systemthemas.
Befehle
| Name | Beschreibung | Typ | Status |
|---|---|---|---|
| az eventgrid system-topic event-subscription create |
Erstellen Sie ein neues Ereignisabonnement für ein Systemthema. |
Core | Allgemein verfügbar |
| az eventgrid system-topic event-subscription create (eventgrid Erweiterung) |
Erstellen Sie ein neues Ereignisabonnement für ein Systemthema. |
Durchwahl | Vorschau |
| az eventgrid system-topic event-subscription delete |
Löschen eines Ereignisabonnements eines Systemthemas. |
Core | Allgemein verfügbar |
| az eventgrid system-topic event-subscription delete (eventgrid Erweiterung) |
Löschen eines Ereignisabonnements eines Systemthemas. |
Durchwahl | Vorschau |
| az eventgrid system-topic event-subscription list |
Auflisten von Ereignisabonnements eines bestimmten Systemthemas. |
Core | Allgemein verfügbar |
| az eventgrid system-topic event-subscription list (eventgrid Erweiterung) |
Auflisten von Ereignisabonnements eines bestimmten Systemthemas. |
Durchwahl | Vorschau |
| az eventgrid system-topic event-subscription show |
Rufen Sie die Details eines Ereignisabonnements eines Systemthemas ab. |
Core | Allgemein verfügbar |
| az eventgrid system-topic event-subscription show (eventgrid Erweiterung) |
Rufen Sie die Details eines Ereignisabonnements eines Systemthemas ab. |
Durchwahl | Vorschau |
| az eventgrid system-topic event-subscription update |
Aktualisieren eines Ereignisabonnements eines Systemthemas. |
Core | Allgemein verfügbar |
| az eventgrid system-topic event-subscription update (eventgrid Erweiterung) |
Aktualisieren eines Ereignisabonnements eines Systemthemas. |
Durchwahl | Vorschau |
az eventgrid system-topic event-subscription create
Erstellen Sie ein neues Ereignisabonnement für ein Systemthema.
az eventgrid system-topic event-subscription create --name
--resource-group
--system-topic-name
[--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 Ereignisrastersystemthema mithilfe von Standardfiltern.
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=codeErstellen Sie ein neues Ereignisabonnement für ein Ereignisrastersystemthema mit einem Filter, der ein Betreffpräfix angibt.
az eventgrid system-topic event-subscription create --name es4 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefixErstellen Sie ein neues Ereignisabonnement für ein Ereignisrastersystemthema mit Standardfiltern und CloudEvent V 1.0 als Übermittlungsschema.
az eventgrid system-topic event-subscription create -n es2 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0Erstellen Sie ein neues Ereignisabonnement für ein Ereignisrastersystemthema 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 system-topic event-subscription create --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--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 Ereignisrastersystemthema, wobei Azure Active Directory Webhook als Ziel aktiviert hat.
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--azure-active-directory-tenant-id azureactivedirectorytenantid
--azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruriErstellen Sie ein neues Ereignisabonnement für ein Ereignisrastersystemthema, wobei Azure Function als Ziel verwendet wird.
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunctionErstellen eines neuen Ereignisabonnements für ein Thema zum Ereignisrastersystem mithilfe der Speicherwarteschlange als Ziel mit einer Ttl von 5 Minuten
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint-type storagequeue \
--endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1 \
--storage-queue-msg-ttl 300Erstellen eines neuen Ereignisabonnements für ein Ereignisrastersystemthema und Aktivieren der erweiterten Filterung auf Arrays
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction \
--enable-advanced-filtering-on-arrays trueErforderliche Parameter
Name des Ereignisabonnements.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Systemthemas.
Optionale Parameter
Die Azure Active Directory-Mandanten-ID, um das Zugriffstoken abzurufen, das als Bearertoken in Übermittlungsanforderungen eingeschlossen wird. Gilt nur für Webhook als Ziel.
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.
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.
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.
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.
Ermöglicht die Auswertung erweiterter Filter anhand eines Wertearrays, anstatt einen Singularwert zu erwarten.
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.
Der Typ des Zielendpunkts.
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).
Ereigniszeit für live (in Minuten). Muss eine Zahl zwischen 1 und 1440 sein.
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.
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.
Eine durch Leerzeichen getrennte Liste von Bezeichnungen, die diesem Ereignisabonnement zugeordnet werden sollen.
Maximale Anzahl von Übermittlungsversuchen. Muss eine Zahl zwischen 1 und 30 sein.
Maximale Anzahl von Ereignissen in einem Batch. Muss eine Zahl im Bereich 1 bis 5.000 sein.
Bevorzugte Batchgröße in Kilobyte. Muss eine Zahl im Bereich 1 bis 1.024 sein.
Speicherwarteschlangen-Nachrichtenzeit, um in Sekunden zu leben.
Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Präfix. Platzhalterzeichen werden nicht unterstützt.
Geben Sie an, ob die Betrefffelder in einer Groß-/Kleinschreibung verglichen werden sollen. True, wenn die Kennzeichnung vorhanden ist.
Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Suffix. Platzhalterzeichen werden nicht unterstützt.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az eventgrid system-topic event-subscription create (eventgrid Erweiterung)
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 Systemthema.
az eventgrid system-topic event-subscription create --name
--resource-group
--system-topic-name
[--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 Ereignisrastersystemthema mithilfe von Standardfiltern.
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=codeErstellen Sie ein neues Ereignisabonnement für ein Ereignisrastersystemthema mit einem Filter, der ein Betreffpräfix angibt.
az eventgrid system-topic event-subscription create --name es4 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--subject-begins-with mysubject_prefixErstellen Sie ein neues Ereignisabonnement für ein Ereignisrastersystemthema mit Standardfiltern und CloudEvent V 1.0 als Übermittlungsschema.
az eventgrid system-topic event-subscription create -n es2 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code \
--event-delivery-schema cloudeventschemav1_0Erstellen Sie ein neues Ereignisabonnement für ein Ereignisrastersystemthema 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 system-topic event-subscription create --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--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 Ereignisrastersystemthema, wobei Azure Active Directory Webhook als Ziel aktiviert hat.
az eventgrid system-topic event-subscription create --name es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--azure-active-directory-tenant-id azureactivedirectorytenantid
--azure-active-directory-application-id-or-uri azureactivedirectoryapplicationidoruriErstellen Sie ein neues Ereignisabonnement für ein Ereignisrastersystemthema, wobei Azure Function als Ziel verwendet wird.
az eventgrid system-topic event-subscription create -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunctionErforderliche Parameter
Name des Ereignisabonnements.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Systemthemas.
Optionale Parameter
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 StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 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 BoolEquals true Multiple advanced filters can be specified by using more than one --advanced-filter argument.
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.
Die Azure Active Directory-Mandanten-ID, um das Zugriffstoken abzurufen, das als Bearertoken in Übermittlungsanforderungen eingeschlossen wird. Gilt nur für Webhook als Ziel.
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.
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.
Der Typ des Zielendpunkts.
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).
Ereigniszeit für live (in Minuten). Muss eine Zahl zwischen 1 und 1440 sein.
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.
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.
Eine durch Leerzeichen getrennte Liste von Bezeichnungen, die diesem Ereignisabonnement zugeordnet werden sollen.
Maximale Anzahl von Übermittlungsversuchen. Muss eine Zahl zwischen 1 und 30 sein.
Maximale Anzahl von Ereignissen in einem Batch. Muss eine Zahl im Bereich 1 bis 5.000 sein.
Bevorzugte Batchgröße in Kilobyte. Muss eine Zahl im Bereich 1 bis 1.024 sein.
Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Präfix. Platzhalterzeichen werden nicht unterstützt.
Geben Sie an, ob die Betrefffelder in einer Groß-/Kleinschreibung verglichen werden sollen. True, wenn die Kennzeichnung vorhanden ist.
Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Suffix. Platzhalterzeichen werden nicht unterstützt.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az eventgrid system-topic event-subscription delete
Löschen eines Ereignisabonnements eines Systemthemas.
az eventgrid system-topic event-subscription delete --name
--resource-group
--system-topic-name
[--yes]Beispiele
Löschen eines Ereignisabonnements für ein Ereignisrastersystemthema.
az eventgrid system-topic event-subscription delete --name es1 \
-g rg1 --system-topic-name systemtopic1 \Erforderliche Parameter
Name des Ereignisabonnements.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Systemthemas.
Optionale Parameter
Nicht zur Bestätigung auffordern
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az eventgrid system-topic event-subscription delete (eventgrid Erweiterung)
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 Systemthemas.
az eventgrid system-topic event-subscription delete --name
--resource-group
--system-topic-nameBeispiele
Löschen eines Ereignisabonnements für ein Ereignisrastersystemthema.
az eventgrid system-topic event-subscription delete --name es1 \
-g rg1 --system-topic-name systemtopic1 \Erforderliche Parameter
Name des Ereignisabonnements.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Systemthemas.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az eventgrid system-topic event-subscription list
Auflisten von Ereignisabonnements eines bestimmten Systemthemas.
az eventgrid system-topic event-subscription list --resource-group
--system-topic-name
[--odata-query]Beispiele
Auflisten aller Ereignisabonnements, die für ein Ereignisrastersystemthema erstellt wurden.
az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1Erforderliche Parameter
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Systemthemas.
Optionale Parameter
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
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az eventgrid system-topic event-subscription list (eventgrid Erweiterung)
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 Systemthemas.
az eventgrid system-topic event-subscription list --resource-group
--system-topic-name
[--odata-query]Beispiele
Auflisten aller Ereignisabonnements, die für ein Ereignisrastersystemthema erstellt wurden.
az eventgrid system-topic event-subscription list -g rg1 --system-topic-name systemtopic1Erforderliche Parameter
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Systemthemas.
Optionale Parameter
Die Abfrage zum Filtern der Ergebnisse mithilfe der OData-Syntax.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az eventgrid system-topic event-subscription show
Rufen Sie die Details eines Ereignisabonnements eines Systemthemas ab.
az eventgrid system-topic event-subscription show --name
--resource-group
--system-topic-name
[--include-attrib-secret {false, true}]
[--include-full-endpoint-url {false, true}]Beispiele
Zeigen Sie die Details eines Ereignisabonnements für ein Ereignisrastersystemthema an.
az eventgrid system-topic event-subscription show --name es1 \
-g rg1 --system-topic-name systemtopic1Zeigen Sie die Details eines Ereignisabonnements für ein Ereignisrastersystemthema an, einschließlich aller geheimen Schlüssel des statischen Übermittlungsattributs.
az eventgrid system-topic event-subscription show --name es1 \
-g rg1 --system-topic-name systemtopic1 --include-attrib-secretErforderliche Parameter
Name des Ereignisabonnements.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Systemthemas.
Optionale Parameter
Gibt an, ob geheime Schlüssel für statische Übermittlungsattribute zurückgegeben werden sollen. True, wenn die Kennzeichnung vorhanden ist.
Geben Sie an, ob die vollständige Endpunkt-URL zurückgegeben werden soll. True, wenn die Kennzeichnung vorhanden ist.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az eventgrid system-topic event-subscription show (eventgrid Erweiterung)
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 Systemthemas ab.
az eventgrid system-topic event-subscription show --name
--resource-group
--system-topic-name
[--include-full-endpoint-url {false, true}]Beispiele
Zeigen Sie die Details eines Ereignisabonnements für ein Ereignisrastersystemthema an.
az eventgrid system-topic event-subscription show --name es1 \
-g rg1 --system-topic-name systemtopic1Erforderliche Parameter
Name des Ereignisabonnements.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Systemthemas.
Optionale Parameter
Geben Sie an, ob die vollständige Endpunkt-URL zurückgegeben werden soll. True, wenn die Kennzeichnung vorhanden ist.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az eventgrid system-topic event-subscription update
Aktualisieren eines Ereignisabonnements eines Systemthemas.
az eventgrid system-topic event-subscription update --name
--resource-group
--system-topic-name
[--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 Ereignisrastersystemthema, um einen neuen Endpunkt anzugeben.
az eventgrid system-topic event-subscription update --name es1 \
-g rg1 --system-topic-name systemtopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=codeAktualisieren Sie ein Ereignisabonnement für ein Ereignisrastersystemthema, um einen neuen Subject-Ends-with-Filter anzugeben.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .jpgAktualisieren Sie ein Ereignisabonnement für ein Ereignisrastersystemthema, um einen neuen Endpunkt und eine neue Betreff-End-Liste mit einer neuen Liste der enthaltenen Ereignistypen anzugeben.
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeletedAktualisieren Sie ein Ereignisabonnement für ein Azure Event Grid-Systemthema, um ein Deadletter-Ziel einzuschließen.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1Aktualisieren Sie ein Ereignisabonnement für ein Azure Event Grid-Systemthema mithilfe erweiterter Filter.
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--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.netAktualisieren eines Ereignisabonnements für ein Ereignisrastersystemthema mit Speicherwarteschlange als Ziel mit ttl von 5 Minuten
az eventgrid system-topic event-subscription update -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--storage-queue-msg-ttl 300Aktualisieren eines Ereignisabonnements für ein Ereignisrastersystemthema mit erweiterter Filterung auf aktivierte Arrays
az eventgrid system-topic event-subscription update -n es1 \
-g rg1 --system-topic-name systemtopic1 \
--enable-advanced-filtering-on-arrays trueErforderliche Parameter
Name des Ereignisabonnements.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Systemthemas.
Optionale Parameter
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.
Die Azure-Ressourcen-ID eines Azure Storage-Blob-Containerziels, in dem EventGrid nicht zustellbare Ereignisse für dieses Ereignisabonnement speichern soll.
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.
Ermöglicht die Auswertung erweiterter Filter anhand eines Wertearrays, anstatt einen Singularwert zu erwarten.
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.
Der Typ des Zielendpunkts.
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.
Eine durch Leerzeichen getrennte Liste von Bezeichnungen, die diesem Ereignisabonnement zugeordnet werden sollen.
Speicherwarteschlangen-Nachrichtenzeit, um in Sekunden zu leben.
Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Präfix. Platzhalterzeichen werden nicht unterstützt.
Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Suffix. Platzhalterzeichen werden nicht unterstützt.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
az eventgrid system-topic event-subscription update (eventgrid Erweiterung)
Die Befehlsgruppe "az eventgrid" befindet sich in der Vorschau und in der Entwicklung. Referenz- und Supportebenen: https://aka.ms/CLI_refstatus
Aktualisieren eines Ereignisabonnements eines Systemthemas.
az eventgrid system-topic event-subscription update --name
--resource-group
--system-topic-name
[--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 Ereignisrastersystemthema, um einen neuen Endpunkt anzugeben.
az eventgrid system-topic event-subscription update --name es1 \
-g rg1 --system-topic-name systemtopic1 --endpoint https://contoso.azurewebsites.net/api/f1?code=codeAktualisieren Sie ein Ereignisabonnement für ein Ereignisrastersystemthema, um einen neuen Subject-Ends-with-Filter anzugeben.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .jpgAktualisieren Sie ein Ereignisabonnement für ein Ereignisrastersystemthema, um einen neuen Endpunkt und eine neue Betreff-End-Liste mit einer neuen Liste der enthaltenen Ereignistypen anzugeben.
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--subject-ends-with .png \
--endpoint https://contoso.azurewebsites.net/api/f1?code=code
--included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeletedAktualisieren Sie ein Ereignisabonnement für ein Azure Event Grid-Systemthema, um ein Deadletter-Ziel einzuschließen.
az eventgrid system-topic event-subscription update --name es2 \
-g rg1 --system-topic-name systemtopic1 \
--deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1Aktualisieren Sie ein Ereignisabonnement für ein Azure Event Grid-Systemthema mithilfe erweiterter Filter.
az eventgrid system-topic event-subscription update --name es3 \
-g rg1 --system-topic-name systemtopic1 \
--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.netErforderliche Parameter
Name des Ereignisabonnements.
Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.
Name des Systemthemas.
Optionale Parameter
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 StringBeginsWith: --advanced-filter subject StringBeginsWith Blue Red StringEndsWith: --advanced-filter subject StringEndsWith img png jpg NumberIn: --advanced-filter data.property1 NumberIn 5 10 20 NumberNotIn: --advanced-filter data.property2 NumberNotIn 100 200 300 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 BoolEquals true Multiple advanced filters can be specified by using more than one --advanced-filter argument.
Die Azure-Ressourcen-ID eines Azure Storage-Blob-Containerziels, in dem EventGrid nicht zustellbare Ereignisse für dieses Ereignisabonnement speichern soll.
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.
Der Typ des Zielendpunkts.
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.
Eine durch Leerzeichen getrennte Liste von Bezeichnungen, die diesem Ereignisabonnement zugeordnet werden sollen.
Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Präfix. Platzhalterzeichen werden nicht unterstützt.
Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Suffix. Platzhalterzeichen werden nicht unterstützt.
Globale Parameter
Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.
Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.
Nur Fehler anzeigen und Warnungen unterdrücken.
Ausgabeformat.
JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.
Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.
Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für