Microsoft.ServiceBus namespaces 2018-01-01-preview

Article
07/23/2024

Bicep resource definition

The namespaces 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 resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.ServiceBus/namespaces@2018-01-01-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  identity: {
    principalId: 'string'
    tenantId: 'string'
    type: 'SystemAssigned'
  }
  properties: {
    encryption: {
      keySource: 'Microsoft.KeyVault'
      keyVaultProperties: {
        keyName: 'string'
        keyVaultUri: 'string'
      }
    }
    zoneRedundant: bool
  }
}

Property values

namespaces

Name	Description	Value
name	The resource name	string (required) Character limit: 6-50 Valid characters: Alphanumerics and hyphens. Start with a letter. End with a letter or number. For more information, see Create namespace. Resource name must be unique across Azure.
location	The Geo-location where the resource lives	string (required)
tags	Resource tags	Dictionary of tag names and values. See Tags in templates
sku	Properties of SKU	SBSku
identity	Properties of BYOK Identity description	Identity
properties	Properties of the namespace.	SBNamespaceProperties

Identity

Name	Description	Value
principalId	ObjectId from the KeyVault	string
tenantId	TenantId from the KeyVault	string
type	Enumerates the possible value Identity type, which currently supports only 'SystemAssigned'	'SystemAssigned'

SBNamespaceProperties

Name	Description	Value
encryption	Properties of BYOK Encryption description	Encryption
zoneRedundant	Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones.	bool

Encryption

Name	Description	Value
keySource	Enumerates the possible value of keySource for Encryption	'Microsoft.KeyVault'
keyVaultProperties	Properties of KeyVault	KeyVaultProperties

KeyVaultProperties

Name	Description	Value
keyName	Name of the Key from KeyVault	string
keyVaultUri	Uri of KeyVault	string

SBSku

Name	Description	Value
capacity	The specified messaging units for the tier. For Premium tier, capacity are 1,2 and 4.	int
name	Name of this SKU.	'Basic' 'Premium' 'Standard' (required)
tier	The billing tier of this particular SKU.	'Basic' 'Premium' 'Standard'

Quickstart templates

The following quickstart templates deploy this resource type.

Template	Description
EPiserverCMS in Azure	This template allows you to create resources required for EpiServerCMS deployment in Azure
Integration Patterns - Message Router - Service Bus	Solution which shows how we can set up the Message Router pattern using a Service Bus Topic
Create Azure Event Grid Custom Topic and Queue Subscription	Creates an Azure Event Grid custom topic and a service bus queue subscription. Template originally authored by Markus Meyer.
Create Azure Event Grid Custom Topic Subscription	Creates an Azure Event Grid custom topic and a service bus topic subscription. Template originally authored by Markus Meyer.
Correlating messages over Logic Apps using Service Bus	which shows how we can correlate messages over Logic Apps using Azure Service Bus
Create a Service Bus namespace and queue authorization rule	This template enables you to deploy a Service Bus Standard namespace, and authorization rules for both the namespace and a queue.
Create a Service Bus namespace	This template enables you to deploy a Service Bus namespace with a Basic/Standard SKU.
Create a Service Bus Geo-recovery	This template allows you to configure Service Bus Geo-disaster recovery alias on premium SKU Namespaces.
Create a Service Bus namespace and queue	This template enables you to deploy a Service Bus Standard namespace and a queue.
Create a Service Bus namespace, topic, and subscription	This template enables you to deploy a Service Bus Standard namespace, a topic, and a subscription.
Create a Service Bus namespace, topic, subscription and Rule	This template enables you to deploy a Service Bus Standard namespace, a topic, a subscription and a rule.
Create a Service Bus namespace IP Filter rule	This template enables you to deploy a Service Bus Premium namespace with IP Filter rule
Create a Service Bus namespace Virtual Network rule	This template enables you to deploy a Service Bus Premium namespace with Virtual Network rule
Create a Service Bus Premium Namespace and AuthorizationRule	This template creates a Service Bus Premium Namespace and a namespace AuthorizationRule
Connect to a Service Bus namespace via private endpoint	This sample shows how to use configure a virtual network and private DNS zone to access a Service Bus namespace via private endpoint.
Create a Service Bus Namespace and Topic	This template creates a Service Bus Namespace and Topic.
Create a Service Bus Topic with Subscription and SQL Filter	This template creates a Service Bus Namespace and Topic with a Subscription using a SQL Filter expression to recieve only the messages that match the defined SQL Filter Expression.

ARM template resource definition

The namespaces 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 resource, add the following JSON to your template.

{
  "type": "Microsoft.ServiceBus/namespaces",
  "apiVersion": "2018-01-01-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "identity": {
    "principalId": "string",
    "tenantId": "string",
    "type": "SystemAssigned"
  },
  "properties": {
    "encryption": {
      "keySource": "Microsoft.KeyVault",
      "keyVaultProperties": {
        "keyName": "string",
        "keyVaultUri": "string"
      }
    },
    "zoneRedundant": "bool"
  }
}

Property values

namespaces

Name	Description	Value
type	The resource type	'Microsoft.ServiceBus/namespaces'
apiVersion	The resource api version	'2018-01-01-preview'
name	The resource name	string (required) Character limit: 6-50 Valid characters: Alphanumerics and hyphens. Start with a letter. End with a letter or number. For more information, see Create namespace. Resource name must be unique across Azure.
location	The Geo-location where the resource lives	string (required)
tags	Resource tags	Dictionary of tag names and values. See Tags in templates
sku	Properties of SKU	SBSku
identity	Properties of BYOK Identity description	Identity
properties	Properties of the namespace.	SBNamespaceProperties

Identity

Name	Description	Value
principalId	ObjectId from the KeyVault	string
tenantId	TenantId from the KeyVault	string
type	Enumerates the possible value Identity type, which currently supports only 'SystemAssigned'	'SystemAssigned'

SBNamespaceProperties

Name	Description	Value
encryption	Properties of BYOK Encryption description	Encryption
zoneRedundant	Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones.	bool

Encryption

Name	Description	Value
keySource	Enumerates the possible value of keySource for Encryption	'Microsoft.KeyVault'
keyVaultProperties	Properties of KeyVault	KeyVaultProperties

KeyVaultProperties

Name	Description	Value
keyName	Name of the Key from KeyVault	string
keyVaultUri	Uri of KeyVault	string

SBSku

Name	Description	Value
capacity	The specified messaging units for the tier. For Premium tier, capacity are 1,2 and 4.	int
name	Name of this SKU.	'Basic' 'Premium' 'Standard' (required)
tier	The billing tier of this particular SKU.	'Basic' 'Premium' 'Standard'

Quickstart templates

The following quickstart templates deploy this resource type.

Template	Description
EPiserverCMS in Azure	This template allows you to create resources required for EpiServerCMS deployment in Azure
Integration Patterns - Message Router - Service Bus	Solution which shows how we can set up the Message Router pattern using a Service Bus Topic
Create Azure Event Grid Custom Topic and Queue Subscription	Creates an Azure Event Grid custom topic and a service bus queue subscription. Template originally authored by Markus Meyer.
Create Azure Event Grid Custom Topic Subscription	Creates an Azure Event Grid custom topic and a service bus topic subscription. Template originally authored by Markus Meyer.
Correlating messages over Logic Apps using Service Bus	which shows how we can correlate messages over Logic Apps using Azure Service Bus
Create a Service Bus namespace and queue authorization rule	This template enables you to deploy a Service Bus Standard namespace, and authorization rules for both the namespace and a queue.
Create a Service Bus namespace	This template enables you to deploy a Service Bus namespace with a Basic/Standard SKU.
Create a Service Bus Geo-recovery	This template allows you to configure Service Bus Geo-disaster recovery alias on premium SKU Namespaces.
Create a Service Bus namespace and queue	This template enables you to deploy a Service Bus Standard namespace and a queue.
Create a Service Bus namespace, topic, and subscription	This template enables you to deploy a Service Bus Standard namespace, a topic, and a subscription.
Create a Service Bus namespace, topic, subscription and Rule	This template enables you to deploy a Service Bus Standard namespace, a topic, a subscription and a rule.
Create a Service Bus namespace IP Filter rule	This template enables you to deploy a Service Bus Premium namespace with IP Filter rule
Create a Service Bus namespace Virtual Network rule	This template enables you to deploy a Service Bus Premium namespace with Virtual Network rule
Create a Service Bus Premium Namespace and AuthorizationRule	This template creates a Service Bus Premium Namespace and a namespace AuthorizationRule
Connect to a Service Bus namespace via private endpoint	This sample shows how to use configure a virtual network and private DNS zone to access a Service Bus namespace via private endpoint.
Create a Service Bus Namespace and Topic	This template creates a Service Bus Namespace and Topic.
Create a Service Bus Topic with Subscription and SQL Filter	This template creates a Service Bus Namespace and Topic with a Subscription using a SQL Filter expression to recieve only the messages that match the defined SQL Filter Expression.

Terraform (AzAPI provider) resource definition

The namespaces 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 resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ServiceBus/namespaces@2018-01-01-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "SystemAssigned"
  }
  body = jsonencode({
    properties = {
      encryption = {
        keySource = "Microsoft.KeyVault"
        keyVaultProperties = {
          keyName = "string"
          keyVaultUri = "string"
        }
      }
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      name = "string"
      tier = "string"
    }
  })
}

Property values

namespaces

Name	Description	Value
type	The resource type	"Microsoft.ServiceBus/namespaces@2018-01-01-preview"
name	The resource name	string (required) Character limit: 6-50 Valid characters: Alphanumerics and hyphens. Start with a letter. End with a letter or number. For more information, see Create namespace. Resource name must be unique across Azure.
location	The Geo-location where the resource lives	string (required)
parent_id	To deploy to a resource group, use the ID of that resource group.	string (required)
tags	Resource tags	Dictionary of tag names and values.
sku	Properties of SKU	SBSku
identity	Properties of BYOK Identity description	Identity
properties	Properties of the namespace.	SBNamespaceProperties

Identity

Name	Description	Value
type	Enumerates the possible value Identity type, which currently supports only 'SystemAssigned'	"SystemAssigned"

SBNamespaceProperties

Name	Description	Value
encryption	Properties of BYOK Encryption description	Encryption
zoneRedundant	Enabling this property creates a Premium Service Bus Namespace in regions supported availability zones.	bool

Encryption

Name	Description	Value
keySource	Enumerates the possible value of keySource for Encryption	"Microsoft.KeyVault"
keyVaultProperties	Properties of KeyVault	KeyVaultProperties

KeyVaultProperties

Name	Description	Value
keyName	Name of the Key from KeyVault	string
keyVaultUri	Uri of KeyVault	string

SBSku

Name	Description	Value
capacity	The specified messaging units for the tier. For Premium tier, capacity are 1,2 and 4.	int
name	Name of this SKU.	"Basic" "Premium" "Standard" (required)
tier	The billing tier of this particular SKU.	"Basic" "Premium" "Standard"

Share via

Microsoft.ServiceBus namespaces 2018-01-01-preview

Bicep resource definition

Resource format

Property values

namespaces

Identity

SBNamespaceProperties

Encryption

KeyVaultProperties

SBSku

Quickstart templates

ARM template resource definition

Resource format

Property values

namespaces

Identity

SBNamespaceProperties

Encryption

KeyVaultProperties

SBSku

Quickstart templates

Terraform (AzAPI provider) resource definition

Resource format

Property values

namespaces

Identity

SBNamespaceProperties

Encryption

KeyVaultProperties

SBSku

Feedback

Additional resources