Microsoft.EventHub namespaces/applicationGroups 2024-05-01-preview
Bicep resource definition
The namespaces/applicationGroups resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.EventHub/namespaces/applicationGroups resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.EventHub/namespaces/applicationGroups@2024-05-01-preview' = {
parent: resourceSymbolicName
name: 'string'
properties: {
clientAppGroupIdentifier: 'string'
isEnabled: bool
policies: [
{
name: 'string'
type: 'string'
// For remaining properties, see ApplicationGroupPolicy objects
}
]
}
}
ApplicationGroupPolicy objects
Set the type property to specify the type of object.
For ThrottlingPolicy, use:
{
metricId: 'string'
rateLimitThreshold: int
type: 'ThrottlingPolicy'
}
Property values
ApplicationGroupPolicy
| Name | Description | Value |
|---|---|---|
| name | The Name of this policy | string (required) |
| type | Set to 'ThrottlingPolicy' for type ThrottlingPolicy. | 'ThrottlingPolicy' (required) |
ApplicationGroupProperties
| Name | Description | Value |
|---|---|---|
| clientAppGroupIdentifier | The Unique identifier for application group.Supports SAS(SASKeyName=KeyName) or AAD(AADAppID=Guid) | string (required) |
| isEnabled | Determines if Application Group is allowed to create connection with namespace or not. Once the isEnabled is set to false, all the existing connections of application group gets dropped and no new connections will be allowed | bool |
| policies | List of group policies that define the behavior of application group. The policies can support resource governance scenarios such as limiting ingress or egress traffic. | ApplicationGroupPolicy[] |
Microsoft.EventHub/namespaces/applicationGroups
| Name | Description | Value |
|---|---|---|
| name | The resource name | string Constraints: Min length = 1 Max length = 1 (required) |
| parent | In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource. For more information, see Child resource outside parent resource. |
Symbolic name for resource of type: namespaces |
| properties | ApplicationGroupProperties |
ThrottlingPolicy
| Name | Description | Value |
|---|---|---|
| metricId | Metric Id on which the throttle limit should be set, MetricId can be discovered by hovering over Metric in the Metrics section of Event Hub Namespace inside Azure Portal | 'IncomingBytes' 'IncomingMessages' 'OutgoingBytes' 'OutgoingMessages' (required) |
| rateLimitThreshold | The Threshold limit above which the application group will be throttled.Rate limit is always per second. | int (required) |
| type | Application Group Policy types | 'ThrottlingPolicy' (required) |
ARM template resource definition
The namespaces/applicationGroups resource type can be deployed with operations that target:
- Resource groups - See resource group deployment commands
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.EventHub/namespaces/applicationGroups resource, add the following JSON to your template.
{
"type": "Microsoft.EventHub/namespaces/applicationGroups",
"apiVersion": "2024-05-01-preview",
"name": "string",
"properties": {
"clientAppGroupIdentifier": "string",
"isEnabled": "bool",
"policies": [ {
"name": "string",
"type": "string"
// For remaining properties, see ApplicationGroupPolicy objects
} ]
}
}
ApplicationGroupPolicy objects
Set the type property to specify the type of object.
For ThrottlingPolicy, use:
{
"metricId": "string",
"rateLimitThreshold": "int",
"type": "ThrottlingPolicy"
}
Property values
ApplicationGroupPolicy
| Name | Description | Value |
|---|---|---|
| name | The Name of this policy | string (required) |
| type | Set to 'ThrottlingPolicy' for type ThrottlingPolicy. | 'ThrottlingPolicy' (required) |
ApplicationGroupProperties
| Name | Description | Value |
|---|---|---|
| clientAppGroupIdentifier | The Unique identifier for application group.Supports SAS(SASKeyName=KeyName) or AAD(AADAppID=Guid) | string (required) |
| isEnabled | Determines if Application Group is allowed to create connection with namespace or not. Once the isEnabled is set to false, all the existing connections of application group gets dropped and no new connections will be allowed | bool |
| policies | List of group policies that define the behavior of application group. The policies can support resource governance scenarios such as limiting ingress or egress traffic. | ApplicationGroupPolicy[] |
Microsoft.EventHub/namespaces/applicationGroups
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2024-05-01-preview' |
| name | The resource name | string Constraints: Min length = 1 Max length = 1 (required) |
| properties | ApplicationGroupProperties | |
| type | The resource type | 'Microsoft.EventHub/namespaces/applicationGroups' |
ThrottlingPolicy
| Name | Description | Value |
|---|---|---|
| metricId | Metric Id on which the throttle limit should be set, MetricId can be discovered by hovering over Metric in the Metrics section of Event Hub Namespace inside Azure Portal | 'IncomingBytes' 'IncomingMessages' 'OutgoingBytes' 'OutgoingMessages' (required) |
| rateLimitThreshold | The Threshold limit above which the application group will be throttled.Rate limit is always per second. | int (required) |
| type | Application Group Policy types | 'ThrottlingPolicy' (required) |
Terraform (AzAPI provider) resource definition
The namespaces/applicationGroups resource type can be deployed with operations that target:
- Resource groups
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.EventHub/namespaces/applicationGroups resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.EventHub/namespaces/applicationGroups@2024-05-01-preview"
name = "string"
body = jsonencode({
properties = {
clientAppGroupIdentifier = "string"
isEnabled = bool
policies = [
{
name = "string"
type = "string"
// For remaining properties, see ApplicationGroupPolicy objects
}
]
}
})
}
ApplicationGroupPolicy objects
Set the type property to specify the type of object.
For ThrottlingPolicy, use:
{
metricId = "string"
rateLimitThreshold = int
type = "ThrottlingPolicy"
}
Property values
ApplicationGroupPolicy
| Name | Description | Value |
|---|---|---|
| name | The Name of this policy | string (required) |
| type | Set to 'ThrottlingPolicy' for type ThrottlingPolicy. | 'ThrottlingPolicy' (required) |
ApplicationGroupProperties
| Name | Description | Value |
|---|---|---|
| clientAppGroupIdentifier | The Unique identifier for application group.Supports SAS(SASKeyName=KeyName) or AAD(AADAppID=Guid) | string (required) |
| isEnabled | Determines if Application Group is allowed to create connection with namespace or not. Once the isEnabled is set to false, all the existing connections of application group gets dropped and no new connections will be allowed | bool |
| policies | List of group policies that define the behavior of application group. The policies can support resource governance scenarios such as limiting ingress or egress traffic. | ApplicationGroupPolicy[] |
Microsoft.EventHub/namespaces/applicationGroups
| Name | Description | Value |
|---|---|---|
| name | The resource name | string Constraints: Min length = 1 Max length = 1 (required) |
| parent_id | The ID of the resource that is the parent for this resource. | ID for resource of type: namespaces |
| properties | ApplicationGroupProperties | |
| type | The resource type | "Microsoft.EventHub/namespaces/applicationGroups@2024-05-01-preview" |
ThrottlingPolicy
| Name | Description | Value |
|---|---|---|
| metricId | Metric Id on which the throttle limit should be set, MetricId can be discovered by hovering over Metric in the Metrics section of Event Hub Namespace inside Azure Portal | 'IncomingBytes' 'IncomingMessages' 'OutgoingBytes' 'OutgoingMessages' (required) |
| rateLimitThreshold | The Threshold limit above which the application group will be throttled.Rate limit is always per second. | int (required) |
| type | Application Group Policy types | 'ThrottlingPolicy' (required) |