Freigeben über

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

Verwalten von Ereignisabonnements für ein Ereignisrasterthema, do Standard, do Standard topic, Azure-Abonnement, Ressourcengruppe oder für eine andere Azure-Ressource, die Ereignisbenachrichtigungen unterstützt.

Befehle

Name Beschreibung Typ Status
az eventgrid event-subscription create

Erstellen Sie ein neues Ereignisabonnement.

 Core Allgemein verfügbar
az eventgrid event-subscription create (eventgrid Erweiterung)

Erstellen Sie ein neues Ereignisabonnement.

 Erweiterung Vorschau
az eventgrid event-subscription delete

Löschen Sie ein Ereignisabonnement.

 Core Allgemein verfügbar
az eventgrid event-subscription delete (eventgrid Erweiterung)

Löschen Sie ein Ereignisabonnement.

 Erweiterung Vorschau
az eventgrid event-subscription list

Auflisten von Ereignisabonnements.

 Core Allgemein verfügbar
az eventgrid event-subscription list (eventgrid Erweiterung)

Auflisten von Ereignisabonnements.

 Erweiterung Vorschau
az eventgrid event-subscription show

Rufen Sie die Details eines Ereignisabonnements ab.

 Core Allgemein verfügbar
az eventgrid event-subscription show (eventgrid Erweiterung)

Rufen Sie die Details eines Ereignisabonnements ab.

 Erweiterung Vorschau
az eventgrid event-subscription update

Aktualisieren sie ein Ereignisabonnement.

 Core Allgemein verfügbar
az eventgrid event-subscription update (eventgrid Erweiterung)

Aktualisieren sie ein Ereignisabonnement.

 Erweiterung Vorschau

az eventgrid event-subscription create

Bearbeiten

Erstellen Sie ein neues Ereignisabonnement.

az eventgrid event-subscription create --name
                                       [--aad-tenant-id]
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--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]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Beispiele

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisrasterthema mithilfe von Standardfiltern.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement für ein Azure-Abonnement mithilfe von Standardfiltern.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement für eine Ressourcengruppe mithilfe von Standardfiltern.

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement für ein Speicherkonto mithilfe von Standardfiltern.

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement für ein Speicherkonto mit erweiterten Filtern.

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

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

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Erstellen Sie ein neues Ereignisabonnement für eine Ressourcengruppe mit einem Filter, der ein Betreffsuffix angibt.

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

Erstellen Sie ein neues Ereignisabonnement für ein Azure-Abonnement mit Standardfiltern und einem EventHub als Ziel.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

Erstellen Sie ein neues Ereignisabonnement für ein Azure-Abonnement mit Standardfiltern und einer Azure Storage-Warteschlange als Ziel.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

Erstellen Sie ein neues Ereignisabonnement für ein Azure-Abonnement mit Standardfiltern und einem Azure ServiceBusQueue als Ziel.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Erstellen Sie ein neues Ereignisabonnement für ein Speicherkonto 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).

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

Erstellen Sie ein neues Ereignisabonnement für ein Do Standard Thema.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement (für ein Speicherkonto) mit einem Ablaufdatum.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

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

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --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 Ereignisrasterthema, das Azure-Funktion als Ziel verwendet.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Erstellen eines neuen Ereignisabonnements für ein Ereignisrasterthema mithilfe von Eventhub mit systemassignierten MSI-Identität als Ziel und mit Deadletter mit MSI-Identität

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

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

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --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 Ereignisrasterthema mithilfe von StorageQueue mit systemassignierten MSI-Identität als Ziel

az eventgrid event-subscription create -n {EventSubscriptionName} --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type StorageQueue --delivery-identity systemassigned --delivery-identity-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 Ereignisrasterthema mit aktivierter erweiterter Filterung auf Arrays

az eventgrid event-subscription create -n es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1
    --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.

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.

--deadletter-identity
Vorschau

Der Identitätstyp der Deadletter-Zielressource.

Zulässige Werte: systemassigned
--deadletter-identity-endpoint

Die Azure-Ressourcen-ID eines Azure Storage-BLOB-Containerziels mit Identität, bei der EventGrid für dieses Ereignisabonnement unzustellbare Ereignisse inaktiv werden soll.

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

--delivery-identity
Vorschau

Der Identitätstyp der Übermittlungszielressource (z. B. Speicherwarteschlange oder EventHub).

Zulässige Werte: systemassigned
--delivery-identity-endpoint
Vorschau

Endpunkt mit Identität, bei dem EventGrid Ereignisse bereitstellen soll, die mit diesem Ereignisabonnement übereinstimmen. Für den Webhook-Endpunkttyp sollte dies die entsprechende Webhook-URL sein. Bei anderen Endpunkttypen sollte dies der Azure-Ressourcenbezeichner des Endpunkts sein.

--delivery-identity-endpoint-type
Vorschau

Der Typ des Zielendpunkts mit Ressourcenidentität.

Zulässige Werte: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--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.

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.

--source-resource-id

Vollqualifizierter Bezeichner der Azure-Ressource, für die das Ereignisabonnement erstellt werden muss.

Verwendung: --source-resource-id Azure-Resource-ID Für Azure-Abonnement: --source-resource-id /subscriptions/{SubID} Für Ressourcengruppe: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id //subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid doStandard: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1 For EventGrid do Standard topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1/topics/t1.

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

az eventgrid event-subscription create --name
                                       [--advanced-filter]
                                       [--azure-active-directory-application-id-or-uri]
                                       [--azure-active-directory-tenant-id]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--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]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-case-sensitive {false, true}]
                                       [--subject-ends-with]

Beispiele

Erstellen Sie ein neues Ereignisabonnement für ein Ereignisrasterthema mithilfe von Standardfiltern.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement für ein Azure-Abonnement mithilfe von Standardfiltern.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement für eine Ressourcengruppe mithilfe von Standardfiltern.

az eventgrid event-subscription create --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement für ein Speicherkonto mithilfe von Standardfiltern.

az eventgrid event-subscription create --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1"  \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement für ein Speicherkonto mit erweiterten Filtern.

az eventgrid event-subscription create  --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

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

az eventgrid event-subscription create --name es4 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-begins-with mysubject_prefix

Erstellen Sie ein neues Ereignisabonnement für eine Ressourcengruppe mit einem Filter, der ein Betreffsuffix angibt.

az eventgrid event-subscription create --name es5 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --subject-ends-with mysubject_suffix

Erstellen Sie ein neues Ereignisabonnement für ein Azure-Abonnement mit Standardfiltern und einem EventHub als Ziel.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type eventhub \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.EventHub/namespaces/n1/eventhubs/EH1

Erstellen Sie ein neues Ereignisabonnement für ein Azure-Abonnement mit Standardfiltern und einer Azure Storage-Warteschlange als Ziel.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type storagequeue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/queueservices/default/queues/q1

Erstellen Sie ein neues Ereignisabonnement für ein Azure-Abonnement mit Standardfiltern und einem Azure ServiceBusQueue als Ziel.

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --endpoint-type servicebusqueue \
    --endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.ServiceBus/namespaces/ns1/queues/queue1

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

az eventgrid event-subscription create --name es2 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code \
    --event-delivery-schema cloudeventschemav1_0

Erstellen Sie ein neues Ereignisabonnement für ein Speicherkonto 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).

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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

Erstellen Sie ein neues Ereignisabonnement für ein Do Standard Thema.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/t1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Erstellen Sie ein neues Ereignisabonnement (für ein Speicherkonto) mit einem Ablaufdatum.

az eventgrid event-subscription create --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/sa1" \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code
    --expiration-date "2018-10-31"

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

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --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 Ereignisrasterthema, das Azure-Funktion als Ziel verwendet.

az eventgrid event-subscription create --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Web/sites/{functionappname}/functions/{functionname} --endpoint-type azurefunction

Erstellen eines neuen Ereignisabonnements für ein Ereignisrasterthema mithilfe von Eventhub mit systemassignierten MSI-Identität als Ziel und mit Deadletter mit MSI-Identität

az eventgrid event-subscription create --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --delivery-identity-endpoint-type eventhub --delivery-identity systemassigned --delivery-identity-endpoint /subscriptions/{SubId2|}/resourceGroups/{RG2}/providers/Microsoft.eventhub/namespaces/{EventHubNamespace}/eventhubs/{EventhubName} \
    --deadletter-identity-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/s2/blobServices/default/containers/blobcontainer1 --deadletter-identity systemassigned -n {EventSubscriptionName}

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

Optionale Parameter

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

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

--deadletter-identity

Der Identitätstyp der Deadletter-Zielressource.

Zulässige Werte: systemassigned
--deadletter-identity-endpoint

Die Azure-Ressourcen-ID eines Azure Storage-BLOB-Containerziels mit Identität, bei der EventGrid für dieses Ereignisabonnement unzustellbare Ereignisse inaktiv werden soll.

--delivery-identity

Der Identitätstyp der Übermittlungszielressource (z. B. Speicherwarteschlange oder EventHub).

Zulässige Werte: systemassigned
--delivery-identity-endpoint

Endpunkt mit Identität, bei dem EventGrid Ereignisse bereitstellen soll, die mit diesem Ereignisabonnement übereinstimmen. Für den Webhook-Endpunkttyp sollte dies die entsprechende Webhook-URL sein. Bei anderen Endpunkttypen sollte dies der Azure-Ressourcenbezeichner des Endpunkts sein.

--delivery-identity-endpoint-type

Der Typ des Zielendpunkts mit Ressourcenidentität.

Zulässige Werte: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--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.

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

--source-resource-id

Vollqualifizierter Bezeichner der Azure-Ressource, für die das Ereignisabonnement erstellt werden muss.

Verwendung: --source-resource-id Azure-Resource-ID Für Azure-Abonnement: --source-resource-id /subscriptions/{SubID} Für Ressourcengruppe: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id //subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid doStandard: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1 For EventGrid do Standard topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1/topics/t1.

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

Bearbeiten

Löschen Sie ein Ereignisabonnement.

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Beispiele

Löschen eines Ereignisabonnements für ein Ereignisrasterthema.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Löschen Sie ein Ereignisabonnement für ein Ereignisraster Standard Thema.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Löschen Sie ein Ereignisabonnement für ein Ereignisraster Standard.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Löschen Eines Ereignisabonnements für ein Azure-Abonnement.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

Löschen Eines Ereignisabonnements für eine Ressourcengruppe.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Löschen Eines Ereignisabonnements für ein Speicherkonto.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

Optionale Parameter

--source-resource-id

Vollqualifizierter Bezeichner der Azure-Ressource, deren Ereignisabonnement gelöscht werden muss.

Verwendung: --source-resource-id Azure-Resource-ID Für Azure-Abonnement: --source-resource-id /subscriptions/{SubID} Für Ressourcengruppe: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id //subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid doStandard: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1 For EventGrid do Standard topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1/topics/t1.

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 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 Sie ein Ereignisabonnement.

az eventgrid event-subscription delete --name
                                       [--source-resource-id]

Beispiele

Löschen eines Ereignisabonnements für ein Ereignisrasterthema.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Löschen Sie ein Ereignisabonnement für ein Ereignisraster Standard Thema.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1/topics/topic1

Löschen Sie ein Ereignisabonnement für ein Ereignisraster Standard.

az eventgrid event-subscription delete --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/domain1

Löschen Eines Ereignisabonnements für ein Azure-Abonnement.

az eventgrid event-subscription delete --name es2 \
    --source-resource-id /subscriptions/{SubID}

Löschen Eines Ereignisabonnements für eine Ressourcengruppe.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Löschen Eines Ereignisabonnements für ein Speicherkonto.

az eventgrid event-subscription delete --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

Optionale Parameter

--source-resource-id

Vollqualifizierter Bezeichner der Azure-Ressource, deren Ereignisabonnement gelöscht werden muss.

Verwendung: --source-resource-id Azure-Resource-ID Für Azure-Abonnement: --source-resource-id /subscriptions/{SubID} Für Ressourcengruppe: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id //subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid doStandard: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1 For EventGrid do Standard topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1/topics/t1.

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

Bearbeiten

Auflisten von Ereignisabonnements.

Event Grid unterstützt sowohl regionale als auch globale Ereignisabonnements: Ereignisabonnements für regionale Ressourcen (z. B. Speicherkonten oder Event Grid-Themen) sind regional, während Ereignisabonnements für globale Ressourcen (z. B. ein Azure-Abonnement oder eine Ressourcengruppe) global sind. Daher können Sie Ereignisabonnements auf verschiedene Arten auflisten:

  1. Geben Sie den Parameter "--source-resource-id" an, um die Ressourcen-ID der Ressource auflisten zu können, deren Ereignisabonnements Sie auflisten möchten. Es müssen keine anderen Parameter angegeben werden.
  2. Geben Sie zum Auflisten nach einem Thementyp (z. B. Speicherkonten) den Parameter "--topic-type" zusammen mit dem Parameter "--location" (z. B. "westus2") an. Geben Sie für globale Thementypen (z. B. "Microsoft.Resources.Subscriptions") den Standortwert als "global" an.
  3. Wenn Sie alle Ereignisabonnements in einer Region (über alle Thementypen hinweg) auflisten möchten, geben Sie nur den Parameter "-location" an.
  4. Damit sowohl #2 als auch #3 oben nur nach einer Ressourcengruppe gefiltert werden kann, können Sie zusätzlich den Parameter "--resource-group" angeben.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Beispiele

Auflisten aller Ereignisabonnements, die für ein Ereignisrasterthema erstellt wurden.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Listet alle Ereignisabonnements auf, die für ein Speicherkonto erstellt wurden.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

Listet alle Ereignisabonnements auf, die für ein Azure-Abonnement erstellt wurden.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

Listet alle Ereignisabonnements auf, die für eine Ressourcengruppe erstellt wurden.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Listet alle Ereignisabonnements für ein Ereignisraster auf Standard.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

Auflisten aller Ereignisabonnements für ein Ereignisraster Standard Thema.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Auflisten aller Speicherereignisabonnements (unter dem aktuell ausgewählten Azure-Abonnement) in Westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Alle Speicherereignisabonnements (unter der angegebenen Ressourcengruppe) in Westus2 auflisten.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Auflisten aller regionalen oder globalen Ereignisabonnements (unter dem aktuell ausgewählten Azure-Abonnement).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

Auflisten aller regionalen oder globalen Ereignisabonnements unter einer angegebenen Ressourcengruppe.

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

Auflisten aller Ereignisabonnements für ein Ereignisraster Standard dessen Name das Muster "XYZ" enthält

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Alle Ereignisabonnements für ein Ereignisraster auflisten Standard mit Ausnahme des Ereignisabonnements mit dem Namen "name1"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

Optionale Parameter

--location -l

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

--odata-query

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

--resource-group -g

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

--source-resource-id

Vollqualifizierter Bezeichner der Azure-Ressource, deren Ereignisabonnement aufgelistet werden muss.

Verwendung: --source-resource-id Azure-Resource-ID Für Azure-Abonnement: --source-resource-id /subscriptions/{SubID} Für Ressourcengruppe: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id //subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid doStandard: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1 For EventGrid do Standard topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1/topics/t1.

--topic-type-name

Name des Thementyps, dessen Ereignisabonnements aufgelistet werden müssen. Wenn dies angegeben ist, müssen Sie auch --location angeben.

Beispiel 1: Auflisten aller Speicherereignisabonnements in WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Beispiel 2: Auflisten aller Ereignisabonnements in Azure-Abonnements --topic-type-name Microsoft.Resources.Subscriptions --location global.

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

Event Grid unterstützt sowohl regionale als auch globale Ereignisabonnements: Ereignisabonnements für regionale Ressourcen (z. B. Speicherkonten oder Event Grid-Themen) sind regional, während Ereignisabonnements für globale Ressourcen (z. B. ein Azure-Abonnement oder eine Ressourcengruppe) global sind. Daher können Sie Ereignisabonnements auf verschiedene Arten auflisten:

  1. Geben Sie den Parameter "--source-resource-id" an, um die Ressourcen-ID der Ressource auflisten zu können, deren Ereignisabonnements Sie auflisten möchten. Es müssen keine anderen Parameter angegeben werden.
  2. Geben Sie zum Auflisten nach einem Thementyp (z. B. Speicherkonten) den Parameter "--topic-type" zusammen mit dem Parameter "--location" (z. B. "westus2") an. Geben Sie für globale Thementypen (z. B. "Microsoft.Resources.Subscriptions") den Standortwert als "global" an.
  3. Wenn Sie alle Ereignisabonnements in einer Region (über alle Thementypen hinweg) auflisten möchten, geben Sie nur den Parameter "-location" an.
  4. Damit sowohl #2 als auch #3 oben nur nach einer Ressourcengruppe gefiltert werden kann, können Sie zusätzlich den Parameter "--resource-group" angeben.
az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Beispiele

Auflisten aller Ereignisabonnements, die für ein Ereignisrasterthema erstellt wurden.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1

Listet alle Ereignisabonnements auf, die für ein Speicherkonto erstellt wurden.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob

Listet alle Ereignisabonnements auf, die für ein Azure-Abonnement erstellt wurden.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}

Listet alle Ereignisabonnements auf, die für eine Ressourcengruppe erstellt wurden.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}

Listet alle Ereignisabonnements für ein Ereignisraster auf Standard.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1

Auflisten aller Ereignisabonnements für ein Ereignisraster Standard Thema.

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1/topics/topic1

Auflisten aller Speicherereignisabonnements (unter dem aktuell ausgewählten Azure-Abonnement) in Westus2.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2

Alle Speicherereignisabonnements (unter der angegebenen Ressourcengruppe) in Westus2 auflisten.

az eventgrid event-subscription list --topic-type Microsoft.Storage.StorageAccounts --location westus2 --resource-group {RG}

Auflisten aller regionalen oder globalen Ereignisabonnements (unter dem aktuell ausgewählten Azure-Abonnement).

az eventgrid event-subscription list --location westus2
az eventgrid event-subscription list --location global

Auflisten aller regionalen oder globalen Ereignisabonnements unter einer angegebenen Ressourcengruppe.

az eventgrid event-subscription list --location westus2 --resource-group {RG}
az eventgrid event-subscription list --location global --resource-group {RG}

Auflisten aller Ereignisabonnements für ein Ereignisraster Standard dessen Name das Muster "XYZ" enthält

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "Contains(name, 'XYZ')"

Alle Ereignisabonnements für ein Ereignisraster auflisten Standard mit Ausnahme des Ereignisabonnements mit dem Namen "name1"

az eventgrid event-subscription list --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/domains/d1 --odata-query "NOT (name eq 'name1')"

Optionale Parameter

--location -l

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

--odata-query

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

--resource-group -g

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

--source-resource-id

Vollqualifizierter Bezeichner der Azure-Ressource, deren Ereignisabonnement aufgelistet werden muss.

Verwendung: --source-resource-id Azure-Resource-ID Für Azure-Abonnement: --source-resource-id /subscriptions/{SubID} Für Ressourcengruppe: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id //subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid doStandard: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1 For EventGrid do Standard topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1/topics/t1.

--topic-type-name

Name des Thementyps, dessen Ereignisabonnements aufgelistet werden müssen. Wenn dies angegeben ist, müssen Sie auch --location angeben.

Beispiel 1: Auflisten aller Speicherereignisabonnements in WestUS2 --resource-group TestRG --topic-type-name Microsoft.Storage.StorageAccounts --location westus2 Beispiel 2: Auflisten aller Ereignisabonnements in Azure-Abonnements --topic-type-name Microsoft.Resources.Subscriptions --location global.

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

Bearbeiten

Rufen Sie die Details eines Ereignisabonnements ab.

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

Beispiele

Zeigen Sie die Details eines Ereignisabonnements für ein Ereignisrasterthema an.

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

Zeigen Sie die Details eines Ereignisabonnements für ein Azure-Abonnement an.

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

Zeigen Sie die Details eines Ereignisabonnements für eine Ressourcengruppe an.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

Zeigen Sie die Details eines Ereignisabonnements für ein Speicherkonto an.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

Zeigen Sie die Details eines Ereignisabonnements für eine Ressourcengruppe einschließlich aller geheimen Schlüssel des statischen Übermittlungsattributs an.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 \
    --include-static-delivery-attribute-secret

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

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
--source-resource-id

Vollqualifizierter Bezeichner der Azure-Ressource, deren Ereignisabonnement angezeigt werden muss.

Verwendung: --source-resource-id Azure-Resource-ID Für Azure-Abonnement: --source-resource-id /subscriptions/{SubID} Für Ressourcengruppe: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id //subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid doStandard: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1 For EventGrid do Standard topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1/topics/t1.

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

az eventgrid event-subscription show --name
                                     [--include-full-endpoint-url {false, true}]
                                     [--source-resource-id]

Beispiele

Zeigen Sie die Details eines Ereignisabonnements für ein Ereignisrasterthema an.

az eventgrid event-subscription show --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/topic1

Zeigen Sie die Details eines Ereignisabonnements für ein Azure-Abonnement an.

az eventgrid event-subscription show --name es2 \
    --source-resource-id /subscriptions/{SubID}

Zeigen Sie die Details eines Ereignisabonnements für eine Ressourcengruppe an.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1

Zeigen Sie die Details eines Ereignisabonnements für ein Speicherkonto an.

az eventgrid event-subscription show --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/microsoft.storage/storageaccounts/kalsegblob

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

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
--source-resource-id

Vollqualifizierter Bezeichner der Azure-Ressource, deren Ereignisabonnement angezeigt werden muss.

Verwendung: --source-resource-id Azure-Resource-ID Für Azure-Abonnement: --source-resource-id /subscriptions/{SubID} Für Ressourcengruppe: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id //subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid doStandard: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1 For EventGrid do Standard topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1/topics/t1.

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

Bearbeiten

Aktualisieren sie ein Ereignisabonnement.

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-attribute-mapping]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--enable-advanced-filtering-on-arrays {false, true}]
                                       [--endpoint]
                                       [--endpoint-type]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--qttl]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Beispiele

Aktualisieren Sie ein Ereignisabonnement für ein Ereignisrasterthema, um einen neuen Endpunkt anzugeben.

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

Aktualisieren Sie ein Ereignisabonnement für eine Ressourcengruppe, um einen neuen Endpunkt und einen neuen Betreff-End-Filter anzugeben.

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Aktualisieren Sie ein Ereignisabonnement für ein Speicherkonto, um eine neue Liste der eingeschlossenen Ereignistypen anzugeben.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Aktualisieren Sie ein Ereignisabonnement für ein Speicherkonto, um ein Deadletter-Ziel einzuschließen.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Aktualisieren Sie ein Ereignisabonnement für ein Speicherkonto mithilfe erweiterter Filter.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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 Sie ein Ereignisabonnement für ein Speicherkonto so, dass nachrichtenttl auf 5 Minuten festgelegt ist.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --storage-queue-msg-ttl 300

Aktualisieren eines Ereignisabonnements mit aktivierter erweiterter Filterung auf Arrays

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --enable-advanced-filtering-on-arrays true

Erforderliche Parameter

--name -n

Name des Ereignisabonnements.

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []
--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.

--deadletter-endpoint

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

--deadletter-identity
Vorschau

Der Identitätstyp der Deadletter-Zielressource.

Zulässige Werte: systemassigned
--deadletter-identity-endpoint

Die Azure-Ressourcen-ID eines Azure Storage-BLOB-Containerziels mit Identität, bei der EventGrid für dieses Ereignisabonnement unzustellbare Ereignisse inaktiv werden soll.

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

--delivery-identity
Vorschau

Der Identitätstyp der Übermittlungszielressource (z. B. Speicherwarteschlange oder EventHub).

Zulässige Werte: systemassigned
--delivery-identity-endpoint
Vorschau

Endpunkt mit Identität, bei dem EventGrid Ereignisse bereitstellen soll, die mit diesem Ereignisabonnement übereinstimmen. Für den Webhook-Endpunkttyp sollte dies die entsprechende Webhook-URL sein. Bei anderen Endpunkttypen sollte dies der Azure-Ressourcenbezeichner des Endpunkts sein.

--delivery-identity-endpoint-type
Vorschau

Der Typ des Zielendpunkts mit Ressourcenidentität.

Zulässige Werte: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--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.

Standardwert: webhook
--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False
--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.

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

Speicherwarteschlangen-Nachrichtenzeit, um in Sekunden zu leben.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
--source-resource-id

Vollqualifizierter Bezeichner der Azure-Ressource, deren Ereignisabonnement aktualisiert werden muss.

Verwendung: --source-resource-id Azure-Resource-ID Für Azure-Abonnement: --source-resource-id /subscriptions/{SubID} Für Ressourcengruppe: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id //subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid doStandard: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1 For EventGrid do Standard topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1/topics/t1.

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

az eventgrid event-subscription update --name
                                       [--add]
                                       [--advanced-filter]
                                       [--deadletter-endpoint]
                                       [--deadletter-identity {systemassigned}]
                                       [--deadletter-identity-endpoint]
                                       [--delivery-identity {systemassigned}]
                                       [--delivery-identity-endpoint]
                                       [--delivery-identity-endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--endpoint]
                                       [--endpoint-type {azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook}]
                                       [--force-string]
                                       [--included-event-types]
                                       [--labels]
                                       [--remove]
                                       [--set]
                                       [--source-resource-id]
                                       [--subject-begins-with]
                                       [--subject-ends-with]

Beispiele

Aktualisieren Sie ein Ereignisabonnement für ein Ereignisrasterthema, um einen neuen Endpunkt anzugeben.

az eventgrid event-subscription update --name es1 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/topics/topic1 \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

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

az eventgrid event-subscription update --name es2 \
    --source-resource-id /subscriptions/{SubID} \
    --subject-ends-with .jpg

Aktualisieren Sie ein Ereignisabonnement für eine Ressourcengruppe, um einen neuen Endpunkt und einen neuen Betreff-End-Filter anzugeben.

az eventgrid event-subscription update --name es3 \
    --source-resource-id /subscriptions/{SubID}/resourceGroups/{RG} \
    --subject-ends-with .png \
    --endpoint https://contoso.azurewebsites.net/api/f1?code=code

Aktualisieren Sie ein Ereignisabonnement für ein Speicherkonto, um eine neue Liste der eingeschlossenen Ereignistypen anzugeben.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/microsoft.storage/storageaccounts/kalsegblob" \
    --included-event-types Microsoft.Storage.BlobCreated Microsoft.Storage.BlobDeleted

Aktualisieren Sie ein Ereignisabonnement für ein Speicherkonto, um ein Deadletter-Ziel einzuschließen.

az eventgrid event-subscription update --name es2 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/kalsegblob" \
    --deadletter-endpoint /subscriptions/{SubID}/resourceGroups/TestRG/providers/Microsoft.Storage/storageAccounts/sa1/blobServices/default/containers/blobcontainer1

Aktualisieren Sie ein Ereignisabonnement für ein Speicherkonto mithilfe erweiterter Filter.

az eventgrid event-subscription update --name es3 \
    --source-resource-id "/subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.Storage/storageaccounts/s1" \
    --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.

Optionale Parameter

--add

Fügen Sie einer Liste von Objekten ein Objekt hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

Standardwert: []
--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 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.

--deadletter-endpoint

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

--deadletter-identity

Der Identitätstyp der Deadletter-Zielressource.

Zulässige Werte: systemassigned
--deadletter-identity-endpoint

Die Azure-Ressourcen-ID eines Azure Storage-BLOB-Containerziels mit Identität, bei der EventGrid für dieses Ereignisabonnement unzustellbare Ereignisse inaktiv werden soll.

--delivery-identity

Der Identitätstyp der Übermittlungszielressource (z. B. Speicherwarteschlange oder EventHub).

Zulässige Werte: systemassigned
--delivery-identity-endpoint

Endpunkt mit Identität, bei dem EventGrid Ereignisse bereitstellen soll, die mit diesem Ereignisabonnement übereinstimmen. Für den Webhook-Endpunkttyp sollte dies die entsprechende Webhook-URL sein. Bei anderen Endpunkttypen sollte dies der Azure-Ressourcenbezeichner des Endpunkts sein.

--delivery-identity-endpoint-type

Der Typ des Zielendpunkts mit Ressourcenidentität.

Zulässige Werte: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
--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.

--endpoint-type

Der Typ des Zielendpunkts.

Zulässige Werte: azurefunction, eventhub, hybridconnection, servicebusqueue, servicebustopic, storagequeue, webhook
Standardwert: webhook
--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgenliterale bei, anstatt zu versuchen, in JSON zu konvertieren.

Standardwert: False
--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.

--remove

Entfernen sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list <indexToRemove> ODER --remove propertyToRemove.

Standardwert: []
--set

Aktualisieren Sie ein Objekt, indem Sie einen festzulegenden Eigenschaftspfad und -wert angeben. Beispiel: --set property1.property2=<value>.

Standardwert: []
--source-resource-id

Vollqualifizierter Bezeichner der Azure-Ressource, deren Ereignisabonnement aktualisiert werden muss.

Verwendung: --source-resource-id Azure-Resource-ID Für Azure-Abonnement: --source-resource-id /subscriptions/{SubID} Für Ressourcengruppe: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1 For EventGrid topic: --source-resource-id //subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/topics/t1 For storage account: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.Storage/storageaccounts/sa1 For EventGrid doStandard: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1 For EventGrid do Standard topic: --source-resource-id /subscriptions/{SubID}/resourceGroups/rg1/providers/Microsoft.EventGrid/do Standard s/d1/topics/t1.

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