|
4 | 4 | author: spelluru
|
5 | 5 | ms.service: azure-service-bus
|
6 | 6 | ms.topic: include
|
7 |
| - ms.date: 01/16/2025 |
| 7 | + ms.date: 06/11/2025 |
8 | 8 | ms.author: spelluru
|
9 | 9 | ms.custom: include file
|
10 | 10 | ---
|
11 | 11 |
|
12 | 12 | ## Create a namespace in the Azure portal
|
13 |
| -To begin using Service Bus messaging entities in Azure, you must first create a namespace with a name that is unique across Azure. A namespace provides a scoping container for Service Bus resources (queues, topics, etc.) within your application. |
| 13 | + |
| 14 | +To begin using Service Bus messaging entities in Azure, create a namespace with a name that is unique across Azure. A namespace provides a scoping container for Service Bus resources, such as queues and topics, in your application. |
14 | 15 |
|
15 | 16 | To create a namespace:
|
16 | 17 |
|
17 | 18 | 1. Sign in to the [Azure portal](https://portal.azure.com).
|
18 |
| -2. Navigate to the [**All services** page](https://portal.azure.com/#allservices/category/All). |
19 |
| -3. On the left navigation bar, select **Integration** from the list of categories, hover the mouse over **Service Bus**, and then select **+** button on the Service Bus tile. |
| 19 | +1. Select the flyout menu from the top left and navigate to the [**All services** page](https://portal.azure.com/#allservices/category/All). |
| 20 | +1. On the left navigation bar, select **Integration**. |
| 21 | +1. Scroll down to **Messaging services** > **Service Bus** and select **Create**. |
| 22 | + |
| 23 | + :::image type="content" source="./media/service-bus-create-namespace-portal/create-resource-service-bus-menu.png" alt-text="Screenshot showing selection of Create a resource, Integration, and then Service Bus in the menu." lightbox="./media/service-bus-create-namespace-portal/create-resource-service-bus-menu.png"::: |
| 24 | + |
| 25 | +1. In the **Basics** tab of the **Create namespace** page, follow these steps: |
| 26 | + |
| 27 | + 1. For **Subscription**, choose an Azure subscription in which to create the namespace. |
| 28 | + 1. For **Resource group**, choose an existing resource group, or create a new one. |
| 29 | + 1. Enter a **Namespace name** that meets the following naming conventions: |
| 30 | + |
| 31 | + - The name must be unique across Azure. The system immediately checks to see if the name is available. |
| 32 | + - The name length is at least 6 and at most 50 characters. |
| 33 | + - The name can contain only letters, numbers, hyphens `-`. |
| 34 | + - The name must start with a letter and end with a letter or number. |
| 35 | + - The name doesn't end with `-sb` or `-mgmt`. |
| 36 | + |
| 37 | + 1. For **Location**, choose the region to host your namespace. |
| 38 | + 1. For **Pricing tier**, select the pricing tier (Basic, Standard, or Premium) for the namespace. For this quickstart, select **Standard**. |
20 | 39 |
|
21 |
| - :::image type="content" source="./media/service-bus-create-namespace-portal/create-resource-service-bus-menu.png" alt-text="Image showing selection of Create a resource, Integration, and then Service Bus in the menu." lightbox="./media/service-bus-create-namespace-portal/create-resource-service-bus-menu.png"::: |
22 |
| -4. In the **Basics** tag of the **Create namespace** page, follow these steps: |
23 |
| - 1. For **Subscription**, choose an Azure subscription in which to create the namespace. |
24 |
| - 1. For **Resource group**, choose an existing resource group, or create a new one. |
25 |
| - 1. Enter a **name for the namespace**. The namespace name should adhere to the following naming conventions: |
26 |
| - - The name must be unique across Azure. The system immediately checks to see if the name is available. |
27 |
| - - The name length is at least 6 and at most 50 characters. |
28 |
| - - The name can contain only letters, numbers, hyphens `-`. |
29 |
| - - The name must start with a letter and end with a letter or number. |
30 |
| - - The name doesn't end with `-sb` or `-mgmt`. |
31 |
| - 1. For **Location**, choose the region in which your namespace should be hosted. |
32 |
| - 1. For **Pricing tier**, select the pricing tier (Basic, Standard, or Premium) for the namespace. For this quickstart, select **Standard**. |
33 |
| - 1. If you select **Premium** tier, select whether you can enable **geo-replication** for the namespace. The Geo-Replication feature ensures that the metadata and data of a namespace are continuously replicated from a primary region to one or more secondary regions. |
| 40 | + If you select **Premium** tier, you can enable **geo-replication** for the namespace. The geo-replication feature ensures that the metadata and data of a namespace are continuously replicated from a primary region to one or more secondary regions. |
34 | 41 |
|
35 |
| - > [!IMPORTANT] |
36 |
| - > If you want to use [topics and subscriptions](../service-bus-queues-topics-subscriptions.md#topics-and-subscriptions), choose either Standard or Premium. Topics/subscriptions aren't supported in the Basic pricing tier. |
| 42 | + > [!IMPORTANT] |
| 43 | + > If you want to use [topics and subscriptions](../service-bus-queues-topics-subscriptions.md#topics-and-subscriptions), choose either Standard or Premium. Topics and subscriptions aren't supported in the Basic pricing tier. |
| 44 | +
|
| 45 | + If you selected the **Premium** pricing tier, specify the number of **messaging units**. The premium tier provides resource isolation at the CPU and memory level so that each workload runs in isolation. This resource container is called a *messaging unit*. A premium namespace has at least one messaging unit. You can select 1, 2, 4, 8 or 16 messaging units for each Service Bus Premium namespace. For more information, see [Service Bus premium messaging tier](../service-bus-premium-messaging.md). |
37 | 46 |
|
38 |
| - If you selected the **Premium** pricing tier, specify the number of **messaging units**. The premium tier provides resource isolation at the CPU and memory level so that each workload runs in isolation. This resource container is called a messaging unit. A premium namespace has at least one messaging unit. You can select 1, 2, 4, 8 or 16 messaging units for each Service Bus Premium namespace. For more information, see [Service Bus Premium Messaging](../service-bus-premium-messaging.md). |
39 |
| - 1. Select **Review + create** at the bottom of the page. |
| 47 | + 1. Select **Review + create** at the bottom of the page. |
40 | 48 |
|
41 |
| - :::image type="content" source="./media/service-bus-create-namespace-portal/create-namespace.png" alt-text="Image showing the Create a namespace page"::: |
42 |
| - 1. On the **Review + create** page, review settings, and select **Create**. |
43 |
| -5. Once the deployment of the resource is successful, select **Go to resource** on the deployment page. |
| 49 | + :::image type="content" source="./media/service-bus-create-namespace-portal/create-namespace.png" alt-text="Screenshot showing the Create a namespace page"::: |
| 50 | + |
| 51 | + 1. On the **Review + create** page, review settings, and select **Create**. |
| 52 | + |
| 53 | +1. After the deployment of the resource is successful, select **Go to resource** on the deployment page. |
| 54 | + |
| 55 | + :::image type="content" source="./media/service-bus-create-namespace-portal/deployment-alert.png" alt-text="Screenshot showing the deployment succeeded page with the Go to resource link."::: |
44 | 56 |
|
45 |
| - :::image type="content" source="./media/service-bus-create-namespace-portal/deployment-alert.png" alt-text="Image showing the deployment succeeded page with the Go to resource link."::: |
46 |
| -6. You see the home page for your service bus namespace. |
| 57 | +1. You see the home page for your service bus namespace. |
47 | 58 |
|
48 |
| - :::image type="content" source="./media/service-bus-create-namespace-portal/service-bus-namespace-home-page.png" lightbox="./media/service-bus-create-namespace-portal/service-bus-namespace-home-page.png" alt-text="Image showing the home page of the Service Bus namespace created." ::: |
| 59 | + :::image type="content" source="./media/service-bus-create-namespace-portal/service-bus-namespace-home-page.png" lightbox="./media/service-bus-create-namespace-portal/service-bus-namespace-home-page.png" alt-text="Screenshot showing the home page of the Service Bus namespace created." ::: |
49 | 60 |
|
0 commit comments