Skip to content

Commit 98d4c91

Browse files
committed
make it compliant with the new arm template guidance
1 parent 7d05202 commit 98d4c91

File tree

2 files changed

+41
-111
lines changed

2 files changed

+41
-111
lines changed

articles/service-bus-messaging/TOC.yml

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -13,22 +13,22 @@
1313
items:
1414
- name: Create a Service Bus queue
1515
items:
16-
- name: Azure portal
17-
href: service-bus-quickstart-portal.md
16+
- name: Azure portal
17+
href: service-bus-quickstart-portal.md
1818
- name: Azure PowerShell
1919
href: service-bus-quickstart-powershell.md
2020
- name: Azure CLI
2121
href: service-bus-quickstart-cli.md
22-
- name: Azure Resource Manager template
22+
- name: ARM template
2323
href: service-bus-resource-manager-namespace-queue.md
2424
- name: Send and receive messages
25-
items:
25+
items:
2626
- name: .NET
2727
href: service-bus-dotnet-get-started-with-queues.md
2828
- name: Java
2929
href: service-bus-java-how-to-use-queues.md
3030
- name: Node.js
31-
href: service-bus-nodejs-how-to-use-queues-new-package.md
31+
href: service-bus-nodejs-how-to-use-queues-new-package.md
3232
- name: PHP
3333
href: service-bus-php-how-to-use-queues.md
3434
- name: Python
@@ -37,14 +37,14 @@
3737
href: service-bus-ruby-how-to-use-queues.md
3838
- name: Services Bus topics and subscriptions
3939
items:
40-
- name: Create topics and subscriptions
40+
- name: Create topics and subscriptions
4141
items:
4242
- name: Azure portal
4343
href: service-bus-quickstart-topics-subscriptions-portal.md
44-
- name: Azure Resource Manager template
44+
- name: ARM template
4545
href: service-bus-resource-manager-namespace-topic.md
4646
- name: Publish and subscribe for messages
47-
items:
47+
items:
4848
- name: .NET
4949
href: service-bus-dotnet-how-to-use-topics-subscriptions.md
5050
- name: Java
@@ -56,7 +56,7 @@
5656
- name: Python
5757
href: service-bus-python-how-to-use-topics-subscriptions.md
5858
- name: Ruby
59-
href: service-bus-ruby-how-to-use-topics-subscriptions.md
59+
href: service-bus-ruby-how-to-use-topics-subscriptions.md
6060
- name: Tutorials
6161
items:
6262
- name: Update inventory - PowerShell
@@ -85,7 +85,7 @@
8585
href: service-bus-outages-disasters.md
8686
- name: Throttling
8787
href: service-bus-throttling.md
88-
- name: Security
88+
- name: Security
8989
items:
9090
- name: Authentication and authorization
9191
href: service-bus-authentication-and-authorization.md
@@ -97,11 +97,11 @@
9797
- name: Authentication with Shared Access Signatures
9898
href: service-bus-sas.md
9999
- name: Use Azure Active Directory
100-
items:
101-
- name: Authenticate with managed identities for Azure resources
100+
items:
101+
- name: Authenticate with managed identities for Azure resources
102102
href: service-bus-managed-service-identity.md
103-
- name: Authenticate from an application
104-
href: authenticate-application.md
103+
- name: Authenticate from an application
104+
href: authenticate-application.md
105105
- name: Built-in security controls
106106
href: service-bus-messaging-security-controls.md
107107
- name: Network security
@@ -111,7 +111,7 @@
111111
- name: Migrate from Azure Service Manager (classic) APIs to Resource Manager APIs
112112
href: deprecate-service-bus-management.md
113113
- name: Create a namespace
114-
href: service-bus-create-namespace-portal.md
114+
href: service-bus-create-namespace-portal.md
115115
- name: Develop
116116
items:
117117
- name: Message handling
@@ -190,7 +190,7 @@
190190
href: service-bus-diagnostic-logs.md
191191
- name: Suspend and reactivate messaging entities
192192
href: entity-suspend.md
193-
- name: Use Azure Resource Manager templates
193+
- name: Use ARM templates
194194
href: service-bus-resource-manager-overview.md
195195
items:
196196
- name: Create a namespace

articles/service-bus-messaging/service-bus-resource-manager-namespace-queue.md

Lines changed: 25 additions & 95 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ ms.assetid: a6bfb5fd-7b98-4588-8aa1-9d5f91b599b6
1111
ms.service: service-bus-messaging
1212
ms.devlang: tbd
1313
ms.topic: quickstart
14+
ms.custom: subject-armqs
1415
ms.tgt_pltfrm: dotnet
1516
ms.workload: na
1617
ms.date: 12/20/2019
@@ -21,23 +22,38 @@ ms.author: spelluru
2122

2223
This article shows how to use an Azure Resource Manager template that creates a Service Bus namespace and a queue within that namespace. The article explains how to specify which resources are deployed and how to define parameters that are specified when the deployment is executed. You can use this template for your own deployments, or customize it to meet your requirements.
2324

24-
For more information about creating templates, please see [Authoring Azure Resource Manager templates][Authoring Azure Resource Manager templates].
25+
[!INCLUDE [About Azure Resource Manager](../../includes/resource-manager-quickstart-introduction.md)]
2526

26-
For the complete template, see the [Service Bus namespace and queue template][Service Bus namespace and queue template] on GitHub.
27+
If you don't have an Azure subscription, [create a free account](https://azure.microsoft.com/free/) before you begin.
28+
29+
## Prerequisites
30+
31+
None
32+
33+
## Create a Service Bus namespace and a queue
34+
35+
### Review the template
36+
37+
The template used in this quickstart is from [Azure Quickstart templates](https://azure.microsoft.com/resources/templates/201-servicebus-create-queue).
38+
39+
:::code language="json" source="~/quickstart-templates/201-servicebus-create-queue/azuredeploy.json" range="1-75" highlight="31-63":::
40+
41+
The resources defined in the template include:
42+
43+
- [**Microsoft.ServiceBus/namespaces**](/azure/templates/microsoft.servicebus/namespaces)
44+
- [**Microsoft.ServiceBus/namespaces/queues**](/azure/templates/microsoft.servicebus/namespaces/queues)
2745

2846
> [!NOTE]
2947
> The following Azure Resource Manager templates are available for download and deployment.
30-
>
48+
>
3149
> * [Create a Service Bus namespace with queue and authorization rule](service-bus-resource-manager-namespace-auth-rule.md)
3250
> * [Create a Service Bus namespace with topic and subscription](service-bus-resource-manager-namespace-topic.md)
3351
> * [Create a Service Bus namespace](service-bus-resource-manager-namespace.md)
3452
> * [Create a Service Bus namespace with topic, subscription, and rule](service-bus-resource-manager-namespace-topic-with-rule.md)
35-
>
36-
> To check for the latest templates, visit the [Azure Quickstart Templates][Azure Quickstart Templates] gallery and search for **Service Bus**.
3753
38-
[!INCLUDE [updated-for-az](../../includes/updated-for-az.md)]
54+
You can find more template from [Azure Quickstart templates](https://azure.microsoft.com/resources/templates/?resourceType=Microsoft.Servicebus&pageNumber=1&sort=Popular)
3955

40-
## What will you deploy?
56+
### Deploy the template
4157

4258
With this template, you deploy a Service Bus namespace with a queue.
4359

@@ -47,95 +63,9 @@ To run the deployment automatically, click the following button:
4763

4864
[![Deploy to Azure](./media/service-bus-resource-manager-namespace-queue/deploybutton.png)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2FAzure%2Fazure-quickstart-templates%2Fmaster%2F201-servicebus-create-queue%2Fazuredeploy.json)
4965

50-
## Parameters
51-
52-
With Azure Resource Manager, you define parameters for values you want to specify when the template is deployed. The template includes a section called `Parameters` that contains all of the parameter values. You should define a parameter for those values that will vary based on the project you are deploying or based on the environment you are deploying to. Do not define parameters for values that will always stay the same. Each parameter value is used in the template to define the resources that are deployed.
53-
54-
The template defines the following parameters.
55-
56-
### serviceBusNamespaceName
57-
The name of the Service Bus namespace to create.
58-
59-
```json
60-
"serviceBusNamespaceName": {
61-
"type": "string",
62-
"metadata": {
63-
"description": "Name of the Service Bus namespace"
64-
}
65-
}
66-
```
67-
68-
### serviceBusQueueName
69-
The name of the queue created in the Service Bus namespace.
70-
71-
```json
72-
"serviceBusQueueName": {
73-
"type": "string"
74-
}
75-
```
76-
77-
### serviceBusApiVersion
78-
The Service Bus API version of the template.
79-
80-
```json
81-
"serviceBusApiVersion": {
82-
"type": "string",
83-
"defaultValue": "2017-04-01",
84-
"metadata": {
85-
"description": "Service Bus ApiVersion used by the template"
86-
}
87-
```
88-
89-
## Resources to deploy
90-
Creates a standard Service Bus namespace of type **Messaging**, with a queue.
91-
92-
```json
93-
{
94-
"resources": [{
95-
"apiVersion": "2017-04-01",
96-
"name": "[parameters('serviceBusNamespaceName')]",
97-
"type": "Microsoft.ServiceBus/namespaces",
98-
"location": "[parameters('location')]",
99-
"sku": {
100-
"name": "Standard"
101-
},
102-
"properties": {},
103-
"resources": [{
104-
"apiVersion": "[variables('sbVersion')]",
105-
"name": "[parameters('serviceBusQueueName')]",
106-
"type": "Queues",
107-
"dependsOn": [
108-
"[concat('Microsoft.ServiceBus/namespaces/', parameters('serviceBusNamespaceName'))]"
109-
],
110-
"properties": {
111-
"path": "[parameters('serviceBusQueueName')]"
112-
}
113-
}]
114-
}]
115-
}
116-
```
117-
118-
For JSON syntax and properties, see [namespaces](/azure/templates/microsoft.servicebus/namespaces) and [queues](/azure/templates/microsoft.servicebus/namespaces/queues).
119-
120-
## Commands to run deployment
121-
[!INCLUDE [app-service-deploy-commands](../../includes/app-service-deploy-commands.md)]
122-
123-
## PowerShell
124-
125-
```powershell
126-
New-AzResourceGroupDeployment -ResourceGroupName \<resource-group-name\> -TemplateFile <https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/201-servicebus-create-queue/azuredeploy.json>
127-
```
128-
129-
## Azure CLI
130-
131-
```azurecli
132-
azure config mode arm
133-
134-
azure group deployment create \<my-resource-group\> \<my-deployment-name\> --template-uri <https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/201-servicebus-create-queue/azuredeploy.json>
135-
```
136-
13766
## Next steps
138-
See the following topic that shows how to create an authorization rule for the namespace/queue:
67+
68+
See the following topic that shows how to create an authorization rule for the namespace/queue:
13969
[Create a Service Bus authorization rule for namespace and queue using an Azure Resource Manager template](service-bus-resource-manager-namespace-auth-rule.md)
14070

14171
Learn how to manage these resources by viewing these articles:

0 commit comments

Comments
 (0)