Microsoft.ServiceBus namespaces

مقالة
02/23/2022
قراءة خلال 5 دقائق

The namespaces resource type can be deployed to: Resource groups.

To learn about resource group deployments, see Bicep or ARM template.

Template format

To create a Microsoft.ServiceBus/namespaces resource, add the following Bicep or JSON to your template.

Bicep
JSON

resource symbolicname 'Microsoft.ServiceBus/namespaces@2021-11-01' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    name: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
    userAssignedIdentities: {}
  }
  properties: {
    alternateName: 'string'
    disableLocalAuth: bool
    encryption: {
      keySource: 'Microsoft.KeyVault'
      keyVaultProperties: [
        {
          identity: {
            userAssignedIdentity: 'string'
          }
          keyName: 'string'
          keyVaultUri: 'string'
          keyVersion: 'string'
        }
      ]
      requireInfrastructureEncryption: bool
    }
    privateEndpointConnections: [
      {
        properties: {
          privateEndpoint: {
            id: 'string'
          }
          privateLinkServiceConnectionState: {
            description: 'string'
            status: 'string'
          }
          provisioningState: 'string'
        }
      }
    ]
    zoneRedundant: bool
  }
}

{
  "type": "Microsoft.ServiceBus/namespaces",
  "apiVersion": "2021-11-01",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "name": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string",
    "userAssignedIdentities": {}
  },
  "properties": {
    "alternateName": "string",
    "disableLocalAuth": "bool",
    "encryption": {
      "keySource": "Microsoft.KeyVault",
      "keyVaultProperties": [
        {
          "identity": {
            "userAssignedIdentity": "string"
          },
          "keyName": "string",
          "keyVaultUri": "string",
          "keyVersion": "string"
        }
      ],
      "requireInfrastructureEncryption": "bool"
    },
    "privateEndpointConnections": [
      {
        "properties": {
          "privateEndpoint": {
            "id": "string"
          },
          "privateLinkServiceConnectionState": {
            "description": "string",
            "status": "string"
          },
          "provisioningState": "string"
        }
      }
    ],
    "zoneRedundant": "bool"
  }
}

Property values

namespaces

Name	Description	Value
type	The resource type For Bicep, set this value in the resource declaration.	'Microsoft.ServiceBus/namespaces'
apiVersion	The resource api version For Bicep, set this value in the resource declaration.	'2021-11-01'
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	SKU of the namespace.	SBSku
identity	Properties to configure User Assigned Identities for Bring your Own Keys	Identity
properties	Properties of the namespace.	SBNamespaceProperties

Identity

Name	Description	Value
type	Type of managed service identity.	'None' 'SystemAssigned' 'SystemAssigned, UserAssigned' 'UserAssigned'
userAssignedIdentities	Properties for User Assigned Identities	object

SBNamespaceProperties

Name	Description	Value
alternateName	Alternate name for namespace	string
disableLocalAuth	This property disables SAS authentication for the Service Bus namespace.	bool
encryption	Properties to configure Encryption	Encryption
privateEndpointConnections	List of private endpoint connections.	PrivateEndpointConnection[]
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[]
requireInfrastructureEncryption	Enable Infrastructure Encryption (Double Encryption)	bool

KeyVaultProperties

Name	Description	Value
identity		UserAssignedIdentityProperties
keyName	Name of the Key from KeyVault	string
keyVaultUri	Uri of KeyVault	string
keyVersion	Version of KeyVault	string

UserAssignedIdentityProperties

Name	Description	Value
userAssignedIdentity	ARM ID of user Identity selected for encryption	string

PrivateEndpointConnection

Name	Description	Value
properties	Properties of the private endpoint connection resource.	PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

Name	Description	Value
privateEndpoint	PrivateEndpoint information.	PrivateEndpoint
privateLinkServiceConnectionState	ConnectionState information.	ConnectionState
provisioningState	Provisioning state of the Private Endpoint Connection.	'Canceled' 'Creating' 'Deleting' 'Failed' 'Succeeded' 'Updating'

PrivateEndpoint

Name	Description	Value
id	The ARM identifier for Private Endpoint.	string

ConnectionState

Name	Description	Value
description	Description of the connection state.	string
status	Status of the connection.	'Approved' 'Disconnected' 'Pending' 'Rejected'

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'
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 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 and 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	This template creates a Service Bus Namespace.
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 queue	This template enables you to deploy a Service Bus Standard namespace and a queue.
Create a Service Bus Namespace and Topic	This template creates a Service Bus Namespace and Topic.
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 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.