Microsoft.ServiceBus namespaces/topics/subscriptions 2015-08-01
Bicep resource definition
The namespaces/topics/subscriptions 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.ServiceBus/namespaces/topics/subscriptions resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.ServiceBus/namespaces/topics/subscriptions@2015-08-01' = {
parent: resourceSymbolicName
location: 'string'
name: 'string'
properties: {
autoDeleteOnIdle: 'string'
deadLetteringOnFilterEvaluationExceptions: bool
deadLetteringOnMessageExpiration: bool
defaultMessageTimeToLive: 'string'
enableBatchedOperations: bool
entityAvailabilityStatus: 'string'
isReadOnly: bool
lockDuration: 'string'
maxDeliveryCount: int
requiresSession: bool
status: 'string'
}
}
Property values
Microsoft.ServiceBus/namespaces/topics/subscriptions
| Name | Description | Value |
|---|---|---|
| location | Subscription data center location. | string (required) |
| 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/topics |
| properties | Description of Subscription Resource. | SubscriptionProperties |
SubscriptionProperties
| Name | Description | Value |
|---|---|---|
| autoDeleteOnIdle | TimeSpan idle interval after which the topic is automatically deleted. The minimum duration is 5 minutes. | string |
| deadLetteringOnFilterEvaluationExceptions | Value that indicates whether a subscription has dead letter support on filter evaluation exceptions. | bool |
| deadLetteringOnMessageExpiration | Value that indicates whether a subscription has dead letter support when a message expires. | bool |
| defaultMessageTimeToLive | Default message time to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself. | string |
| enableBatchedOperations | Value that indicates whether server-side batched operations are enabled. | bool |
| entityAvailabilityStatus | Entity availability status for the topic. | 'Available' 'Limited' 'Renaming' 'Restoring' 'Unknown' |
| isReadOnly | Value that indicates whether the entity description is read-only. | bool |
| lockDuration | The lock duration time span for the subscription. | string |
| maxDeliveryCount | Number of maximum deliveries. | int |
| requiresSession | Value indicating if a subscription supports the concept of sessions. | bool |
| status | Enumerates the possible values for the status of a messaging entity. | 'Active' 'Creating' 'Deleting' 'Disabled' 'ReceiveDisabled' 'Renaming' 'Restoring' 'SendDisabled' 'Unknown' |
Quickstart samples
The following quickstart samples deploy this resource type.
| Bicep File | Description |
|---|---|
| Creates a Dapr microservices app using Container Apps | Create a Dapr microservices app using Container Apps. |
| Creates a Dapr pub-sub servicebus app using Container Apps | Create a Dapr pub-sub servicebus app using Container Apps. |
ARM template resource definition
The namespaces/topics/subscriptions 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.ServiceBus/namespaces/topics/subscriptions resource, add the following JSON to your template.
{
"type": "Microsoft.ServiceBus/namespaces/topics/subscriptions",
"apiVersion": "2015-08-01",
"name": "string",
"location": "string",
"properties": {
"autoDeleteOnIdle": "string",
"deadLetteringOnFilterEvaluationExceptions": "bool",
"deadLetteringOnMessageExpiration": "bool",
"defaultMessageTimeToLive": "string",
"enableBatchedOperations": "bool",
"entityAvailabilityStatus": "string",
"isReadOnly": "bool",
"lockDuration": "string",
"maxDeliveryCount": "int",
"requiresSession": "bool",
"status": "string"
}
}
Property values
Microsoft.ServiceBus/namespaces/topics/subscriptions
| Name | Description | Value |
|---|---|---|
| apiVersion | The api version | '2015-08-01' |
| location | Subscription data center location. | string (required) |
| name | The resource name | string Constraints: Min length = 1 Max length = 1 (required) |
| properties | Description of Subscription Resource. | SubscriptionProperties |
| type | The resource type | 'Microsoft.ServiceBus/namespaces/topics/subscriptions' |
SubscriptionProperties
| Name | Description | Value |
|---|---|---|
| autoDeleteOnIdle | TimeSpan idle interval after which the topic is automatically deleted. The minimum duration is 5 minutes. | string |
| deadLetteringOnFilterEvaluationExceptions | Value that indicates whether a subscription has dead letter support on filter evaluation exceptions. | bool |
| deadLetteringOnMessageExpiration | Value that indicates whether a subscription has dead letter support when a message expires. | bool |
| defaultMessageTimeToLive | Default message time to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself. | string |
| enableBatchedOperations | Value that indicates whether server-side batched operations are enabled. | bool |
| entityAvailabilityStatus | Entity availability status for the topic. | 'Available' 'Limited' 'Renaming' 'Restoring' 'Unknown' |
| isReadOnly | Value that indicates whether the entity description is read-only. | bool |
| lockDuration | The lock duration time span for the subscription. | string |
| maxDeliveryCount | Number of maximum deliveries. | int |
| requiresSession | Value indicating if a subscription supports the concept of sessions. | bool |
| status | Enumerates the possible values for the status of a messaging entity. | 'Active' 'Creating' 'Deleting' 'Disabled' 'ReceiveDisabled' 'Renaming' 'Restoring' 'SendDisabled' 'Unknown' |
Quickstart templates
The following quickstart templates deploy this resource type.
| Template | Description |
|---|---|
Correlating messages over Logic Apps using Service Bus |
which shows how we can correlate messages over Logic Apps using Azure Service Bus |
| Creates a Dapr microservices app using Container Apps |
Create a Dapr microservices app using Container Apps. |
| Creates a Dapr pub-sub servicebus app using Container Apps |
Create a Dapr pub-sub servicebus app using Container Apps. |
| Integration Patterns - Message Router - Service Bus |
Solution which shows how we can set up the Message Router pattern using a Service Bus Topic |
Terraform (AzAPI provider) resource definition
The namespaces/topics/subscriptions 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.ServiceBus/namespaces/topics/subscriptions resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.ServiceBus/namespaces/topics/subscriptions@2015-08-01"
name = "string"
location = "string"
body = jsonencode({
properties = {
autoDeleteOnIdle = "string"
deadLetteringOnFilterEvaluationExceptions = bool
deadLetteringOnMessageExpiration = bool
defaultMessageTimeToLive = "string"
enableBatchedOperations = bool
entityAvailabilityStatus = "string"
isReadOnly = bool
lockDuration = "string"
maxDeliveryCount = int
requiresSession = bool
status = "string"
}
})
}
Property values
Microsoft.ServiceBus/namespaces/topics/subscriptions
| Name | Description | Value |
|---|---|---|
| location | Subscription data center location. | string (required) |
| 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/topics |
| properties | Description of Subscription Resource. | SubscriptionProperties |
| type | The resource type | "Microsoft.ServiceBus/namespaces/topics/subscriptions@2015-08-01" |
SubscriptionProperties
| Name | Description | Value |
|---|---|---|
| autoDeleteOnIdle | TimeSpan idle interval after which the topic is automatically deleted. The minimum duration is 5 minutes. | string |
| deadLetteringOnFilterEvaluationExceptions | Value that indicates whether a subscription has dead letter support on filter evaluation exceptions. | bool |
| deadLetteringOnMessageExpiration | Value that indicates whether a subscription has dead letter support when a message expires. | bool |
| defaultMessageTimeToLive | Default message time to live value. This is the duration after which the message expires, starting from when the message is sent to Service Bus. This is the default value used when TimeToLive is not set on a message itself. | string |
| enableBatchedOperations | Value that indicates whether server-side batched operations are enabled. | bool |
| entityAvailabilityStatus | Entity availability status for the topic. | 'Available' 'Limited' 'Renaming' 'Restoring' 'Unknown' |
| isReadOnly | Value that indicates whether the entity description is read-only. | bool |
| lockDuration | The lock duration time span for the subscription. | string |
| maxDeliveryCount | Number of maximum deliveries. | int |
| requiresSession | Value indicating if a subscription supports the concept of sessions. | bool |
| status | Enumerates the possible values for the status of a messaging entity. | 'Active' 'Creating' 'Deleting' 'Disabled' 'ReceiveDisabled' 'Renaming' 'Restoring' 'SendDisabled' 'Unknown' |