Skip to content

Commit bfd4455

Browse files
authored
Merge pull request #212533 from spelluru/relayhttpqs0926
updated Relay HTTP quickstart
2 parents b28fde5 + 1f72a23 commit bfd4455

13 files changed

+52
-53
lines changed
15.5 KB
Loading
5.35 KB
Loading
-8.72 KB
Loading
34.3 KB
Loading
79 KB
Loading
74.7 KB
Loading
Lines changed: 8 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,17 @@
11
---
2-
author: clemensv
2+
author: spelluru
33
ms.service: service-bus-relay
44
ms.topic: include
5-
ms.date: 11/09/2018
6-
ms.author: clemensv
5+
ms.date: 09/26/2022
6+
ms.author: spelluru
77
---
88
Ensure that you have already [created a Relay namespace][namespace-how-to].
99

10-
1. Sign in to the [Azure portal](https://portal.azure.com).
11-
2. In the left menu, select **All resources**.
12-
3. Select the namespace where you want to create the hybrid connection. In this case, it is **mynewns**.
13-
4. Under **Relay namespace**, select **Hybrid Connections**.
10+
4. On the left menu, Under **Entities**, select **Hybrid Connections**, and then select **+ Hybrid Connection**.
1411

15-
![Create a hybrid connection](./media/relay-create-hybrid-connection-portal/create-hc-1.png)
16-
17-
5. In the namespace overview window, select **+ Hybrid Connection**
18-
19-
![Select the hybrid connection](./media/relay-create-hybrid-connection-portal/create-hc-2.png)
20-
6. Under **Create Hybrid Connection**, enter a value for the hybrid connection name. Leave the other default values.
12+
:::image type="content" source="./media/relay-create-hybrid-connection-portal/create-hc-1.png" alt-text="Screenshot showing the Hybrid Connections page.":::
13+
6. On the **Create Hybrid Connection** page, enter a name for the hybrid connection, and select **Create**.
2114

22-
![Select New](./media/relay-create-hybrid-connection-portal/create-hc-3.png)
23-
7. Select **Create**.
15+
:::image type="content" source="./media/relay-create-hybrid-connection-portal/create-hc-3.png" alt-text="Screenshot showing the Create Hybrid Connection page.":::
16+
2417

25-
[namespace-how-to]: ../relay-create-namespace-portal.md
Lines changed: 17 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,34 +1,37 @@
11
---
2-
author: clemensv
2+
author: spelluru
33
ms.service: service-bus-relay
44
ms.topic: include
5-
ms.date: 11/09/2018
6-
ms.author: clemensv
5+
ms.date: 09/26/2022
6+
ms.author: spelluru
77
---
88
1. Sign in to the [Azure portal][Azure portal].
9-
1. 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.
10-
1. Select **Create**, and enter a namespace name in the **Name** field. Azure portal checks to see if the name is available.
11-
1. Choose an Azure subscription in which to create the namespace.
12-
1. For [Resource group](../../azure-resource-manager/management/manage-resource-groups-portal.md), choose an existing resource group in which to place the namespace, or create a new one.
13-
1. Select the country or region in which your namespace should be hosted.
9+
1. Select **All services**. Select **Integration**, search for **Relays**, move the mouse over **Relays**, and then click **Create**.
1410

15-
![Create namespace][create-namespace]
11+
:::image type="content" source="./media/relay-create-namespace-portal/select-relay-create.png" alt-text="Screenshot showing the selection of Relays -> Create button.":::
12+
1. On the **Create namespace** page, follow these steps:
13+
1. Choose an Azure subscription in which to create the namespace.
14+
1. For [Resource group](../../azure-resource-manager/management/manage-resource-groups-portal.md), choose an existing resource group in which to place the namespace, or create a new one.
15+
1. Enter a name for the Relay namespace.
16+
1. Select the country or region in which your namespace should be hosted.
17+
1. Select **Review + create** at the bottom of the page.
1618

17-
1. Select **Create**. The Azure portal creates your namespace and enables it. After a few minutes, the system provisions resources for your account.
19+
:::image type="content" source="./media/relay-create-namespace-portal/create-namespace-page.png" alt-text="Screenshot showing the Create namespace page.":::
20+
1. On the **Review + create** page, select **Create**.
21+
1. After a few minutes, the system provisions resources for your account.You'll see the **Relay** page for the namespace.
1822

23+
:::image type="content" source="./media/relay-create-namespace-portal/home-page.png" alt-text="Screenshot showing the home page for Relay namespace.":::
1924
### Get management credentials
2025

21-
1. Select **All resources**, and then choose the newly created namespace name.
22-
1. Select **Shared access policies**.
26+
1. On the **Relay** page, select **Shared access policies**. `
2327
1. Under **Shared access policies**, select **RootManageSharedAccessKey**.
2428
1. 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.
2529
1. Repeat the preceding step to copy and paste the value of **Primary key** to a temporary location for later use.
2630

27-
![connection-string][connection-string]
31+
:::image type="content" source="./media/relay-create-namespace-portal/connection-info.png" alt-text="Screenshot showing the connection info for Relay namespace.":::
2832

2933
<!--Image references-->
3034

31-
[create-namespace]: ./media/relay-create-namespace-portal/create-namespace-vs2019.png
3235
[connection-info]: ./media/relay-create-namespace-portal/connection-info.png
3336
[connection-string]: ./media/relay-create-namespace-portal/connection-string-vs2019.png
3437
[Azure portal]: https://portal.azure.com

articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-client.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
author: clemensv
2+
author: spelluru
33
ms.service: service-bus-relay
44
ms.topic: include
5-
ms.date: 11/09/2018
6-
ms.author: clemensv
5+
ms.date: 09/26/2022
6+
ms.author: spelluru
77
---
88
### Create a console application
99

@@ -26,20 +26,20 @@ In Visual Studio, create a new **Console App (.NET Framework)** project.
2626
using System.Threading.Tasks;
2727
using Microsoft.Azure.Relay;
2828
```
29-
2. Add constants to the `Program` class for the hybrid connection details. Replace the placeholders in brackets with the values that you obtained when you created the hybrid connection. Be sure to use the fully qualified namespace name.
29+
2. Add constants to the `Program` class for the hybrid connection details. Replace the placeholders with the values that you obtained when you created the hybrid connection. Be sure to use the fully qualified namespace name.
3030

3131
```csharp
3232
// replace {RelayNamespace} with the name of your namespace
33-
private const string RelayNamespace = "{RelayNamespace}.servicebus.windows.net";
33+
private const string RelayNamespace = "YOUR-RELAY-NAMESPACE-NAME.servicebus.windows.net";
3434

3535
// replace {HybridConnectionName} with the name of your hybrid connection
36-
private const string ConnectionName = "{HybridConnectionName}";
36+
private const string ConnectionName = "HYBRID-CONNECTION-NAME";
3737

3838
// replace {SAKKeyName} with the name of your Shared Access Policies key, which is RootManageSharedAccessKey by default
39-
private const string KeyName = "{SASKeyName}";
39+
private const string KeyName = "SAS-KEY-NAME";
4040

4141
// replace {SASKey} with the primary key of the namespace you saved earlier
42-
private const string Key = "{SASKey}";
42+
private const string Key = "SAS-KEY-VALUE";
4343
```
4444
3. Add the following method to the `Program` class:
4545

articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-server.md

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
title: include file
33
description: include file
44
services: service-bus-relay
5-
author: clemensv
5+
author: spelluru
66
ms.service: service-bus-relay
77
ms.topic: include
8-
ms.date: 08/16/2018
9-
ms.author: clemensv
8+
ms.date: 09/27/2022
9+
ms.author: spelluru
1010
ms.custom: include file
1111

1212
---
@@ -20,7 +20,6 @@ In Visual Studio, create a new **Console App (.NET Framework)** project.
2020
1. Right-click the newly created project, and then select **Manage NuGet Packages**.
2121
2. Select **Include prerelease** option.
2222
3. Select **Browse**, and then search for **Microsoft.Azure.Relay**. In the search results, select **Microsoft Azure Relay**.
23-
4. For the version, select **2.0.0-preview1-20180523**.
2423
5. Select **Install** to complete the installation. Close the dialog box.
2524

2625
### Write code to receive messages
@@ -35,13 +34,20 @@ In Visual Studio, create a new **Console App (.NET Framework)** project.
3534
using System.Net;
3635
using Microsoft.Azure.Relay;
3736
```
38-
2. Add constants to the `Program` class for the hybrid connection details. Replace the placeholders in brackets with the values that you obtained when you created the hybrid connection. Be sure to use the fully qualified namespace name.
37+
2. Add constants to the `Program` class for the hybrid connection details. Replace the placeholders with the values that you obtained when you created the hybrid connection. Be sure to use the fully qualified namespace name.
3938

4039
```csharp
41-
private const string RelayNamespace = "{RelayNamespace}.servicebus.windows.net";
42-
private const string ConnectionName = "{HybridConnectionName}";
43-
private const string KeyName = "{SASKeyName}";
44-
private const string Key = "{SASKey}";
40+
// replace {RelayNamespace} with the name of your namespace
41+
private const string RelayNamespace = "YOUR-RELAY-NAMESPACE-NAME.servicebus.windows.net";
42+
43+
// replace {HybridConnectionName} with the name of your hybrid connection
44+
private const string ConnectionName = "HYBRID-CONNECTION-NAME";
45+
46+
// replace {SAKKeyName} with the name of your Shared Access Policies key, which is RootManageSharedAccessKey by default
47+
private const string KeyName = "SAS-KEY-NAME";
48+
49+
// replace {SASKey} with the primary key of the namespace you saved earlier
50+
private const string Key = "SAS-KEY-VALUE";
4551
```
4652
3. Add the `ProcessMessagesOnConnection` method to the `Program` class:
4753

0 commit comments

Comments
 (0)