Snabb start: skapa ett Service Bus-namnområde med ämnet och prenumerationen med hjälp av en Azure Resource Manager mallQuickstart: Create a Service Bus namespace with topic and subscription using an Azure Resource Manager template

Den här artikeln visar hur du använder en Azure Resource Manager-mall som skapar ett Service Bus-namnområde och ett ämne och en prenumeration inom det namn området.This article shows how to use an Azure Resource Manager template that creates a Service Bus namespace and a topic and subscription within that namespace. Artikeln förklarar hur du anger vilka resurser som distribueras och hur du definierar parametrar som anges när distributionen körs.The article explains how to specify which resources are deployed and how to define parameters that are specified when the deployment is executed. Du kan använda den här mallen för dina egna distributioner eller anpassa den så att den uppfyller dina kravYou can use this template for your own deployments, or customize it to meet your requirements

Mer information om att skapa mallar finns i Redigera Azure Resource Manager-mallar.For more information about creating templates, see Authoring Azure Resource Manager templates.

En fullständig mall finns i avsnittet Service Bus namnrymd med ämne och prenumerations mall.For the complete template, see the Service Bus namespace with topic and subscription template.

Anteckning

Följande Azure Resource Manager mallar är tillgängliga för hämtning och distribution.The following Azure Resource Manager templates are available for download and deployment.

Om du vill söka efter de senaste mallarna går du till galleriet för Azure snabb starts mallar och söker efter Service Bus.To check for the latest templates, visit the Azure Quickstart Templates gallery and search for Service Bus.

Vad distribuerar du?What do you deploy?

Med den här mallen distribuerar du ett Service Bus-namnområde med ämne och prenumeration.With this template, you deploy a Service Bus namespace with topic and subscription.

Service Bus ämnen och prenumerationer ger en en-till-många-form av kommunikation i ett mönster för publicering/prenumeration .Service Bus topics and subscriptions provide a one-to-many form of communication, in a publish/subscribe pattern.

Klicka på följande knapp för att köra distributionen automatiskt:To run the deployment automatically, click the following button:

Distribuera till AzureDeploy to Azure

ParametrarParameters

Med Azure Resource Manager kan du definiera parametrar för värden som du vill ange när mallen distribueras.With Azure Resource Manager, you define parameters for values you want to specify when the template is deployed. Mallen innehåller ett avsnitt som kallas Parameters som innehåller alla parameter värden.The template includes a section called Parameters that contains all of the parameter values. Definiera en parameter för de värden som varierar beroende på vilket projekt du distribuerar eller baserat på den miljö som du distribuerar till.Define a parameter for those values that vary based on the project you're deploying or based on the environment you're deploying to. Definiera inte parametrar för värden som aldrig ändras.Do not define parameters for values that always stay the same. Varje parametervärde används i mallen för att definiera de resurser som distribueras.Each parameter value is used in the template to define the resources that are deployed.

Mallen definierar följande parametrar:The template defines the following parameters:

serviceBusNamespaceNameserviceBusNamespaceName

Namnet på Service Bus namn området som ska skapas.The name of the Service Bus namespace to create.

"serviceBusNamespaceName": {
"type": "string"
}

serviceBusTopicNameserviceBusTopicName

Namnet på ämnet som skapats i Service Bus namn området.The name of the topic created in the Service Bus namespace.

"serviceBusTopicName": {
"type": "string"
}

serviceBusSubscriptionNameserviceBusSubscriptionName

Namnet på prenumerationen som skapades i Service Bus namn området.The name of the subscription created in the Service Bus namespace.

"serviceBusSubscriptionName": {
"type": "string"
}

serviceBusApiVersionserviceBusApiVersion

Mallens Service Bus-API-version.The Service Bus API version of the template.

"serviceBusApiVersion": { 
       "type": "string", 
       "defaultValue": "2017-04-01", 
       "metadata": { 
           "description": "Service Bus ApiVersion used by the template" 
       }

Resurser som ska distribuerasResources to deploy

Skapar ett standard Service Bus-namnområde av typ meddelanden, med ämnet och prenumerationen.Creates a standard Service Bus namespace of type Messaging, with topic and subscription.

"resources": [{
        "apiVersion": "[variables('sbVersion')]",
        "name": "[parameters('serviceBusNamespaceName')]",
        "type": "Microsoft.ServiceBus/Namespaces",
        "location": "[variables('location')]",
        "kind": "Messaging",
        "sku": {
            "name": "Standard",
        },
        "resources": [{
            "apiVersion": "[variables('sbVersion')]",
            "name": "[parameters('serviceBusTopicName')]",
            "type": "Topics",
            "dependsOn": [
                "[concat('Microsoft.ServiceBus/namespaces/', parameters('serviceBusNamespaceName'))]"
            ],
            "properties": {
                "path": "[parameters('serviceBusTopicName')]",
            },
            "resources": [{
                "apiVersion": "[variables('sbVersion')]",
                "name": "[parameters('serviceBusSubscriptionName')]",
                "type": "Subscriptions",
                "dependsOn": [
                    "[parameters('serviceBusTopicName')]"
                ],
                "properties": {}
            }]
        }]
    }]

Information om JSON-syntax och egenskaper finns i namn områden, ämnenoch prenumerationer.For JSON syntax and properties, see namespaces, topics, and subscriptions.

Kommandon för att köra distributionenCommands to run deployment

Om du vill distribuera resurserna till Azure måste du vara inloggad på ditt Azure-konto och använda Azure Resource Manager-modulen.To deploy the resources to Azure, you must be signed in to your Azure account and you must use the Azure Resource Manager module. Information om hur du använder Azure Resource Manager med Azure PowerShell eller Azure CLI hittar du här:To learn about using Azure Resource Manager with either Azure PowerShell or Azure CLI, see:

Följande exempel förutsätter att du redan har en resursgrupp i ditt konto med det angivna namnet.The following examples assume you already have a resource group in your account with the specified name.

PowerShellPowerShell

New-AzureResourceGroupDeployment -Name \<deployment-name\> -ResourceGroupName \<resource-group-name\> -TemplateUri <https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/201-servicebus-create-topic-and-subscription/azuredeploy.json>

Azure CLIAzure CLI

az deployment group create \<my-resource-group\> --name \<my-deployment-name\> --template-uri <https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/201-servicebus-create-topic-and-subscription/azuredeploy.json>

Nästa stegNext steps

Nu när du har skapat och distribuerat resurser med Azure Resource Manager kan du läsa mer om hur du hanterar resurserna genom att läsa följande artiklar:Now that you've created and deployed resources using Azure Resource Manager, learn how to manage these resources by viewing these articles: