az eventgrid event-subscription

Referenz

Verwalten von Ereignisabonnements.

Verwalten von Ereignisabonnements für ein Ereignisrasterthema, Domäne, Domänenthema, Azure-Abonnement, Ressourcengruppe oder für andere Azure-Ressourcen, die Ereignisbenachrichtigungen unterstützen.

Befehle

az eventgrid event-subscription create	Erstellen Sie ein neues Ereignisabonnement.
az eventgrid event-subscription delete	Löschen Sie ein Ereignisabonnement.
az eventgrid event-subscription list	Listenereignisabonnements.
az eventgrid event-subscription show	Rufen Sie die Details eines Ereignisabonnements ab.
az eventgrid event-subscription update	Aktualisieren eines Ereignisabonnements.

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 mit 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 mit 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 mit 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, indem Sie erweiterte Filter verwenden.

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, indem Sie Standardfilter und ein Azure ServiceBusQueue als Ziel verwenden.

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 eine Ereignisrasterdomäne 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 zuvor 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 Domänenthema.

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 Eines neuen Ereignisabonnements für ein Ereignisrasterthema mithilfe von Azure Active Directory aktivierten Webhook als Ziel.

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, indem Sie Azure Function als Ziel verwenden.

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, verwenden Sie Eventhub mit systemassignierte 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 Nachrichten ttl bei 5 Min.

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 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 die Filterung von Ereignissen basierend auf einer bestimmten Ereigniseigenschaft.

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

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

--deadletter-endpoint

Die Azure-Ressourcen-ID eines Azure Storage-Blob-Containerziels, an dem EventGrid das Uneliverable-Ereignis für dieses Ereignisabonnement beenden sollte.

--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, in dem EventGrid uneliverable Ereignisse für dieses Ereignisabonnement totgestellt werden soll.

--delivery-attribute-mapping

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

--delivery-identity

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

Zulässige Werte: systemassigned

--delivery-identity-endpoint

Endpunkt mit Identität, bei dem EventGrid Ereignisse mit diesem Ereignisabonnement bereitstellen sollte. Bei Webhook-Endpunkttyp sollte dies die entsprechende Webhook-URL sein. Für andere 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

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

Ermöglicht erweiterten Filtern, die anhand eines Arrays von Werten ausgewertet werden können, anstatt einen singularen Wert zu erwarten.

Zulässige Werte: false, true

--endpoint

Endpunkt, in dem EventGrid Ereignisse mit diesem Ereignisabonnement bereitstellen sollte. Bei Webhook-Endpunkttyp sollte dies die entsprechende Webhook-URL sein. Für andere 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 gleichen 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 zu live (in Minuten). Muss eine Zahl zwischen 1 und 1440 sein.

Standardwert: 1440

--expiration-date

Datum oder Datum (in UTC, z. B. '2018-11-30T11:59:59:59+00:00' oder '2018-11-30'), nach dem das Ereignisabonnement abläuft. Standardmäßig gibt es keinen Ablauf für das Ereignisabonnement.

--included-event-types

Eine leer 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 mithilfe dieses CLI-Befehls "az eventgrid topic-type list-event-type" abfragen.

--labels

Eine leer 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 Kilobytes. Muss eine Zahl im Bereich 1 bis 1.024 sein.

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

Zeit der Speicherwarteschlange, die in Sekunden zu leben ist.

--source-resource-id

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

--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 auf eine Groß-/Kleinschreibung verglichen werden sollen. True, wenn das Flag vorhanden ist.

Zulässige Werte: false, true

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

--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 eines Ereignisabonnements für ein Ereignisrasterdomänenthema.

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

Löschen eines Ereignisabonnements für eine Ereignisrasterdomäne.

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.

Globale Parameter

--debug

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

--help -h

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

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

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

--verbose

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

az eventgrid event-subscription list

Bearbeiten

Listenereignisabonnements.

Event Grid unterstützt sowohl regionale als auch globale Ereignisabonnements: Ereignisabonnements für regionale Ressourcen (z. B. Speicherkonten oder Ereignisrasterthemen) 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 einige verschiedene Weise auflisten:

Geben Sie zum Auflisten der Ressourcen-ID der Ressource, deren Ereignisabonnements Sie auflisten möchten, den Parameter --source-resource-id an. Es müssen keine anderen Parameter angegeben werden.
Wenn Sie einen Thematyp (z. B. Speicherkonten) auflisten möchten, geben Sie den Parameter "-thementyp" zusammen mit dem Parameter "-location" (z. B. "westus2") an. Geben Sie für globale Thementypen (z. B. "Microsoft.Resources.Abonnements") den Speicherortwert als "global" an.
Wenn Sie alle Ereignisabonnements in einer Region (in allen Thementypen) auflisten möchten, geben Sie nur den Parameter "-location" an.
Um sowohl #2 als auch #3 oben zu filtern, können Sie nur nach einer Ressourcengruppe filtern, sie können zusätzlich den Parameter --resource-group angeben.

az eventgrid event-subscription list [--location]
                                     [--odata-query]
                                     [--resource-group]
                                     [--source-resource-id]
                                     [--topic-type-name]

Beispiele

Alle Ereignisabonnements auflisten, die für ein Ereignisrasterthema erstellt wurden.

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

Alle Ereignisabonnements auflisten, die für ein Speicherkonto erstellt wurden.

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

Alle Ereignisabonnements auflisten, die für ein Azure-Abonnement erstellt wurden.

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

Alle Ereignisabonnements auflisten, die für eine Ressourcengruppe erstellt wurden.

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

Alle Ereignisabonnements für eine Ereignisrasterdomäne auflisten.

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

Alle Ereignisabonnements für ein Ereignisrasterdomänenthema auflisten.

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

Alle Speicherereignisabonnements (unter dem derzeit ausgewählten Azure-Abonnement) in Westus2 auflisten.

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}

Listet alle regionalen oder globalen Ereignisabonnements auf (unter dem aktuell ausgewählten Azure-Abonnement).

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

Listet alle regionalen oder globalen Ereignisabonnements unter einer angegebenen Ressourcengruppe auf.

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

Alle Ereignisabonnements für eine Ereignisrasterdomäne auflisten, deren 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 eine Ereignisrasterdomäne auflisten, außer dem Ereignisabonnement 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

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

--resource-group -g

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

--source-resource-id

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

--topic-type-name

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

Globale Parameter

--debug

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

--help -h

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

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

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

--verbose

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

az eventgrid 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 an, einschließlich beliebiger statischer Übermittlungsattributschlüssel.

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

Geben Sie an, ob statische Übermittlungsattributeschlüssel zurückgegeben werden sollen. True, wenn das Flag vorhanden ist.

Zulässige Werte: false, true

--include-full-endpoint-url

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

Zulässige Werte: false, true

--source-resource-id

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

Globale Parameter

--debug

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

--help -h

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

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

--query

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

--subscription

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

--verbose

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

az eventgrid event-subscription update

Bearbeiten

Aktualisieren eines Ereignisabonnements.

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 eines Ereignisabonnements 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 Eines Ereignisabonnements für ein Azure-Abonnement, um einen neuen Betreff-End-End-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-Mitfilter 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 enthaltenen 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 eines Ereignisabonnements 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, um nachrichten ttl auf 5 Min. einzuschließen.

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 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 einem Objekt eine Liste von Objekten hinzu, indem Sie ein Pfad- und Schlüsselwertpaar angeben. Beispiel: --add property.listProperty <key=value, string or JSON string>.

--advanced-filter

Ein erweiterter Filter ermöglicht die Filterung von Ereignissen basierend auf einer bestimmten Ereigniseigenschaft.

--deadletter-endpoint

Die Azure-Ressourcen-ID eines Azure Storage-Blob-Containerziels, an dem EventGrid das Uneliverable-Ereignis für dieses Ereignisabonnement beenden sollte.

--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, in dem EventGrid uneliverable Ereignisse für dieses Ereignisabonnement totgestellt werden soll.

--delivery-attribute-mapping

--delivery-identity

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

Zulässige Werte: systemassigned

--delivery-identity-endpoint

--delivery-identity-endpoint-type

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 erweiterten Filtern, die anhand eines Arrays von Werten ausgewertet werden können, anstatt einen singularen Wert zu erwarten.

Zulässige Werte: false, true

--endpoint

--endpoint-type

Der Typ des Zielendpunkts.

Standardwert: webhook

--force-string

Wenn Sie "set" oder "add" verwenden, behalten Sie Zeichenfolgen literale beibehalten, anstatt zu versuchen, in JSON zu konvertieren.

--included-event-types

--labels

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

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

Zeit der Speicherwarteschlange, die in Sekunden zu leben ist.

--remove

Entfernen Sie eine Eigenschaft oder ein Element aus einer Liste. Beispiel: --remove property.list OR --remove propertyToRemove.

--set

Aktualisieren Sie ein Objekt, indem Sie einen Eigenschaftenpfad und einen wert angeben, der festgelegt werden soll. Beispiel: --set-property1.property2=.

--source-resource-id

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

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

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

Befehle

az eventgrid event-subscription create

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid event-subscription delete

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid event-subscription list

Beispiele

Optionale Parameter

az eventgrid event-subscription show

Beispiele

Erforderliche Parameter

Optionale Parameter

az eventgrid event-subscription update

Beispiele

Erforderliche Parameter

Optionale Parameter

Feedback