System Topic Event Subscriptions - Create Or Update

Dienst:

Event Grid

API-Version:

2022-06-15

Erstellen oder Aktualisieren eines Ereignisabonnements für ein Systemthema.
Erstellt oder aktualisiert asynchron ein Ereignisabonnement mit den angegebenen Parametern. Vorhandene Ereignisabonnements werden mit dieser API aktualisiert.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/systemTopics/{systemTopicName}/eventSubscriptions/{eventSubscriptionName}?api-version=2022-06-15

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
eventSubscriptionName	path	True	string	Name des Ereignisabonnements. Ereignisabonnementnamen dürfen zwischen 3 und 100 Zeichen lang sein und nur alphanumerische Buchstaben verwenden.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe im Abonnement des Benutzers.
subscriptionId	path	True	string	Abonnementanmeldeinformationen, die ein Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
systemTopicName	path	True	string	Name des Systemthemas.
api-version	query	True	string	Version der API, die mit der Clientanforderung verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
properties.deadLetterDestination	DeadLetterDestination: StorageBlobDeadLetterDestination	Das Ziel für unzustellbare Nachrichten des Ereignisabonnements. Jedes Ereignis, das nicht an sein Ziel übermittelt werden kann, wird an das Ziel für unzustellbare Nachrichten gesendet. Verwendet die Identität von Azure Event Grid, um die Authentifizierungstoken abzurufen, die während der Übermittlung/Unzustellbarkeit verwendet werden.
properties.deadLetterWithResourceIdentity	DeadLetterWithResourceIdentity	Das Ziel für unzustellbare Nachrichten des Ereignisabonnements. Jedes Ereignis, das nicht an sein Ziel übermittelt werden kann, wird an das Ziel für unzustellbare Nachrichten gesendet. Verwendet das Setup der verwalteten Identität für die übergeordnete Ressource (d. h. das Thema oder die Domäne), um die Authentifizierungstoken abzurufen, die während der Übermittlung/Unzustellbarkeit verwendet werden.
properties.deliveryWithResourceIdentity	DeliveryWithResourceIdentity	Informationen zum Ziel, an dem Ereignisse für das Ereignisabonnement übermittelt werden müssen. Verwendet das Setup der verwalteten Identität für die übergeordnete Ressource (d. h. das Thema oder die Domäne), um die Authentifizierungstoken abzurufen, die während der Übermittlung/Unzustellbarkeit verwendet werden.
properties.destination	EventSubscriptionDestination: WebHookEventSubscriptionDestination EventHubEventSubscriptionDestination StorageQueueEventSubscriptionDestination HybridConnectionEventSubscriptionDestination ServiceBusQueueEventSubscriptionDestination ServiceBusTopicEventSubscriptionDestination AzureFunctionEventSubscriptionDestination	Informationen zum Ziel, an dem Ereignisse für das Ereignisabonnement übermittelt werden müssen. Verwendet die Identität von Azure Event Grid, um die Authentifizierungstoken abzurufen, die während der Übermittlung/Unzustellbarkeit verwendet werden.
properties.eventDeliverySchema	EventDeliverySchema	Das Ereignisübermittlungsschema für das Ereignisabonnement.
properties.expirationTimeUtc	string	Ablaufzeit des Ereignisabonnements.
properties.filter	EventSubscriptionFilter	Informationen zum Filter für das Ereignisabonnement.
properties.labels	string[]	Liste der benutzerdefinierten Bezeichnungen.
properties.retryPolicy	RetryPolicy	Die Wiederholungsrichtlinie für Ereignisse. Dies kann verwendet werden, um die maximale Anzahl von Übermittlungsversuchen und die Dauer für Ereignisse zu konfigurieren.

Antworten

Name	Typ	Beschreibung
201 Created	EventSubscription	Erstellt
Other Status Codes		Fehlerantworten: *** 400 Ungültige Anforderung. 500 Interner Serverfehler.

Beispiele

SystemTopicEventSubscriptions_CreateOrUpdate

Beispielanforderung

HTTP

PUT https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/systemTopics/exampleSystemTopic1/eventSubscriptions/exampleEventSubscriptionName1?api-version=2022-06-15

{
  "properties": {
    "destination": {
      "endpointType": "WebHook",
      "properties": {
        "endpointUrl": "https://requestb.in/15ksip71"
      }
    },
    "filter": {
      "isSubjectCaseSensitive": false,
      "subjectBeginsWith": "ExamplePrefix",
      "subjectEndsWith": "ExampleSuffix"
    }
  }
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.eventgrid.fluent.models.EventSubscriptionInner;
import com.azure.resourcemanager.eventgrid.models.EventSubscriptionFilter;
import com.azure.resourcemanager.eventgrid.models.WebhookEventSubscriptionDestination;

/** Samples for SystemTopicEventSubscriptions CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file: specification/eventgrid/resource-manager/Microsoft.EventGrid/stable/2022-06-15/examples/SystemTopicEventSubscriptions_CreateOrUpdate.json
     */
    /**
     * Sample code: SystemTopicEventSubscriptions_CreateOrUpdate.
     *
     * @param manager Entry point to EventGridManager.
     */
    public static void systemTopicEventSubscriptionsCreateOrUpdate(
        com.azure.resourcemanager.eventgrid.EventGridManager manager) {
        manager
            .systemTopicEventSubscriptions()
            .createOrUpdate(
                "examplerg",
                "exampleSystemTopic1",
                "exampleEventSubscriptionName1",
                new EventSubscriptionInner()
                    .withDestination(
                        new WebhookEventSubscriptionDestination().withEndpointUrl("https://requestb.in/15ksip71"))
                    .withFilter(
                        new EventSubscriptionFilter()
                            .withSubjectBeginsWith("ExamplePrefix")
                            .withSubjectEndsWith("ExampleSuffix")
                            .withIsSubjectCaseSensitive(false)),
                Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential
from azure.mgmt.eventgrid import EventGridManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-eventgrid
# USAGE
    python system_topic_event_subscriptions_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = EventGridManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="5b4b650e-28b9-4790-b3ab-ddbd88d727c4",
    )

    response = client.system_topic_event_subscriptions.begin_create_or_update(
        resource_group_name="examplerg",
        system_topic_name="exampleSystemTopic1",
        event_subscription_name="exampleEventSubscriptionName1",
        event_subscription_info={
            "properties": {
                "destination": {
                    "endpointType": "WebHook",
                    "properties": {"endpointUrl": "https://requestb.in/15ksip71"},
                },
                "filter": {
                    "isSubjectCaseSensitive": False,
                    "subjectBeginsWith": "ExamplePrefix",
                    "subjectEndsWith": "ExampleSuffix",
                },
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/eventgrid/resource-manager/Microsoft.EventGrid/stable/2022-06-15/examples/SystemTopicEventSubscriptions_CreateOrUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armeventgrid_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/eventgrid/armeventgrid/v2"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/f88928d723133dc392e3297e6d61b7f6d10501fd/specification/eventgrid/resource-manager/Microsoft.EventGrid/stable/2022-06-15/examples/SystemTopicEventSubscriptions_CreateOrUpdate.json
func ExampleSystemTopicEventSubscriptionsClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armeventgrid.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewSystemTopicEventSubscriptionsClient().BeginCreateOrUpdate(ctx, "examplerg", "exampleSystemTopic1", "exampleEventSubscriptionName1", armeventgrid.EventSubscription{
		Properties: &armeventgrid.EventSubscriptionProperties{
			Destination: &armeventgrid.WebHookEventSubscriptionDestination{
				EndpointType: to.Ptr(armeventgrid.EndpointTypeWebHook),
				Properties: &armeventgrid.WebHookEventSubscriptionDestinationProperties{
					EndpointURL: to.Ptr("https://requestb.in/15ksip71"),
				},
			},
			Filter: &armeventgrid.EventSubscriptionFilter{
				IsSubjectCaseSensitive: to.Ptr(false),
				SubjectBeginsWith:      to.Ptr("ExamplePrefix"),
				SubjectEndsWith:        to.Ptr("ExampleSuffix"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	_, err = poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { EventGridManagementClient } = require("@azure/arm-eventgrid");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Asynchronously creates or updates an event subscription with the specified parameters. Existing event subscriptions will be updated with this API.
 *
 * @summary Asynchronously creates or updates an event subscription with the specified parameters. Existing event subscriptions will be updated with this API.
 * x-ms-original-file: specification/eventgrid/resource-manager/Microsoft.EventGrid/stable/2022-06-15/examples/SystemTopicEventSubscriptions_CreateOrUpdate.json
 */
async function systemTopicEventSubscriptionsCreateOrUpdate() {
  const subscriptionId =
    process.env["EVENTGRID_SUBSCRIPTION_ID"] || "5b4b650e-28b9-4790-b3ab-ddbd88d727c4";
  const resourceGroupName = process.env["EVENTGRID_RESOURCE_GROUP"] || "examplerg";
  const systemTopicName = "exampleSystemTopic1";
  const eventSubscriptionName = "exampleEventSubscriptionName1";
  const eventSubscriptionInfo = {
    destination: {
      endpointType: "WebHook",
      endpointUrl: "https://requestb.in/15ksip71",
    },
    filter: {
      isSubjectCaseSensitive: false,
      subjectBeginsWith: "ExamplePrefix",
      subjectEndsWith: "ExampleSuffix",
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new EventGridManagementClient(credential, subscriptionId);
  const result = await client.systemTopicEventSubscriptions.beginCreateOrUpdateAndWait(
    resourceGroupName,
    systemTopicName,
    eventSubscriptionName,
    eventSubscriptionInfo
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using System;
using System.Threading.Tasks;
using Azure;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.EventGrid;
using Azure.ResourceManager.EventGrid.Models;

// Generated from example definition: specification/eventgrid/resource-manager/Microsoft.EventGrid/stable/2022-06-15/examples/SystemTopicEventSubscriptions_CreateOrUpdate.json
// this example is just showing the usage of "SystemTopicEventSubscriptions_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SystemTopicResource created on azure
// for more information of creating SystemTopicResource, please refer to the document of SystemTopicResource
string subscriptionId = "5b4b650e-28b9-4790-b3ab-ddbd88d727c4";
string resourceGroupName = "examplerg";
string systemTopicName = "exampleSystemTopic1";
ResourceIdentifier systemTopicResourceId = SystemTopicResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, systemTopicName);
SystemTopicResource systemTopic = client.GetSystemTopicResource(systemTopicResourceId);

// get the collection of this SystemTopicEventSubscriptionResource
SystemTopicEventSubscriptionCollection collection = systemTopic.GetSystemTopicEventSubscriptions();

// invoke the operation
string eventSubscriptionName = "exampleEventSubscriptionName1";
EventGridSubscriptionData data = new EventGridSubscriptionData()
{
    Destination = new WebHookEventSubscriptionDestination()
    {
        Endpoint = new Uri("https://requestb.in/15ksip71"),
    },
    Filter = new EventSubscriptionFilter()
    {
        SubjectBeginsWith = "ExamplePrefix",
        SubjectEndsWith = "ExampleSuffix",
        IsSubjectCaseSensitive = false,
    },
};
ArmOperation<SystemTopicEventSubscriptionResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, eventSubscriptionName, data);
SystemTopicEventSubscriptionResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
EventGridSubscriptionData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:

201

{
  "properties": {
    "destination": {
      "properties": {
        "endpointBaseUrl": "https://requestb.in/15ksip71"
      },
      "endpointType": "WebHook"
    },
    "filter": {
      "isSubjectCaseSensitive": false,
      "subjectBeginsWith": "ExamplePrefix",
      "subjectEndsWith": "ExampleSuffix"
    },
    "labels": null,
    "eventDeliverySchema": "EventGridSchema",
    "retryPolicy": {
      "maxDeliveryAttempts": 30,
      "eventTimeToLiveInMinutes": 1440
    },
    "provisioningState": "Succeeded",
    "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/systemTopics/exampleSystemTopic1"
  },
  "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/systemTopics/exampleSystemTopic1/eventSubscriptions/exampleEventSubscriptionName1",
  "name": "exampleEventSubscriptionName1",
  "type": "Microsoft.EventGrid/systemTopics/eventSubscriptions"
}

Definitionen

Name	Beschreibung
AzureFunctionEventSubscriptionDestination	Informationen zum Azure-Funktionsziel für ein Ereignisabonnement.
BoolEqualsAdvancedFilter	Erweiterter BoolEquals-Filter.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DeadLetterWithResourceIdentity	Informationen zum Deadletterziel mit Ressourcenidentität.
DeliveryWithResourceIdentity	Informationen zur Übermittlung für ein Ereignisabonnement mit Ressourcenidentität.
DynamicDeliveryAttributeMapping	Details zur Zuordnung von dynamischen Übermittlungsattributs.
EventDeliverySchema	Das Ereignisübermittlungsschema für das Ereignisabonnement.
EventHubEventSubscriptionDestination	Informationen zum Event Hub-Ziel für ein Ereignisabonnement.
EventSubscription	Ereignisabonnement
EventSubscriptionFilter	Filtern Sie nach dem Ereignisabonnement.
EventSubscriptionIdentity	Die Identitätsinformationen mit dem Ereignisabonnement.
EventSubscriptionIdentityType	Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe benutzerseitig zugewiesener Identitäten. Der Typ "None" entfernt jede Identität.
EventSubscriptionProvisioningState	Bereitstellungsstatus des Ereignisabonnements.
HybridConnectionEventSubscriptionDestination	Informationen zum HybridConnection-Ziel für ein Ereignisabonnement.
IsNotNullAdvancedFilter	Erweiterter IsNotNull-Filter.
IsNullOrUndefinedAdvancedFilter	Erweiterter IsNullOrUndefined-Filter.
NumberGreaterThanAdvancedFilter	NumberGreaterThan Advanced Filter.
NumberGreaterThanOrEqualsAdvancedFilter	Erweiterter NumberGreaterThanOrEquals-Filter.
NumberInAdvancedFilter	NumberIn Erweiterter Filter.
NumberInRangeAdvancedFilter	Erweiterter NumberInRange-Filter.
NumberLessThanAdvancedFilter	Erweiterter NumberLessThan-Filter.
NumberLessThanOrEqualsAdvancedFilter	Erweiterter NumberLessThanOrEquals-Filter.
NumberNotInAdvancedFilter	Erweiterter NumberNotIn-Filter.
NumberNotInRangeAdvancedFilter	Erweiterter NumberNotInRange-Filter.
RetryPolicy	Informationen zur Wiederholungsrichtlinie für ein Ereignisabonnement.
ServiceBusQueueEventSubscriptionDestination	Informationen zum Service Bus-Ziel für ein Ereignisabonnement.
ServiceBusTopicEventSubscriptionDestination	Informationen zum Service Bus-Themenziel für ein Ereignisabonnement.
StaticDeliveryAttributeMapping	Zuordnungsdetails zu statischen Übermittlungsattributs.
StorageBlobDeadLetterDestination	Informationen zum Speicherblob-basierten Ziel für unzustellbare Buchstaben.
StorageQueueEventSubscriptionDestination	Informationen zum Speicherwarteschlangenziel für ein Ereignisabonnement.
StringBeginsWithAdvancedFilter	StringBeginsWith Advanced Filter.
StringContainsAdvancedFilter	StringContains Advanced Filter.
StringEndsWithAdvancedFilter	StringEndsWith Advanced Filter.
StringInAdvancedFilter	ZeichenfolgeIn erweiterter Filter.
StringNotBeginsWithAdvancedFilter	StringNotBeginsWith Advanced Filter.
StringNotContainsAdvancedFilter	StringNotContains Erweiterter Filter.
StringNotEndsWithAdvancedFilter	StringNotEndsWith Advanced Filter.
StringNotInAdvancedFilter	Erweiterter StringNotIn-Filter.
systemData	Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
WebHookEventSubscriptionDestination	Informationen zum Webhookziel für ein Ereignisabonnement.

AzureFunctionEventSubscriptionDestination

Informationen zum Azure-Funktionsziel für ein Ereignisabonnement.

Name	Typ	Standardwert	Beschreibung
endpointType	string: AzureFunction		Typ des Endpunkts für das Ereignisabonnementziel.
properties.deliveryAttributeMappings	DeliveryAttributeMapping[]: DynamicDeliveryAttributeMapping[] StaticDeliveryAttributeMapping[]		Details zum Übermittlungsattribut.
properties.maxEventsPerBatch	integer	1	Maximale Anzahl von Ereignissen pro Batch.
properties.preferredBatchSizeInKilobytes	integer	64	Bevorzugte Batchgröße in Kb.
properties.resourceId	string		Die Azure-Ressourcen-ID, die den Endpunkt des Azure-Funktionsziels eines Ereignisabonnements darstellt.

BoolEqualsAdvancedFilter

Erweiterter BoolEquals-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: BoolEquals	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
value	boolean	Der boolesche Filterwert.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

DeadLetterWithResourceIdentity

Informationen zum Deadletterziel mit Ressourcenidentität.

Name	Typ	Beschreibung
deadLetterDestination	DeadLetterDestination: StorageBlobDeadLetterDestination	Informationen zum Ziel, an dem Ereignisse für das Ereignisabonnement übermittelt werden müssen. Verwendet das Setup der verwalteten Identität für die übergeordnete Ressource (d. h. das Thema oder die Domäne), um die Authentifizierungstoken abzurufen, die während der Übermittlung/Unzustellbarkeit verwendet werden.
identity	EventSubscriptionIdentity	Die Identität, die bei Ereignissen mit unzustellbaren Buchstaben verwendet werden soll.

DeliveryWithResourceIdentity

Informationen zur Übermittlung für ein Ereignisabonnement mit Ressourcenidentität.

Name	Typ	Beschreibung
destination	EventSubscriptionDestination: AzureFunctionEventSubscriptionDestination EventHubEventSubscriptionDestination HybridConnectionEventSubscriptionDestination ServiceBusQueueEventSubscriptionDestination ServiceBusTopicEventSubscriptionDestination StorageQueueEventSubscriptionDestination WebHookEventSubscriptionDestination	Informationen zum Ziel, an dem Ereignisse für das Ereignisabonnement übermittelt werden müssen. Verwendet die Identität von Azure Event Grid, um die Authentifizierungstoken abzurufen, die während der Übermittlung/Unzustellbarkeit verwendet werden.
identity	EventSubscriptionIdentity	Die Identität, die beim Übermitteln von Ereignissen verwendet werden soll.

DynamicDeliveryAttributeMapping

Details zur Zuordnung von dynamischen Übermittlungsattributs.

Name	Typ	Beschreibung
name	string	Name des Übermittlungsattributs oder -headers.
properties.sourceField	string	JSON-Pfad in dem Ereignis, das den Attributwert enthält.
type	string: Dynamic	Typ des Übermittlungsattributs oder des Headernamens.

EventDeliverySchema

Das Ereignisübermittlungsschema für das Ereignisabonnement.

Name	Typ	Beschreibung
CloudEventSchemaV1_0	string
CustomInputSchema	string
EventGridSchema	string

EventHubEventSubscriptionDestination

Informationen zum Event Hub-Ziel für ein Ereignisabonnement.

Name	Typ	Beschreibung
endpointType	string: EventHub	Typ des Endpunkts für das Ereignisabonnementziel.
properties.deliveryAttributeMappings	DeliveryAttributeMapping[]: DynamicDeliveryAttributeMapping[] StaticDeliveryAttributeMapping[]	Details zum Übermittlungsattribut.
properties.resourceId	string	Die Azure-Ressourcen-ID, die den Endpunkt eines Event Hub-Ziels eines Ereignisabonnements darstellt.

EventSubscription

Ereignisabonnement

Name	Typ	Standardwert	Beschreibung
id	string		Vollqualifizierter Bezeichner der Ressource.
name	string		Der Name der Ressource.
properties.deadLetterDestination	DeadLetterDestination: StorageBlobDeadLetterDestination		Das Ziel für unzustellbare Nachrichten des Ereignisabonnements. Jedes Ereignis, das nicht an sein Ziel übermittelt werden kann, wird an das Ziel für unzustellbare Nachrichten gesendet. Verwendet die Identität von Azure Event Grid, um die Authentifizierungstoken abzurufen, die während der Übermittlung/Unzustellbarkeit verwendet werden.
properties.deadLetterWithResourceIdentity	DeadLetterWithResourceIdentity		Das Ziel für unzustellbare Nachrichten des Ereignisabonnements. Jedes Ereignis, das nicht an sein Ziel übermittelt werden kann, wird an das Ziel für unzustellbare Nachrichten gesendet. Verwendet das Setup der verwalteten Identität für die übergeordnete Ressource (d. h. das Thema oder die Domäne), um die Authentifizierungstoken abzurufen, die während der Übermittlung/Unzustellbarkeit verwendet werden.
properties.deliveryWithResourceIdentity	DeliveryWithResourceIdentity		Informationen zum Ziel, an dem Ereignisse für das Ereignisabonnement übermittelt werden müssen. Verwendet das Setup der verwalteten Identität für die übergeordnete Ressource (d. h. das Thema oder die Domäne), um die Authentifizierungstoken abzurufen, die während der Übermittlung/Unzustellbarkeit verwendet werden.
properties.destination	EventSubscriptionDestination: AzureFunctionEventSubscriptionDestination EventHubEventSubscriptionDestination HybridConnectionEventSubscriptionDestination ServiceBusQueueEventSubscriptionDestination ServiceBusTopicEventSubscriptionDestination StorageQueueEventSubscriptionDestination WebHookEventSubscriptionDestination		Informationen zum Ziel, an dem Ereignisse für das Ereignisabonnement übermittelt werden müssen. Verwendet die Identität von Azure Event Grid, um die Authentifizierungstoken abzurufen, die während der Übermittlung/Unzustellbarkeit verwendet werden.
properties.eventDeliverySchema	EventDeliverySchema	EventGridSchema	Das Ereignisübermittlungsschema für das Ereignisabonnement.
properties.expirationTimeUtc	string		Ablaufzeit des Ereignisabonnements.
properties.filter	EventSubscriptionFilter		Informationen zum Filter für das Ereignisabonnement.
properties.labels	string[]		Liste der benutzerdefinierten Bezeichnungen.
properties.provisioningState	EventSubscriptionProvisioningState		Bereitstellungsstatus des Ereignisabonnements.
properties.retryPolicy	RetryPolicy		Die Wiederholungsrichtlinie für Ereignisse. Dies kann verwendet werden, um die maximale Anzahl von Übermittlungsversuchen und die Dauer für Ereignisse zu konfigurieren.
properties.topic	string		Name des Themas des Ereignisabonnements.
systemData	systemData		Die Systemmetadaten im Zusammenhang mit der Ereignisabonnementressource.
type	string		Der Typ der Ressource.

EventSubscriptionFilter

Filtern Sie nach dem Ereignisabonnement.

Name	Typ	Standardwert	Beschreibung
advancedFilters	AdvancedFilter[]: BoolEqualsAdvancedFilter[] IsNotNullAdvancedFilter[] IsNullOrUndefinedAdvancedFilter[] NumberGreaterThanAdvancedFilter[] NumberGreaterThanOrEqualsAdvancedFilter[] NumberInAdvancedFilter[] NumberInRangeAdvancedFilter[] NumberLessThanAdvancedFilter[] NumberLessThanOrEqualsAdvancedFilter[] NumberNotInAdvancedFilter[] NumberNotInRangeAdvancedFilter[] StringBeginsWithAdvancedFilter[] StringContainsAdvancedFilter[] StringEndsWithAdvancedFilter[] StringInAdvancedFilter[] StringNotBeginsWithAdvancedFilter[] StringNotContainsAdvancedFilter[] StringNotEndsWithAdvancedFilter[] StringNotInAdvancedFilter[]		Ein Array erweiterter Filter, die zum Filtern von Ereignisabonnements verwendet werden.
enableAdvancedFilteringOnArrays	boolean		Ermöglicht es, dass erweiterte Filter mit einem Array von Werten ausgewertet werden, anstatt einen singularen Wert zu erwarten.
includedEventTypes	string[]		Eine Liste der anwendbaren Ereignistypen, die Teil des Ereignisabonnements sein müssen. Wenn sie alle Standardereignistypen abonnieren möchten, legen Sie die IncludedEventTypes auf NULL fest.
isSubjectCaseSensitive	boolean	False	Gibt an, ob die Eigenschaften SubjectBeginsWith und SubjectEndsWith des Filters in einer Weise verglichen werden sollen, bei der die Groß-/Kleinschreibung beachtet wird.
subjectBeginsWith	string		Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Ressourcenpfadpräfix. Das Format hängt vom Herausgeber der Ereignisse ab. Wildcardzeichen werden in diesem Pfad nicht unterstützt.
subjectEndsWith	string		Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Ressourcenpfadsuffix. Wildcardzeichen werden in diesem Pfad nicht unterstützt.

EventSubscriptionIdentity

Die Identitätsinformationen mit dem Ereignisabonnement.

Name	Typ	Beschreibung
type	EventSubscriptionIdentityType	Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe benutzerseitig zugewiesener Identitäten. Der Typ "None" entfernt jede Identität.
userAssignedIdentity	string	Die der Ressource zugeordnete Benutzeridentität.

EventSubscriptionIdentityType

Der Typ der verwendeten verwalteten Identität. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Reihe benutzerseitig zugewiesener Identitäten. Der Typ "None" entfernt jede Identität.

Name	Typ	Beschreibung
SystemAssigned	string
UserAssigned	string

EventSubscriptionProvisioningState

Bereitstellungsstatus des Ereignisabonnements.

Name	Typ	Beschreibung
AwaitingManualAction	string
Canceled	string
Creating	string
Deleting	string
Failed	string
Succeeded	string
Updating	string

HybridConnectionEventSubscriptionDestination

Informationen zum HybridConnection-Ziel für ein Ereignisabonnement.

Name	Typ	Beschreibung
endpointType	string: HybridConnection	Typ des Endpunkts für das Ereignisabonnementziel.
properties.deliveryAttributeMappings	DeliveryAttributeMapping[]: DynamicDeliveryAttributeMapping[] StaticDeliveryAttributeMapping[]	Details zum Übermittlungsattribut.
properties.resourceId	string	Die Azure-Ressourcen-ID einer Hybridverbindung, die das Ziel eines Ereignisabonnements ist.

IsNotNullAdvancedFilter

Erweiterter IsNotNull-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: IsNotNull	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.

IsNullOrUndefinedAdvancedFilter

Erweiterter IsNullOrUndefined-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: IsNullOrUndefined	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.

NumberGreaterThanAdvancedFilter

NumberGreaterThan Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: NumberGreaterThan	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
value	number	Der Filterwert.

NumberGreaterThanOrEqualsAdvancedFilter

Erweiterter NumberGreaterThanOrEquals-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: NumberGreaterThanOrEquals	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
value	number	Der Filterwert.

NumberInAdvancedFilter

NumberIn Erweiterter Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: NumberIn	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	number[]	Der Satz von Filterwerten.

NumberInRangeAdvancedFilter

Erweiterter NumberInRange-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: NumberInRange	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	number[]	Der Satz von Filterwerten.

NumberLessThanAdvancedFilter

Erweiterter NumberLessThan-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: NumberLessThan	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
value	number	Der Filterwert.

NumberLessThanOrEqualsAdvancedFilter

Erweiterter NumberLessThanOrEquals-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: NumberLessThanOrEquals	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
value	number	Der Filterwert.

NumberNotInAdvancedFilter

Erweiterter NumberNotIn-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: NumberNotIn	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	number[]	Der Satz von Filterwerten.

NumberNotInRangeAdvancedFilter

Erweiterter NumberNotInRange-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: NumberNotInRange	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	number[]	Der Satz von Filterwerten.

RetryPolicy

Informationen zur Wiederholungsrichtlinie für ein Ereignisabonnement.

Name	Typ	Standardwert	Beschreibung
eventTimeToLiveInMinutes	integer	1440	Gültigkeitsdauer (in Minuten) für Ereignisse.
maxDeliveryAttempts	integer	30	Maximale Anzahl von Übermittlungsversuchen für Ereignisse.

ServiceBusQueueEventSubscriptionDestination

Informationen zum Service Bus-Ziel für ein Ereignisabonnement.

Name	Typ	Beschreibung
endpointType	string: ServiceBusQueue	Typ des Endpunkts für das Ereignisabonnementziel.
properties.deliveryAttributeMappings	DeliveryAttributeMapping[]: DynamicDeliveryAttributeMapping[] StaticDeliveryAttributeMapping[]	Details zum Übermittlungsattribut.
properties.resourceId	string	Die Azure-Ressourcen-ID, die den Endpunkt des Service Bus-Ziels eines Ereignisabonnements darstellt.

ServiceBusTopicEventSubscriptionDestination

Informationen zum Service Bus-Themenziel für ein Ereignisabonnement.

Name	Typ	Beschreibung
endpointType	string: ServiceBusTopic	Typ des Endpunkts für das Ereignisabonnementziel.
properties.deliveryAttributeMappings	DeliveryAttributeMapping[]: DynamicDeliveryAttributeMapping[] StaticDeliveryAttributeMapping[]	Details zum Übermittlungsattribut.
properties.resourceId	string	Die Azure-Ressourcen-ID, die den Endpunkt des Service Bus-Themaziels eines Ereignisabonnements darstellt.

StaticDeliveryAttributeMapping

Zuordnungsdetails zu statischen Übermittlungsattributs.

Name	Typ	Standardwert	Beschreibung
name	string		Name des Übermittlungsattributs oder -headers.
properties.isSecret	boolean	False	Boolesches Flag, um anzugeben, ob das Attribut vertrauliche Informationen enthält.
properties.value	string		Wert des Delivery-Attributs.
type	string: Static		Typ des Übermittlungsattributs oder des Headernamens.

StorageBlobDeadLetterDestination

Informationen zum Speicherblob-basierten Ziel für unzustellbare Buchstaben.

Name	Typ	Beschreibung
endpointType	string: StorageBlob	Typ des Endpunkts für das Ziel des unzustellbaren Buchstabens
properties.blobContainerName	string	Der Name des Speicherblobcontainers, der das Ziel der Deadletterereignisse darstellt
properties.resourceId	string	Die Azure-Ressourcen-ID des Speicherkontos, das das Ziel der Deadletterereignisse ist

StorageQueueEventSubscriptionDestination

Informationen zum Speicherwarteschlangenziel für ein Ereignisabonnement.

Name	Typ	Beschreibung
endpointType	string: StorageQueue	Typ des Endpunkts für das Ereignisabonnementziel.
properties.queueMessageTimeToLiveInSeconds	integer	Die Zeit der Speicherwarteschlangennachricht wird in Sekunden angegeben.
properties.queueName	string	Der Name der Speicherwarteschlange unter einem Speicherkonto, das das Ziel eines Ereignisabonnements ist.
properties.resourceId	string	Die Azure-Ressourcen-ID des Speicherkontos, das die Warteschlange enthält, die das Ziel eines Ereignisabonnements ist.

StringBeginsWithAdvancedFilter

StringBeginsWith Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: StringBeginsWith	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	string[]	Der Satz von Filterwerten.

StringContainsAdvancedFilter

StringContains Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: StringContains	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	string[]	Der Satz von Filterwerten.

StringEndsWithAdvancedFilter

StringEndsWith Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: StringEndsWith	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	string[]	Der Satz von Filterwerten.

StringInAdvancedFilter

ZeichenfolgeIn erweiterter Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: StringIn	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	string[]	Der Satz von Filterwerten.

StringNotBeginsWithAdvancedFilter

StringNotBeginsWith Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: StringNotBeginsWith	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	string[]	Der Satz von Filterwerten.

StringNotContainsAdvancedFilter

StringNotContains Erweiterter Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: StringNotContains	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	string[]	Der Satz von Filterwerten.

StringNotEndsWithAdvancedFilter

StringNotEndsWith Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: StringNotEndsWith	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	string[]	Der Satz von Filterwerten.

StringNotInAdvancedFilter

Erweiterter StringNotIn-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, basierend auf dem Sie filtern möchten.
operatorType	string: StringNotIn	Der zum Filtern verwendete Operatortyp, z. B. NumberIn, StringContains, BoolEquals und andere.
values	string[]	Der Satz von Filterwerten.

systemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

WebHookEventSubscriptionDestination

Informationen zum Webhookziel für ein Ereignisabonnement.

Name	Typ	Standardwert	Beschreibung
endpointType	string: WebHook		Typ des Endpunkts für das Ereignisabonnementziel.
properties.azureActiveDirectoryApplicationIdOrUri	string		Die Azure Active Directory-Anwendungs-ID oder der URI zum Abrufen des Zugriffstokens, das als Bearertoken in Übermittlungsanforderungen enthalten wird.
properties.azureActiveDirectoryTenantId	string		Die Azure Active Directory-Mandanten-ID zum Abrufen des Zugriffstokens, das als Bearertoken in Übermittlungsanforderungen enthalten wird.
properties.deliveryAttributeMappings	DeliveryAttributeMapping[]: DynamicDeliveryAttributeMapping[] StaticDeliveryAttributeMapping[]		Details zum Übermittlungsattribut.
properties.endpointBaseUrl	string		Die Basis-URL, die den Endpunkt des Ziels eines Ereignisabonnements darstellt.
properties.endpointUrl	string		Die URL, die den Endpunkt des Ziels eines Ereignisabonnements darstellt.
properties.maxEventsPerBatch	integer	1	Maximale Anzahl von Ereignissen pro Batch.
properties.preferredBatchSizeInKilobytes	integer	64	Bevorzugte Batchgröße in Kb.