Create a Relay namespace using the Azure portal

A namespace is a common 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. Log on to the Azure portal.
  2. In the left navigation pane of the portal, click New, then click Enterprise Integration, and then click Relay.
  3. In the Create namespace dialog, enter a namespace name. The system immediately checks to see if the name is available.
  4. In the Subscription field, choose an Azure subscription in which to create the namespace.
  5. In the Resource group field, choose an existing resource group in which the namespace will live, or create a new one.
  6. In Location, choose the country or region in which your namespace should be hosted.

    Create namespace

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

Obtain the management credentials

  1. In the list of namespaces, click the newly created namespace name.
  2. In the namespace blade, click Shared access policies.
  3. In the Shared access policies blade, click RootManageSharedAccessKey.


  4. In the Policy: RootManageSharedAccessKey blade, click the copy button next to Connection string–primary key, to copy the connection string to your clipboard for later use. Paste this value into Notepad or some other temporary location.


  5. Repeat the previous step, copying and pasting the value of Primary key to a temporary location for later use.

Congratulations! You have now created a relay namespace.

Next steps: