Event Subscriptions - List Regional By Resource Group For Topic Type

Referenz

Dienst:: Event Grid

API-Version:: 2025-02-15

Auflisten aller regionalen Ereignisabonnements unter einem Azure-Abonnement und einer Ressourcengruppe für einen Thementyp.
Auflisten aller Ereignisabonnements vom angegebenen Speicherort unter einem bestimmten Azure-Abonnement- und Ressourcengruppen- und Thementyp.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/locations/{location}/topicTypes/{topicTypeName}/eventSubscriptions?api-version=2025-02-15

Mit optionalen Parametern:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.EventGrid/locations/{location}/topicTypes/{topicTypeName}/eventSubscriptions?api-version=2025-02-15&$filter={$filter}&$top={$top}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
location	path	True	string	Name des Speicherorts.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe innerhalb des Abonnements 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.
topicTypeName	path	True	string	Name des Thementyps.
api-version	query	True	string	Version der API, die mit der Clientanforderung verwendet werden soll.
$filter	query		string	Die Abfrage zum Filtern der Suchergebnisse mithilfe der OData-Syntax. Filterung ist nur für die Eigenschaft "name" und mit begrenzter Anzahl von OData-Vorgängen zulässig. Diese Vorgänge sind: die Funktion "contains" sowie die folgenden logischen Vorgänge: not, and, and, or, eq (for equal) and ne (for not equal). Es werden keine arithmetischen Vorgänge unterstützt. Es folgt ein gültiges Filterbeispiel: $filter=contains(namE, 'PATTERN') und name ne 'PATTERN-1'. Es folgt kein gültiges Filterbeispiel: $filter=location eq 'westus'.
$top	query		integer (int32)	Die Anzahl der Ergebnisse, die pro Seite für den Listenvorgang zurückgegeben werden sollen. Der gültige Bereich für den oberen Parameter beträgt 1 bis 100. Wenn nicht angegeben, beträgt die Standardanzahl der zurückgegebenen Ergebnisse 20 Elemente pro Seite.

Antworten

Name	Typ	Beschreibung
200 OK	EventSubscriptionsListResult	OKAY
Other Status Codes		Fehlerantworten: *** 400 Ungültige Anfrage. 500 Interner Serverfehler.

Name

Typ

Beschreibung

200 OK

EventSubscriptionsListResult

OKAY

Other Status Codes

Fehlerantworten: ***

400 Ungültige Anfrage.
500 Interner Serverfehler.

Beispiele

EventSubscriptions_ListRegionalByResourceGroupForTopicType

Beispielanforderung

GET https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventGrid/locations/westus2/topicTypes/Microsoft.EventHub.namespaces/eventSubscriptions?api-version=2025-02-15


/**
 * Samples for EventSubscriptions ListRegionalByResourceGroupForTopicType.
 */
public final class Main {
    /*
     * x-ms-original-file: specification/eventgrid/resource-manager/Microsoft.EventGrid/stable/2025-02-15/examples/
     * EventSubscriptions_ListRegionalByResourceGroupForTopicType.json
     */
    /**
     * Sample code: EventSubscriptions_ListRegionalByResourceGroupForTopicType.
     * 
     * @param manager Entry point to EventGridManager.
     */
    public static void eventSubscriptionsListRegionalByResourceGroupForTopicType(
        com.azure.resourcemanager.eventgrid.EventGridManager manager) {
        manager.eventSubscriptions().listRegionalByResourceGroupForTopicType("examplerg", "westus2",
            "Microsoft.EventHub.namespaces", null, null, com.azure.core.util.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

from azure.identity import DefaultAzureCredential

from azure.mgmt.eventgrid import EventGridManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-eventgrid
# USAGE
    python event_subscriptions_list_regional_by_resource_group_for_topic_type.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.event_subscriptions.list_regional_by_resource_group_for_topic_type(
        resource_group_name="examplerg",
        location="westus2",
        topic_type_name="Microsoft.EventHub.namespaces",
    )
    for item in response:
        print(item)


# x-ms-original-file: specification/eventgrid/resource-manager/Microsoft.EventGrid/stable/2025-02-15/examples/EventSubscriptions_ListRegionalByResourceGroupForTopicType.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

package armeventgrid_test

import (
	"context"
	"log"

	"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/ee1eec42dcc710ff88db2d1bf574b2f9afe3d654/specification/eventgrid/resource-manager/Microsoft.EventGrid/stable/2025-02-15/examples/EventSubscriptions_ListRegionalByResourceGroupForTopicType.json
func ExampleEventSubscriptionsClient_NewListRegionalByResourceGroupForTopicTypePager() {
	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)
	}
	pager := clientFactory.NewEventSubscriptionsClient().NewListRegionalByResourceGroupForTopicTypePager("examplerg", "westus2", "Microsoft.EventHub.namespaces", &armeventgrid.EventSubscriptionsClientListRegionalByResourceGroupForTopicTypeOptions{Filter: nil,
		Top: nil,
	})
	for pager.More() {
		page, err := pager.NextPage(ctx)
		if err != nil {
			log.Fatalf("failed to advance page: %v", err)
		}
		for _, v := range page.Value {
			// You could use page here. We use blank identifier for just demo purposes.
			_ = v
		}
		// If the HTTP response code is 200 as defined in example definition, your page structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
		// page.EventSubscriptionsListResult = armeventgrid.EventSubscriptionsListResult{
		// 	Value: []*armeventgrid.EventSubscription{
		// 		{
		// 			Name: to.Ptr("examplesubscription10"),
		// 			Type: to.Ptr("Microsoft.EventGrid/eventSubscriptions"),
		// 			ID: to.Ptr("/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventHub/namespaces/examplenamespace1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription10"),
		// 			Properties: &armeventgrid.EventSubscriptionProperties{
		// 				Destination: &armeventgrid.WebHookEventSubscriptionDestination{
		// 					EndpointType: to.Ptr(armeventgrid.EndpointTypeWebHook),
		// 					Properties: &armeventgrid.WebHookEventSubscriptionDestinationProperties{
		// 						EndpointBaseURL: to.Ptr("https://requestb.in/15ksip71"),
		// 					},
		// 				},
		// 				Filter: &armeventgrid.EventSubscriptionFilter{
		// 					IsSubjectCaseSensitive: to.Ptr(false),
		// 					SubjectBeginsWith: to.Ptr("ExamplePrefix"),
		// 					SubjectEndsWith: to.Ptr("ExampleSuffix"),
		// 				},
		// 				Labels: []*string{
		// 					to.Ptr("Finance"),
		// 					to.Ptr("HR")},
		// 					ProvisioningState: to.Ptr(armeventgrid.EventSubscriptionProvisioningStateSucceeded),
		// 					Topic: to.Ptr("/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/microsoft.eventhub/namespaces/examplenamespace1"),
		// 				},
		// 			},
		// 			{
		// 				Name: to.Ptr("examplesubscription11"),
		// 				Type: to.Ptr("Microsoft.EventGrid/eventSubscriptions"),
		// 				ID: to.Ptr("/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventHub/namespaces/examplenamespace1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription11"),
		// 				Properties: &armeventgrid.EventSubscriptionProperties{
		// 					Destination: &armeventgrid.WebHookEventSubscriptionDestination{
		// 						EndpointType: to.Ptr(armeventgrid.EndpointTypeWebHook),
		// 						Properties: &armeventgrid.WebHookEventSubscriptionDestinationProperties{
		// 							EndpointBaseURL: to.Ptr("https://requestb.in/15ksip71"),
		// 						},
		// 					},
		// 					Filter: &armeventgrid.EventSubscriptionFilter{
		// 						IsSubjectCaseSensitive: to.Ptr(false),
		// 						SubjectBeginsWith: to.Ptr("ExamplePrefix"),
		// 						SubjectEndsWith: to.Ptr("ExampleSuffix"),
		// 					},
		// 					Labels: []*string{
		// 						to.Ptr("Finance"),
		// 						to.Ptr("HR")},
		// 						ProvisioningState: to.Ptr(armeventgrid.EventSubscriptionProvisioningStateSucceeded),
		// 						Topic: to.Ptr("/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/microsoft.eventhub/namespaces/examplenamespace1"),
		// 					},
		// 			}},
		// 		}
	}
}

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

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

/**
 * This sample demonstrates how to List all event subscriptions from the given location under a specific Azure subscription and resource group and topic type.
 *
 * @summary List all event subscriptions from the given location under a specific Azure subscription and resource group and topic type.
 * x-ms-original-file: specification/eventgrid/resource-manager/Microsoft.EventGrid/stable/2025-02-15/examples/EventSubscriptions_ListRegionalByResourceGroupForTopicType.json
 */
async function eventSubscriptionsListRegionalByResourceGroupForTopicType() {
  const subscriptionId =
    process.env["EVENTGRID_SUBSCRIPTION_ID"] || "5b4b650e-28b9-4790-b3ab-ddbd88d727c4";
  const resourceGroupName = process.env["EVENTGRID_RESOURCE_GROUP"] || "examplerg";
  const location = "westus2";
  const topicTypeName = "Microsoft.EventHub.namespaces";
  const credential = new DefaultAzureCredential();
  const client = new EventGridManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.eventSubscriptions.listRegionalByResourceGroupForTopicType(
    resourceGroupName,
    location,
    topicTypeName,
  )) {
    resArray.push(item);
  }
  console.log(resArray);
}

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

{
  "value": [
    {
      "properties": {
        "destination": {
          "properties": {
            "endpointBaseUrl": "https://requestb.in/15ksip71"
          },
          "endpointType": "WebHook"
        },
        "filter": {
          "isSubjectCaseSensitive": false,
          "subjectBeginsWith": "ExamplePrefix",
          "subjectEndsWith": "ExampleSuffix"
        },
        "labels": [
          "Finance",
          "HR"
        ],
        "provisioningState": "Succeeded",
        "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/microsoft.eventhub/namespaces/examplenamespace1"
      },
      "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventHub/namespaces/examplenamespace1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription10",
      "name": "examplesubscription10",
      "type": "Microsoft.EventGrid/eventSubscriptions"
    },
    {
      "properties": {
        "destination": {
          "properties": {
            "endpointBaseUrl": "https://requestb.in/15ksip71"
          },
          "endpointType": "WebHook"
        },
        "filter": {
          "isSubjectCaseSensitive": false,
          "subjectBeginsWith": "ExamplePrefix",
          "subjectEndsWith": "ExampleSuffix"
        },
        "labels": [
          "Finance",
          "HR"
        ],
        "provisioningState": "Succeeded",
        "topic": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/microsoft.eventhub/namespaces/examplenamespace1"
      },
      "id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourceGroups/examplerg/providers/Microsoft.EventHub/namespaces/examplenamespace1/providers/Microsoft.EventGrid/eventSubscriptions/examplesubscription11",
      "name": "examplesubscription11",
      "type": "Microsoft.EventGrid/eventSubscriptions"
    }
  ]
}

Definitionen

Name	Beschreibung
AzureFunctionEventSubscriptionDestination	Informationen zum Ziel der Azure-Funktion für ein Ereignisabonnement.
BoolEqualsAdvancedFilter	BoolEquals Advanced Filter.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DeadLetterWithResourceIdentity	Informationen zum Deadletter-Ziel mit Ressourcenidentität.
DeliveryWithResourceIdentity	Informationen zur Übermittlung für ein Ereignisabonnement mit Ressourcenidentität.
DynamicDeliveryAttributeMapping	Details zur Zuordnung dynamischer Übermittlungsattribute.
EventDeliverySchema	Das Ereignisübermittlungsschema für das Ereignisabonnement.
EventHubEventSubscriptionDestination	Informationen zum Event Hub-Ziel für ein Ereignisabonnement.
EventSubscription	Ereignisabonnement.
EventSubscriptionFilter	Filter für das Ereignisabonnement.
EventSubscriptionIdentity	Die Identitätsinformationen mit dem Ereignisabonnement.
EventSubscriptionIdentityType	Der Typ der verwendeten verwalteten Identität. Kann entweder "SystemAssigned" oder "UserAssigned" sein.
EventSubscriptionProvisioningState	Bereitstellungsstatus des Ereignisabonnements.
EventSubscriptionsListResult	Ergebnis des List EventSubscriptions-Vorgangs
HybridConnectionEventSubscriptionDestination	Informationen zum HybridConnection-Ziel für ein Ereignisabonnement.
IsNotNullAdvancedFilter	IsNotNull Advanced Filter.
IsNullOrUndefinedAdvancedFilter	IsNullOrUndefined Advanced Filter.
MonitorAlertEventSubscriptionDestination	Informationen zum Monitorbenachrichtigungsziel für ein Ereignisabonnement.
MonitorAlertSeverity	Der Schweregrad, der an jede Warnung angefügt wird, die über dieses Ereignisabonnement ausgelöst wird. Dieses Feld muss angegeben werden.
NamespaceTopicEventSubscriptionDestination	Informationen zum Namespacethemaziel für ein Ereignisabonnement.
NumberGreaterThanAdvancedFilter	NumberGreaterThan Advanced Filter.
NumberGreaterThanOrEqualsAdvancedFilter	NumberGreaterThanOrEquals Advanced Filter.
NumberInAdvancedFilter	Erweiterter NumberIn-Filter.
NumberInRangeAdvancedFilter	NumberInRange Advanced Filter.
NumberLessThanAdvancedFilter	NumberLessThan Advanced Filter.
NumberLessThanOrEqualsAdvancedFilter	NumberLessThanOrEquals Advanced Filter.
NumberNotInAdvancedFilter	Erweiterter NumberNotIn-Filter.
NumberNotInRangeAdvancedFilter	Erweiterter NumberNotInRange-Filter.
RetryPolicy	Informationen zur Wiederholungsrichtlinie für ein Ereignisabonnement.
ServiceBusQueueEventSubscriptionDestination	Informationen zum Servicebusziel für ein Ereignisabonnement.
ServiceBusTopicEventSubscriptionDestination	Informationen zum Ziel des Servicebusthemas für ein Ereignisabonnement.
StaticDeliveryAttributeMapping	Details zur Zuordnung statischer Übermittlungsattribute.
StorageBlobDeadLetterDestination	Informationen zum Speicher-BLOB-basierten Ziel für inaktive Buchstaben.
StorageQueueEventSubscriptionDestination	Informationen zum Ziel der Speicherwarteschlange für ein Ereignisabonnement.
StringBeginsWithAdvancedFilter	StringBeginsWith Advanced Filter.
StringContainsAdvancedFilter	StringContains Advanced Filter.
StringEndsWithAdvancedFilter	StringEndsWith Advanced Filter.
StringInAdvancedFilter	StringIn Advanced Filter.
StringNotBeginsWithAdvancedFilter	StringNotBeginsWith Advanced Filter.
StringNotContainsAdvancedFilter	Erweiterter StringNotContains-Filter.
StringNotEndsWithAdvancedFilter	StringNotEndsWith Advanced Filter.
StringNotInAdvancedFilter	Erweiterter StringNotIn-Filter.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
TlsVersion	Minimale TLS-Version des Herausgebers, die in dieser Domäne veröffentlicht werden darf
WebHookEventSubscriptionDestination	Informationen zum Webhook-Ziel für ein Ereignisabonnement.

AzureFunctionEventSubscriptionDestination

Objekt

Informationen zum Ziel der Azure-Funktion für ein Ereignisabonnement.

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

BoolEqualsAdvancedFilter

Objekt

BoolEquals Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, 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

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

DeadLetterWithResourceIdentity

Objekt

Informationen zum Deadletter-Ziel 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 in der übergeordneten Ressource (nämlich Thema oder Domäne), um die Authentifizierungstoken abzurufen, die während der Inschrift verwendet werden.
identity	EventSubscriptionIdentity	Die Identität, die beim Dead Lettering-Ereignis verwendet werden soll.

DeliveryWithResourceIdentity

Objekt

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

Name	Typ	Beschreibung
destination	EventSubscriptionDestination: AzureFunctionEventSubscriptionDestination EventHubEventSubscriptionDestination HybridConnectionEventSubscriptionDestination MonitorAlertEventSubscriptionDestination NamespaceTopicEventSubscriptionDestination ServiceBusQueueEventSubscriptionDestination ServiceBusTopicEventSubscriptionDestination StorageQueueEventSubscriptionDestination WebHookEventSubscriptionDestination	Informationen zum Ziel, an dem Ereignisse für das Ereignisabonnement übermittelt werden müssen. Verwendet das Setup der verwalteten Identität in der übergeordneten Ressource (nämlich Thema oder Domäne), um die Authentifizierungstoken abzurufen, die während der Übermittlung verwendet werden.
identity	EventSubscriptionIdentity	Die Identität, die beim Bereitstellen von Ereignissen verwendet werden soll.

DynamicDeliveryAttributeMapping

Objekt

Details zur Zuordnung dynamischer Übermittlungsattribute.

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

EventDeliverySchema

Enumeration

Das Ereignisübermittlungsschema für das Ereignisabonnement.

Wert	Beschreibung
CloudEventSchemaV1_0
CustomInputSchema
EventGridSchema

EventHubEventSubscriptionDestination

Objekt

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 des Übermittlungsattributs.
properties.resourceId	string (arm-id)	Die Azure-Ressourcen-ID, die den Endpunkt eines Event Hub-Ziels eines Ereignisabonnements darstellt.

EventSubscription

Objekt

Ereignisabonnement.

Name	Typ	Standardwert	Beschreibung
id	string		Vollqualifizierter Bezeichner der Ressource.
name	string		Name der Ressource.
properties.deadLetterDestination	DeadLetterDestination: StorageBlobDeadLetterDestination		Das Ziel des Ziels für einen inaktiven Buchstaben des Ereignisabonnements. Jedes Ereignis, das nicht an das Ziel des Absenders übermittelt werden kann, wird an das Ziel des Inschriftschreibens gesendet. Verwendet die Identität von Azure Event Grid, um die Authentifizierungstoken abzurufen, die während der Übermittlung/Inschrift verwendet werden.
properties.deadLetterWithResourceIdentity	DeadLetterWithResourceIdentity		Das Ziel des Ziels für einen inaktiven Buchstaben des Ereignisabonnements. Jedes Ereignis, das nicht an das Ziel des Absenders übermittelt werden kann, wird an das Ziel des Inschriftschreibens gesendet. Verwendet das Setup der verwalteten Identität in der übergeordneten Ressource (nämlich Thema oder Domäne), um die Authentifizierungstoken zu erhalten, die während der Übermittlung/Inschrift 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 in der übergeordneten Ressource (nämlich Thema oder Domäne), um die Authentifizierungstoken zu erhalten, die während der Übermittlung/Inschrift verwendet werden.
properties.destination	EventSubscriptionDestination: AzureFunctionEventSubscriptionDestination EventHubEventSubscriptionDestination HybridConnectionEventSubscriptionDestination MonitorAlertEventSubscriptionDestination NamespaceTopicEventSubscriptionDestination 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/Inschrift verwendet werden.
properties.eventDeliverySchema	EventDeliverySchema	EventGridSchema	Das Ereignisübermittlungsschema für das Ereignisabonnement.
properties.expirationTimeUtc	string (date-time)		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 Zeit für Ereignisse zu konfigurieren.
properties.topic	string		Name des Themas des Ereignisabonnements.
systemData	systemData		Die Systemmetadaten, die sich auf die Event Grid-Ressource beziehen.
type	string		Typ der Ressource.

EventSubscriptionFilter

Objekt

Filter für das 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 die Auswertung erweiterter Filter anhand eines Wertearrays, anstatt einen Singularwert zu erwarten.
includedEventTypes	string[]		Eine Liste der anwendbaren Ereignistypen, die Teil des Ereignisabonnements sein müssen. Wenn alle Standardereignistypen abonniert werden sollen, legen Sie die IncludedEventTypes auf NULL fest.
isSubjectCaseSensitive	boolean	False	Gibt an, ob die SubjectBeginsWith- und SubjectEndsWith-Eigenschaften des Filters auf die Groß-/Kleinschreibung verglichen werden sollen.
subjectBeginsWith	string		Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Ressourcenpfadpräfix. Das Format dieser Ereignisse hängt vom Herausgeber der Ereignisse ab. In diesem Pfad werden keine Wildcardzeichen unterstützt.
subjectEndsWith	string		Eine optionale Zeichenfolge zum Filtern von Ereignissen für ein Ereignisabonnement basierend auf einem Ressourcenpfadsuffix. In diesem Pfad werden keine Wildcardzeichen unterstützt.

EventSubscriptionIdentity

Objekt

Die Identitätsinformationen mit dem Ereignisabonnement.

Name	Typ	Beschreibung
type	EventSubscriptionIdentityType	Der Typ der verwendeten verwalteten Identität. Kann entweder "SystemAssigned" oder "UserAssigned" sein.
userAssignedIdentity	string	Die der Ressource zugeordnete Benutzeridentität.

EventSubscriptionIdentityType

Enumeration

Der Typ der verwendeten verwalteten Identität. Kann entweder "SystemAssigned" oder "UserAssigned" sein.

Wert	Beschreibung
SystemAssigned
UserAssigned

EventSubscriptionProvisioningState

Enumeration

Bereitstellungsstatus des Ereignisabonnements.

Wert	Beschreibung
AwaitingManualAction
Canceled
Creating
Deleting
Failed
Succeeded
Updating

EventSubscriptionsListResult

Objekt

Ergebnis des List EventSubscriptions-Vorgangs

Name	Typ	Beschreibung
nextLink	string	Ein Link für die nächste Seite von Ereignisabonnements
value	EventSubscription[]	Eine Auflistung von EventSubscriptions

HybridConnectionEventSubscriptionDestination

Objekt

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 des Übermittlungsattributs.
properties.resourceId	string (arm-id)	Die Azure-Ressourcen-ID einer Hybridverbindung, die das Ziel eines Ereignisabonnements ist.

IsNotNullAdvancedFilter

Objekt

IsNotNull Advanced Filter.

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

IsNullOrUndefinedAdvancedFilter

Objekt

IsNullOrUndefined Advanced Filter.

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

MonitorAlertEventSubscriptionDestination

Objekt

Informationen zum Monitorbenachrichtigungsziel für ein Ereignisabonnement.

Name	Typ	Beschreibung
endpointType	string: MonitorAlert	Typ des Endpunkts für das Ereignisabonnementziel.
properties.actionGroups	string[] (arm-id)	Die Liste der ARM-IDs von Aktionsgruppen, die für jede Warnung ausgelöst werden, die über dieses Ereignisabonnement ausgelöst wird. Jede RESSOURCEN-ARM-ID sollte diesem Muster folgen: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Insights/actionGroups/{ActionGroupName}.
properties.description	string	Die Beschreibung, die an jede Warnung angefügt wird, die über dieses Ereignisabonnement ausgelöst wird.
properties.severity	MonitorAlertSeverity	Der Schweregrad, der an jede Warnung angefügt wird, die über dieses Ereignisabonnement ausgelöst wird. Dieses Feld muss angegeben werden.

MonitorAlertSeverity

Enumeration

Der Schweregrad, der an jede Warnung angefügt wird, die über dieses Ereignisabonnement ausgelöst wird. Dieses Feld muss angegeben werden.

Wert	Beschreibung
Sev0
Sev1
Sev2
Sev3
Sev4

NamespaceTopicEventSubscriptionDestination

Objekt

Informationen zum Namespacethemaziel für ein Ereignisabonnement.

Name	Typ	Beschreibung
endpointType	string: NamespaceTopic	Typ des Endpunkts für das Ereignisabonnementziel.
properties.resourceId	string (arm-id)	Die Azure-Ressourcen-ID, die den Endpunkt des Event Grid Namespace Topic-Ziels eines Ereignisabonnements darstellt. Dieses Feld ist erforderlich, und die aufgelistete Namespacethemaressource muss bereits vorhanden sein. Die RESSOURCEN-ARM-ID sollte diesem Muster folgen: /subscriptions/{AzureSubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.EventGrid/namespaces/{NamespaceName}/topics/{TopicName}.

NumberGreaterThanAdvancedFilter

Objekt

NumberGreaterThan Advanced Filter.

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

NumberGreaterThanOrEqualsAdvancedFilter

Objekt

NumberGreaterThanOrEquals Advanced Filter.

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

NumberInAdvancedFilter

Objekt

Erweiterter NumberIn-Filter.

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

NumberInRangeAdvancedFilter

Objekt

NumberInRange Advanced Filter.

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

NumberLessThanAdvancedFilter

Objekt

NumberLessThan Advanced Filter.

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

NumberLessThanOrEqualsAdvancedFilter

Objekt

NumberLessThanOrEquals Advanced Filter.

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

NumberNotInAdvancedFilter

Objekt

Erweiterter NumberNotIn-Filter.

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

NumberNotInRangeAdvancedFilter

Objekt

Erweiterter NumberNotInRange-Filter.

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

RetryPolicy

Objekt

Informationen zur Wiederholungsrichtlinie für ein Ereignisabonnement.

Name	Typ	Standardwert	Beschreibung
eventTimeToLiveInMinutes	integer (int32)	1440	Time To Live (in Minuten) für Ereignisse.
maxDeliveryAttempts	integer (int32)	30	Maximale Anzahl von Wiederholungsversuchen für Ereignisse.

ServiceBusQueueEventSubscriptionDestination

Objekt

Informationen zum Servicebusziel für ein Ereignisabonnement.

Name	Typ	Beschreibung
endpointType	string: ServiceBusQueue	Typ des Endpunkts für das Ereignisabonnementziel.
properties.deliveryAttributeMappings	DeliveryAttributeMapping[]: DynamicDeliveryAttributeMapping[] StaticDeliveryAttributeMapping[]	Details des Übermittlungsattributs.
properties.resourceId	string (arm-id)	Die Azure-Ressourcen-ID, die den Endpunkt des ServiceBus-Ziels eines Ereignisabonnements darstellt.

ServiceBusTopicEventSubscriptionDestination

Objekt

Informationen zum Ziel des Servicebusthemas für ein Ereignisabonnement.

Name	Typ	Beschreibung
endpointType	string: ServiceBusTopic	Typ des Endpunkts für das Ereignisabonnementziel.
properties.deliveryAttributeMappings	DeliveryAttributeMapping[]: DynamicDeliveryAttributeMapping[] StaticDeliveryAttributeMapping[]	Details des Übermittlungsattributs.
properties.resourceId	string (arm-id)	Die Azure-Ressourcen-ID, die den Endpunkt des Service Bus Topic-Ziels eines Ereignisabonnements darstellt.

StaticDeliveryAttributeMapping

Objekt

Details zur Zuordnung statischer Übermittlungsattribute.

Name	Typ	Standardwert	Beschreibung
name	string		Name des Übermittlungsattributs oder -headers.
properties.isSecret	boolean	False	Boolesche Kennzeichnung, um zu ermitteln, ob das Attribut vertrauliche Informationen enthält.
properties.value	string		Wert des Übermittlungsattributs.
type	string: Static		Typ des Übermittlungsattributs oder des Headernamens.

StorageBlobDeadLetterDestination

Objekt

Informationen zum Speicher-BLOB-basierten Ziel für inaktive Buchstaben.

Name	Typ	Beschreibung
endpointType	string: StorageBlob	Typ des Endpunkts für das Ziel des inaktiven Buchstabens
properties.blobContainerName	string	Der Name des Speicher-BLOB-Containers, der das Ziel der Deadletter-Ereignisse ist
properties.resourceId	string (arm-id)	Die Azure-Ressourcen-ID des Speicherkontos, das das Ziel der Deadletter-Ereignisse ist

StorageQueueEventSubscriptionDestination

Objekt

Informationen zum Ziel der Speicherwarteschlange für ein Ereignisabonnement.

Name	Typ	Beschreibung
endpointType	string: StorageQueue	Typ des Endpunkts für das Ereignisabonnementziel.
properties.queueMessageTimeToLiveInSeconds	integer (int64)	Speicherwarteschlangen-Nachrichtenzeit, um in Sekunden zu leben. Dieser Wert darf nicht null oder negativ sein, mit Ausnahme der Verwendung von -1, um anzugeben, dass die Zeit bis zum Leben der Nachricht unendlich ist.
properties.queueName	string	Der Name der Speicherwarteschlange unter einem Speicherkonto, das das Ziel eines Ereignisabonnements ist.
properties.resourceId	string (arm-id)	Die Azure-Ressourcen-ID des Speicherkontos, das die Warteschlange enthält, die das Ziel eines Ereignisabonnements ist.

StringBeginsWithAdvancedFilter

Objekt

StringBeginsWith Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, 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

Objekt

StringContains Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, 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

Objekt

StringEndsWith Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, 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

Objekt

StringIn Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, 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

Objekt

StringNotBeginsWith Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, 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

Objekt

Erweiterter StringNotContains-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, 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

Objekt

StringNotEndsWith Advanced Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, 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

Objekt

Erweiterter StringNotIn-Filter.

Name	Typ	Beschreibung
key	string	Das Feld/die Eigenschaft im Ereignis, 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

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	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 (date-time)	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.

TlsVersion

Enumeration

Minimale TLS-Version des Herausgebers, die in dieser Domäne veröffentlicht werden darf

Wert	Beschreibung
1.0
1.1
1.2

WebHookEventSubscriptionDestination

Objekt

Informationen zum Webhook-Ziel 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 eingeschlossen wird.
properties.azureActiveDirectoryTenantId	string		Die Azure Active Directory-Mandanten-ID, um das Zugriffstoken abzurufen, das als Bearertoken in Übermittlungsanforderungen eingeschlossen wird.
properties.deliveryAttributeMappings	DeliveryAttributeMapping[]: DynamicDeliveryAttributeMapping[] StaticDeliveryAttributeMapping[]		Details des Übermittlungsattributs.
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 (int32)	1	Maximale Anzahl von Ereignissen pro Batch.
properties.minimumTlsVersionAllowed	TlsVersion		Minimale TLS-Version, die vom Webhook-Endpunkt unterstützt werden soll
properties.preferredBatchSizeInKilobytes	integer (int32)	64	Bevorzugte Batchgröße in Kilobyte.

Freigeben über

Event Subscriptions - List Regional By Resource Group For Topic Type

URI-Parameter

Antworten

Beispiele

EventSubscriptions_ListRegionalByResourceGroupForTopicType

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AzureFunctionEventSubscriptionDestination

BoolEqualsAdvancedFilter

createdByType

DeadLetterWithResourceIdentity

DeliveryWithResourceIdentity

DynamicDeliveryAttributeMapping

EventDeliverySchema

EventHubEventSubscriptionDestination

EventSubscription

EventSubscriptionFilter

EventSubscriptionIdentity

EventSubscriptionIdentityType

EventSubscriptionProvisioningState

EventSubscriptionsListResult

HybridConnectionEventSubscriptionDestination

IsNotNullAdvancedFilter

IsNullOrUndefinedAdvancedFilter

MonitorAlertEventSubscriptionDestination

MonitorAlertSeverity

NamespaceTopicEventSubscriptionDestination

NumberGreaterThanAdvancedFilter

NumberGreaterThanOrEqualsAdvancedFilter

NumberInAdvancedFilter

NumberInRangeAdvancedFilter

NumberLessThanAdvancedFilter

NumberLessThanOrEqualsAdvancedFilter

NumberNotInAdvancedFilter

NumberNotInRangeAdvancedFilter

RetryPolicy

ServiceBusQueueEventSubscriptionDestination

ServiceBusTopicEventSubscriptionDestination

StaticDeliveryAttributeMapping

StorageBlobDeadLetterDestination

StorageQueueEventSubscriptionDestination

StringBeginsWithAdvancedFilter

StringContainsAdvancedFilter

StringEndsWithAdvancedFilter

StringInAdvancedFilter

StringNotBeginsWithAdvancedFilter

StringNotContainsAdvancedFilter

StringNotEndsWithAdvancedFilter

StringNotInAdvancedFilter

systemData

TlsVersion

WebHookEventSubscriptionDestination