Microsoft.ServiceBus namespaces/topics/subscriptions 2015-08-01

Bicep resource definition

The namespaces/topics/subscriptions resource type can be deployed to:

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' = {
  name: 'string'
  location: 'string'
  parent: resourceSymbolicName
  properties: {
    autoDeleteOnIdle: 'string'
    deadLetteringOnFilterEvaluationExceptions: bool
    deadLetteringOnMessageExpiration: bool
    defaultMessageTimeToLive: 'string'
    enableBatchedOperations: bool
    entityAvailabilityStatus: 'string'
    lockDuration: 'string'
    maxDeliveryCount: int
    requiresSession: bool
    status: 'string'
  }
}

Property values

namespaces/topics/subscriptions

Name Description Value
name The resource name

See how to set names and types for child resources in Bicep.
string (required)

Character limit: 1-50

Valid characters:
Alphanumerics, periods, hyphens, and underscores.

Start and end with alphnumeric.
location Subscription data center location. string (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: 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'
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
Integration Patterns - Message Router - Service Bus

Deploy to Azure
Solution which shows how we can set up the Message Router pattern using a Service Bus Topic
Correlating messages over Logic Apps using Service Bus

Deploy to Azure
which shows how we can correlate messages over Logic Apps using Azure Service Bus

ARM template resource definition

The namespaces/topics/subscriptions resource type can be deployed to:

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",
    "lockDuration": "string",
    "maxDeliveryCount": "int",
    "requiresSession": "bool",
    "status": "string"
  }
}

Property values

namespaces/topics/subscriptions

Name Description Value
type The resource type 'Microsoft.ServiceBus/namespaces/topics/subscriptions'
apiVersion The resource api version '2015-08-01'
name The resource name

See how to set names and types for child resources in JSON ARM templates.
string (required)

Character limit: 1-50

Valid characters:
Alphanumerics, periods, hyphens, and underscores.

Start and end with alphnumeric.
location Subscription data center location. string (required)
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'
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
Integration Patterns - Message Router - Service Bus

Deploy to Azure
Solution which shows how we can set up the Message Router pattern using a Service Bus Topic
Correlating messages over Logic Apps using Service Bus

Deploy to Azure
which shows how we can correlate messages over Logic Apps using Azure Service Bus

Terraform (AzAPI provider) resource definition

The namespaces/topics/subscriptions resource type can be deployed to:

  • 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"
  parent_id = "string"
  body = jsonencode({
    properties = {
      autoDeleteOnIdle = "string"
      deadLetteringOnFilterEvaluationExceptions = bool
      deadLetteringOnMessageExpiration = bool
      defaultMessageTimeToLive = "string"
      enableBatchedOperations = bool
      entityAvailabilityStatus = "string"
      lockDuration = "string"
      maxDeliveryCount = int
      requiresSession = bool
      status = "string"
    }
  })
}

Property values

namespaces/topics/subscriptions

Name Description Value
type The resource type "Microsoft.ServiceBus/namespaces/topics/subscriptions@2015-08-01"
name The resource name string (required)

Character limit: 1-50

Valid characters:
Alphanumerics, periods, hyphens, and underscores.

Start and end with alphnumeric.
location Subscription data center location. string (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: 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"
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"