Create, view, and manage namespaces

A namespace in Azure Event Grid is a logical container for one or more topics, clients, client groups, topic spaces and permission bindings. It provides a unique namespace, allowing you to have multiple resources in the same Azure region. With an Azure Event Grid namespace you can group now together related resources and manage them as a single unit in your Azure subscription.

This article shows you how to use the Azure portal to create, view and manage an Azure Event Grid namespace.

Create a namespace

  1. Sign-in to the Azure portal.

  2. In the search box, enter Event Grid Namespaces and select Event Grid Namespaces from the results.

    Screenshot showing Event Grid Namespaces in the search results.

  3. On the Event Grid Namespaces page, select + Create on the toolbar.

    Screenshot showing Event Grid Namespaces page with the Create button on the toolbar selected.

  4. On the Basics page, follow these steps.

    1. Select the Azure subscription in which you want to create the namespace.

    2. Select an existing resource group or create a resource group.

    3. Enter a name for the namespace.

    4. Select the region or location where you want to create the namespace.

    5. If the selected region supports availability zones, the Availability zones checkbox can be enabled or disabled. The checkbox is selected by default if the region supports availability zones. However, you can uncheck and disable availability zones if needed. The selection cannot be changed once the namespace is created.

    6. Use the slider or text box to specify the number of throughput units for the namespace. Throughput units (TUs) define the ingress and egress event rate capacity in namespaces.

    7. Select Next: Networking at the bottom of the page.

      Screenshot showing the Basics tab of Create namespace page.

  5. Follow steps from Configure IP firewall or Configure private endpoints to configure IP firewall or private endpoints for the namespace, and then select Next: Security at the bottom of the page.

  6. On the Security page, create a managed identity by following instructions from Enable managed identity for a namespace, and then select Next: Tags at the bottom of the page.

  7. On the Tags tab, add the tags in case you need them. Then, select Next: Review + create at the bottom of the page.

  8. On the Review + create tab, review your settings and select Create.

  9. On the Deployment succeeded page, select Go to resource to navigate to your namespace.

View a namespace

  1. Sign-in to the Azure portal.

  2. In the search box, enter Event Grid Namespaces and select Event Grid Namespaces from the results.

    Screenshot showing Event Grid Namespaces in the search results.

  3. On the Event Grid Namespaces page, select your namespace.

    Screenshot showing selection of a namespace in the Event Grid namespaces list.

  4. You should see the Event Grid Namespace page for your namespace.

    Screenshot that shows the Event Grid Namespace page for your namespace.

Enable MQTT

If you want to enable the MQTT capabilities in the Azure Event Grid namespace, select Configuration and check the option Enable MQTT.

Screenshot showing Event Grid MQTT settings.

Note

Please note once MQTT is enabled it cannot be disabled.

Configure throughput units (TUs) for a namespace

If you already created a namespace and want to increase or decrease TUs, follow the next steps:

  1. Navigate to the Azure portal and select the Azure Event Grid namespace you would like to configure the throughput units.

  2. On the Event Grid Namespace page, select Scale on the left navigation menu.

  3. Enter the number of throughput units in the edit box or use the scroller to increase or decrease the number.

  4. Select Apply to apply the changes.

    Screenshot showing Event Grid scale page.

    Note

    For quotas and limits for resources in a namespace including maximum TUs in a namespace, See Azure Event Grid quotas and limits.

Delete a namespace

  1. Follow instructions from the View a namespace section to view all the namespaces, and select the namespace that you want to delete from the list.

  2. On the Overview page, select Delete on the toolbar.

    Screenshot showing how to delete an Event Grid namespace.

  3. On the confirmation page, type the name of the resource and select Delete to confirm the deletion. It deletes the namespace and also all the nested topics, subscriptions, and MQTT resources.

    Screenshot showing how to confirm an Event Grid namespace deletion.

Next steps