Create a Relay namespace using the Azure portal

A namespace is a scoping container for all your Azure Relay components. Multiple relays can reside in a single namespace, and namespaces often serve as application containers. There are currently two different ways to create a relay namespace:

  1. Azure portal (this article).
  2. Azure Resource Manager templates.

Create a namespace in the Azure portal

  1. Sign in to the Azure portal.

  2. Select Create a resource. Then, select Integration > Relay. If you don't see Relay in the list, select See All in the top-right corner.

  3. Select Create, and enter a namespace name in the Name field. Azure portal checks to see if the name is available.

  4. Choose an Azure subscription in which to create the namespace.

  5. For Resource group, choose an existing resource group in which to place the namespace, or create a new one.

  6. Select the country or region in which your namespace should be hosted.

    Create namespace

  7. Select Create. The Azure portal creates your namespace and enables it. After a few minutes, the system provisions resources for your account.

Get management credentials

  1. Select All resources, and then choose the newly created namespace name.

  2. Select Shared access policies.

  3. Under Shared access policies, select RootManageSharedAccessKey.

  4. Under SAS Policy: RootManageSharedAccessKey, select the Copy button next to Primary Connection String. This action copies the connection string to your clipboard for later use. Paste this value into Notepad or some other temporary location.

  5. Repeat the preceding step to copy and paste the value of Primary key to a temporary location for later use.


Congratulations! You have now created a relay namespace.

Next steps