Steuern von Ressourcen für Clientanwendungen mit Anwendungsgruppen

Sie können eine Anwendungsgruppe über das Azure-Portal erstellen, indem Sie die folgenden Schritte ausführen.

1. Navigieren Sie zu Ihrem Event Hubs-Namespace.

2. Wählen Sie im linken Menü Anwendungsgruppen unter Einstellungen aus.

3. Wählen Sie auf der Seite Anwendungsgruppen die Option + Anwendungsgruppe auf der Befehlsleiste aus.

   

4. Führen Sie auf der Seite Anwendungsgruppe hinzufügen die folgenden Schritte aus:

   1. Geben Sie einen Namen für die Anwendungsgruppe an.

   2. Bestätigen Sie, dass Aktiviert ausgewählt ist. Um die Anwendungsgruppe zunächst im deaktivierten Zustand zu erstellen, deaktivieren Sie die Option Aktiviert. Dieses Flag bestimmt, ob die Clients einer Anwendungsgruppe auf Event Hubs zugreifen können.

   3. Wählen Sie für den Sicherheitskontexttypdie Namespace-Richtlinie für den freigegebenen Zugriff,die Event Hub-Richtlinie für den freigegebenen Zugriff oder die Microsoft Entra-Anwendung aus. Die Anwendungsgruppe unterstützt die Auswahl des SAS-Schlüssels auf Namespace- oder Entitätsebene (Event Hub). Wenn Sie die Anwendungsgruppe erstellen, sollten Sie sie entweder mit einer Shared Access Signature (SAS) oder einer Azure Active Directory-Anwendungs-ID (Azure AD) verknüpfen, die von Clientanwendungen verwendet wird.

   4. Wenn Sie SAS-Richtlinie für Namespaces ausgewählt haben:

      1. Wählen Sie als SAS-Schlüsselname die SAS-Richtlinie aus, die als Sicherheitskontext für diese Anwendungsgruppe verwendet werden kann. Sie können SAS-Richtlinie hinzufügen auswählen, um eine neue Richtlinie hinzuzufügen und dann der Anwendungsgruppe zuzuordnen.

         

   5. Wenn Sie SAS-Richtlinie für Event Hubs ausgewählt haben:

      1. Kopieren Sie unter SAS-Schlüsselname den Namen der SAS-Richtlinie von der Event Hubs-Seite „SAS-Richtlinien“, und fügen Sie ihn in das Textfeld ein.

         

   6. Wenn Sie die Microsoft Entra-Anwendung ausgewählt haben:

      1. Geben Sie für die Microsoft Entra-Anwendung (Client-ID) die Microsoft Entra-Anwendung oder Client-ID an.

      

Unterstützter Sicherheitskontexttyp

Überprüfen Sie die automatisch generierte Clientgruppen-ID. Dies ist die eindeutige ID, die der Anwendungsgruppe zugeordnet ist. Der Umfang der Anwendungsgovernance (Namespace- oder Entitätsebene) würde von der Zugriffsebene für die verwendete Azure AD-Anwendungs-ID abhängen. Die folgende Tabelle zeigt die automatisch generierte Clientgruppen-ID für verschiedene Sicherheitskontexttypen:

1. Führen Sie die folgenden Schritte aus, um eine Richtlinie hinzuzufügen:

   1. Geben Sie einen Namen für die Richtlinie ein.

   2. Wählen Sie als Typ die Option Bandbreiteneinschränkungsrichtlinie aus.

   3. Wählen Sie für als Metrik-ID eine der folgenden Optionen aus: Eingehende Nachrichten, Ausgehende Nachrichten, Eingehende Bytes, Ausgehende Bytes. Im folgenden Beispiel wird Eingehende Nachrichten ausgewählt.

   4. Geben Sie als Schwellenwert für Ratengrenzwert den Schwellenwert ein. Im folgenden Beispiel wird 10.000 als Schwellenwert für die Anzahl eingehender Nachrichten angegeben.

      

      Dies ist ein Screenshot der Seite mit einer weiteren hinzugefügten Richtlinie.

      

2. Wählen Sie nun auf der Seite Anwendungsgruppe hinzufügen die Option Hinzufügen aus.

3. Vergewissern Sie sich, dass die Anwendungsgruppe in der Liste der Anwendungsgruppen angezeigt wird.

   

   Sie können die Anwendungsgruppe in der Liste löschen, indem Sie das Papierkorbsymbol neben ihr in der Liste auswählen.

Erstellen Sie mit dem CLI-Befehl az eventhubs namespace application-group create eine Anwendungsgruppe auf Event Hubs-Namespace- oder Event Hub-Ebene. Sie müssen --client-app-group-identifier basierend auf dem gewählten Sicherheitskontexttyp festlegen. Prüfen Sie die obige Tabelle auf unterstützte Sicherheitskontexttypen.

Im folgenden Beispiel wird eine Anwendungsgruppe namens myAppGroup im Namespace mynamespace in der Azure-Ressourcengruppe MyResourceGrouperstellt. Sie verwendet die folgenden Konfigurationen.

• Eine SAS-Richtlinie wird als Sicherheitskontext verwendet.
• Die Client-App-Gruppen-ID ist auf NamespaceSASKeyName=<NameOfTheSASkey> festgelegt.
• Erste Bandbreiteneinschränkungsrichtlinie für die Incoming messages-Metrik mit 10000 als Schwellenwert.
• Zweite Bandbreiteneinschränkungsrichtlinie für die Incoming bytes-Metrik mit 20000 als Schwellenwert.

az eventhubs namespace application-group create --namespace-name mynamespace \
                                                -g MyResourceGroup \
                                                --name myAppGroup \
                                                --client-app-group-identifier NamespaceSASKeyName=keyname \
                                                --throttling-policy-config name=policy1 metric-id=IncomingMessages rate-limit-threshold=10000 \
                                                --throttling-policy-config name=policy2 metric-id=IncomingBytes rate-limit-threshold=20000

Weitere Informationen zum CLI-Befehl finden Sie unter az eventhubs namespace application-group create.

Erstellen Sie mit dem PowerShell-Befehl New-AzEventHubApplicationGroup eine Anwendungsgruppe auf Event Hubs-Namespace- oder Event Hub-Ebene. Sie müssen -ClientAppGroupIdentifier basierend auf dem gewählten Sicherheitskontexttyp festlegen. Prüfen Sie die obige Tabelle auf unterstützte Sicherheitskontexttypen.

Im folgenden Beispiel wird New-AzEventHubThrottlingPolicyConfig verwendet, um zwei Richtlinien zu erstellen, die der Anwendung zugeordnet werden.

• Erste Bandbreiteneinschränkungsrichtlinie für die Incoming bytes-Metrik mit 12345 als Schwellenwert.
• Zweite Bandbreiteneinschränkungsrichtlinie für die Incoming messages-Metrik mit 23416 als Schwellenwert.

Anschließend wird eine Anwendungsgruppe namens myappgroup im Namespace mynamespace in der Azure-Ressourcengruppe myresourcegroup erstellt, indem die Bandbreiteneinschränkungsrichtlinien und die SAS-Richtlinie als Sicherheitskontext angegeben werden.

$policy1 = New-AzEventHubThrottlingPolicyConfig -Name policy1 -MetricId IncomingBytes -RateLimitThreshold 12345

$policy2 = New-AzEventHubThrottlingPolicyConfig -Name policy2 -MetricId IncomingMessages -RateLimitThreshold 23416

New-AzEventHubApplicationGroup -ResourceGroupName myresourcegroup -NamespaceName mynamespace -Name myappgroup 
		-ClientAppGroupIdentifier NamespaceSASKeyName=myauthkey -ThrottlingPolicyConfig $policy1, $policy2

Weitere Informationen zum PowerShell-Befehl finden Sie unter New-AzEventHubApplicationGroup.

Im folgenden Beispiel wird gezeigt, wie Sie eine Anwendungsgruppe mithilfe einer ARM-Vorlage erstellen. In diesem Beispiel wird die Anwendungsgruppe einem vorhandenen SAS-Richtliniennamen contososaspolicy zugeordnet, indem Sie den Client AppGroupIdentifier als NamespaceSASKeyName=contososaspolicy festlegen. Die Anwendungsgruppenrichtlinien werden ebenfalls in der ARM-Vorlage definiert. Sie müssen ClientAppGroupIdentifier basierend auf dem gewählten Sicherheitskontexttyp festlegen. Prüfen Sie die obige Tabelle auf unterstützte Sicherheitskontexttypen.

{
	"type": "ApplicationGroups",
	"apiVersion": "2022-01-01-preview",
	"name": "[parameters('applicationGroupName')]",
	"dependsOn": [
		"[resourceId('Microsoft.EventHub/namespaces/', parameters('eventHubNamespaceName'))]",
		"[resourceId('Microsoft.EventHub/namespaces/authorizationRules', parameters('eventHubNamespaceName'),parameters('namespaceAuthorizationRuleName'))]"
	],
	"properties": {
		"ClientAppGroupIdentifier": "NamespaceSASKeyName=contososaspolicy",
		"policies": [{
				"Type": "ThrottlingPolicy",
				"Name": "ThrottlingPolicy1",
				"metricId": "IncomingMessages",
				"rateLimitThreshold": 10
			},
			{
				"Type": "ThrottlingPolicy",
				"Name": "ThrottlingPolicy2",
				"metricId": "IncomingBytes",
				"rateLimitThreshold": 3951729
			}
		],
		"isEnabled": true
	}
}

1. Wählen Sie auf der Seite Event Hubs-Namespace im linken Menü die Option Anwendungsgruppen aus.

2. Wählen Sie die Anwendungsgruppe aus, die Sie aktivieren oder deaktivieren möchten.

   

3. Deaktivieren Sie auf der Seite Anwendungsgruppe bearbeiten das Kontrollkästchen neben Aktiviert, um eine Anwendungsgruppe zu deaktivieren, und wählen Sie dann unten auf der Seite Aktualisieren aus. Aktivieren Sie analog dazu das Kontrollkästchen, um eine Anwendungsgruppe zu aktivieren.

   

Verwenden Sie den Befehl az eventhubs namespace application-group update, wobei --is-enabled auf false festgelegt ist, um eine Anwendungsgruppe zu deaktivieren. Um eine Anwendungsgruppe analog dazu zu aktivieren, legen Sie diese Eigenschaft auf true fest und führen den Befehl aus.

Der folgende Beispielbefehl deaktiviert die Anwendungsgruppe namens myappgroup im Event Hubs-Namespace mynamespace, der sich in der Ressourcengruppe myresourcegroup befindet.

az eventhubs namespace application-group update --namespace-name mynamespace -g myresourcegroup --name myappgroup --is-enabled false

Verwenden Sie den Befehl Set-AzEventHubApplicationGroup, wobei -IsEnabled auf false festgelegt ist, um eine Anwendungsgruppe zu deaktivieren. Um eine Anwendungsgruppe analog dazu zu aktivieren, legen Sie diese Eigenschaft auf true fest und führen den Befehl aus.

Der folgende Beispielbefehl deaktiviert die Anwendungsgruppe namens myappgroup im Event Hubs-Namespace mynamespace, der sich in der Ressourcengruppe myresourcegroup befindet.

Set-AzEventHubApplicationGroup -ResourceGroupName myresourcegroup -NamespaceName mynamespace -Name myappgroup -IsEnabled false

Die folgende ARM-Vorlage zeigt, wie ein vorhandener Namespace (contosonamespace) aktualisiert wird, um eine Anwendungsgruppe zu deaktivieren, indem die isEnabled-Eigenschaft auf false festgelegt wird. Der Bezeichner für die App-Gruppe ist SASKeyName=RootManageSharedAccessKey.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "namespace_name": {
      "defaultValue": "contosonamespace",
      "type": "String"
    },
    "client-app-group-identifier": {
      "defaultValue": "SASKeyName=RootManageSharedAccessKey",
      "type": "String"
    }
  },
  "resources": [
    {
      "type": "Microsoft.EventHub/namespaces/applicationGroups",
      "apiVersion": "2022-01-01-preview",
      "name": "[concat(parameters('namespace_name'), '/contosoappgroup')]",
      "properties": {
        "clientAppGroupIdentifier": "[parameters('client-app-group-identifier')]",
        "isEnabled": false,
		"policies": [
			{
				"type": "ThrottlingPolicy",
				"name": "incomingmsgspolicy",
				"metricId": "IncomingMessages",
				"rateLimitThreshold": 10000
			},
			{
				"type": "ThrottlingPolicy",
				"name": "incomingbytespolicy",
				"metricId": "IncomingBytes",
				"rateLimitThreshold": 20000
			}
		]
      }
    }
  ]
}

1. Wählen Sie auf der Seite Event Hubs-Namespace im linken Menü die Option Anwendungsgruppen aus.

2. Wählen Sie die Anwendungsgruppe aus, für die eine Richtlinie hinzugefügt, aktualisiert oder gelöscht werden soll.

   

3. Auf der Seite Anwendungsgruppe bearbeiten können Sie die folgenden Schritte ausführen:

   1. Aktualisieren von Einstellungen (einschließlich Schwellenwerten) für vorhandene Richtlinien
   2. Hinzufügen einer neuen Richtlinie

Verwenden von az eventhubs namespace application-group policy add zum Hinzufügen einer Richtlinie zu einer vorhandenen Anwendungsgruppe.

Beispiel:

az eventhubs namespace application-group policy add --namespace-name mynamespace -g MyResourceGroup --name myAppGroup --throttling-policy-config name=policy1 metric-id=OutgoingMessages rate-limit-threshold=10500 --throttling-policy-config name=policy2 metric-id=IncomingBytes rate-limit-threshold=20000

Verwenden Sie den Befehl Set-AzEventHubApplicationGroup, wobei -ThrottingPolicyConfig auf die zutreffenden Werte festgelegt ist.

Beispiel:

$policyToBeAppended = New-AzEventHubThrottlingPolicyConfig -Name policy1 -MetricId IncomingBytes -RateLimitThreshold 12345

$appGroup = Get-AzEventHubApplicationGroup -ResourceGroupName myresourcegroup -NamespaceName mynamespace -Name myappgroup

$appGroup.ThrottlingPolicyConfig += $policyToBeAppended

Set-AzEventHubApplicationGroup -ResourceGroupName myresourcegroup -NamespaceName mynamespace -Name myappgroup -ThrottlingPolicyConfig $appGroup.ThrottlingPolicyConfig

Die folgende ARM-Vorlage zeigt, wie ein vorhandener Namespace (contosonamespace) aktualisiert wird, um Bandbreiteneinschränkungsrichtlinien hinzuzufügen. Der Bezeichner für die App-Gruppe ist NamespaceSASKeyName=RootManageSharedAccessKey.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "namespace_name": {
      "defaultValue": "contosonamespace",
      "type": "String"
    },
    "client-app-group-identifier": {
      "defaultValue": "NamespaceSASKeyName=RootManageSharedAccessKey",
      "type": "String"
    }
  },
  "resources": [
    {
      "type": "Microsoft.EventHub/namespaces/applicationGroups",
      "apiVersion": "2022-01-01-preview",
      "name": "[concat(parameters('namespace_name'), '/contosoappgroup')]",
      "properties": {
        "clientAppGroupIdentifier": "[parameters('client-app-group-identifier')]",
        "isEnabled": true,
		"policies": [
			{
				"type": "ThrottlingPolicy",
				"name": "incomingmsgspolicy",
				"metricId": "IncomingMessages",
				"rateLimitThreshold": 10000
			},
			{
				"type": "ThrottlingPolicy",
				"name": "incomingbytespolicy",
				"metricId": "IncomingBytes",
				"rateLimitThreshold": 20000
			}
		]
      }
    }
  ]
}