Skip to content

Commit 666e256

Browse files
authored
Merge pull request #313024 from duongau/expressroute-freshness-review-560387
Expressroute freshness review - batch 1
2 parents bbca6fa + 74aa7a2 commit 666e256

7 files changed

Lines changed: 172 additions & 207 deletions

articles/expressroute/circuit-placement-api.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ services: expressroute
55
author: mialdrid
66
ms.service: azure-expressroute
77
ms.topic: concept-article
8-
ms.date: 10/19/2021
8+
ms.date: 03/11/2026
99
ms.author: duau
1010
# Customer intent: As an ExpressRoute partner, I want to utilize the CrossConnections circuit placement API to select and manage port pairs for circuit connectivity, so that I can optimize and enhance the performance of the ExpressRoute circuits I provision.
1111
---
@@ -57,7 +57,7 @@ The ExpressRoute partner can list all port pairs within the target provider subs
5757
https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/expressRouteProviderPorts?api-version={api-version}
5858
{
5959
"parameters": {
60-
"api-version": "2021-12-01",
60+
"api-version": "2025-05-01",
6161
"subscriptionId": "subid"
6262
},
6363
"responses": {
@@ -83,7 +83,7 @@ https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.
8383
},
8484
{
8585
"portPairDescriptor": "bvtazureixpportpair2",
86-
"id": "/subscriptions/subid/providers/Microsoft.Network/ ExpressRouteProviderPort/bvtazureixpportpair2",
86+
"id": "/subscriptions/subid/providers/Microsoft.Network/expressRouteProviderPorts/bvtazureixpportpair2",
8787
"type": "Microsoft.Network/expressRouteProviderPort",
8888
"location": "uswest",
8989
"etag": "W/\"c0e6477e-8150-4d4f-9bf6-bb10e6acb63a\"",
@@ -118,7 +118,7 @@ https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.
118118
https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/expressRouteProviderPorts?location={locationName}&api-version={api-version}
119119
{
120120
"parameters": {
121-
"api-version": "2021-12-01",
121+
"api-version": "2025-05-01",
122122
"locationName": "SiliconValley",
123123
"subscriptionId": "subid"
124124
},
@@ -128,7 +128,7 @@ https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.
128128
"value": [
129129
{
130130
"portPairDescriptor": "bvtazureixpportpair1",
131-
"id": "/subscriptions/subid/providers/Microsoft.Network/ ExpressRouteProviderPort /bvtazureixpportpair1",
131+
"id": "/subscriptions/subid/providers/Microsoft.Network/expressRouteProviderPorts/bvtazureixpportpair1",
132132
"type": "Microsoft.Network/expressRouteProviderPort",
133133
"location": "uswest",
134134
"etag": "W/\"c0e6477e-8150-4d4f-9bf6-bb10e6acb63a\"",
@@ -162,8 +162,8 @@ https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.
162162
163163
{
164164
"parameters": {
165-
"api-version": "2021-12-01",
166-
"portPairDescriptor": " bvtazureixpportpair1",
165+
"api-version": "2025-05-01",
166+
"portPairDescriptor": "bvtazureixpportpair1",
167167
"subscriptionId": "subid"
168168
},
169169
"responses": {
@@ -212,15 +212,15 @@ Currently the primaryAzurePort and secondaryAzurePort are read-only properties.
212212
https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCrossConnections/{crossConnectionName}?api-version={api-version}
213213
{
214214
"parameters": {
215-
"api-version": "2021-12-01",
215+
"api-version": "2025-05-01",
216216
"crossConnectionName": "The name of the cross connection",
217217
"subscriptionId": "subid"
218218
}
219219
},
220220
{
221221
Request "body": {
222-
" primaryAzurePort ": " bvtazureixp03a"
223-
"secondaryAzurePort": "bvtazureixp03b",
222+
"primaryAzurePort": "bvtazureixp03a",
223+
"secondaryAzurePort": "bvtazureixp03b"
224224
}
225225
}
226226
Response:

articles/expressroute/cross-network-connectivity.md

Lines changed: 26 additions & 37 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: This page describes an application scenario for cross network conne
44
author: duongau
55
ms.service: azure-expressroute
66
ms.topic: concept-article
7-
ms.date: 06/30/2023
7+
ms.date: 03/11/2026
88
ms.author: duau
99
ms.custom: sfi-image-nochange
1010
# Customer intent: As a network administrator, I want to interconnect the networks of acquired companies using Azure networking features, so that I can ensure seamless communication between on-premises and cloud resources post-merger.
@@ -16,7 +16,7 @@ Fabrikam Inc. has a large physical presence and Azure deployment in East US. Fab
1616

1717
Fabrikam Inc. acquires Contoso Ltd. Following the merger, Fabrikam wants to interconnect the networks. The following figure illustrates the scenario:
1818

19-
![The Application scenario](./media/cross-network-connectivity/premergerscenario.png)
19+
:::image type="content" source="./media/cross-network-connectivity/premergerscenario.png" alt-text="Diagram of the pre-merger network scenario for Fabrikam and Contoso.":::
2020

2121
The dashed arrows in the middle of the figure above indicate the desired network interconnections. Specifically, there are three types cross connections desired:
2222

@@ -26,104 +26,93 @@ The dashed arrows in the middle of the figure above indicate the desired network
2626

2727
The following table shows the route table of the private peering of the ExpressRoute of Contoso Ltd., before the merger.
2828

29-
![Contoso ExpressRoute route table before merger](./media/cross-network-connectivity/contosoexr-rt-premerger.png)
29+
:::image type="content" source="./media/cross-network-connectivity/contosoexr-rt-premerger.png" alt-text="Screenshot of Contoso ExpressRoute route table before the merger.":::
3030

3131
The following table shows the effective routes of a VM in the Contoso subscription, before the merger. Per the table, the VM on the VNet is aware of the VNet address space and the Contoso on-premises network, apart from the default ones.
3232

33-
![Contoso VM routes before merger](./media/cross-network-connectivity/contosovm-routes-premerger.png)
33+
:::image type="content" source="./media/cross-network-connectivity/contosovm-routes-premerger.png" alt-text="Screenshot of Contoso VM effective routes before the merger.":::
3434

3535
The following table shows the route table of the private peering of the ExpressRoute of Fabrikam Inc., before the merger.
3636

37-
![Fabrikam ExpressRoute route table before merger](./media/cross-network-connectivity/fabrikamexr-rt-premerger.png)
37+
:::image type="content" source="./media/cross-network-connectivity/fabrikamexr-rt-premerger.png" alt-text="Screenshot of Fabrikam ExpressRoute route table before the merger.":::
3838

3939
The following table shows the effective routes of a VM in the Fabrikam subscription, before the merger. Per the table, the VM on the VNet is aware of the VNet address space and the Fabrikam on-premises network, apart from the default ones.
4040

41-
![Fabrikam VM routes before merger](./media/cross-network-connectivity/fabrikamvm-routes-premerger.png)
41+
:::image type="content" source="./media/cross-network-connectivity/fabrikamvm-routes-premerger.png" alt-text="Screenshot of Fabrikam VM effective routes before the merger.":::
4242

4343
In this article, let's go through step by step and discuss how to achieve the desired cross connections using the following Azure network features:
4444

45-
* [Virtual network peering][Virtual network peering]
46-
* [Virtual network ExpressRoute connection][connection]
47-
* [Global Reach][Global Reach]
45+
* [Virtual network peering](../virtual-network/virtual-network-peering-overview.md)
46+
* [Virtual network ExpressRoute connection](./expressroute-howto-linkvnet-portal-resource-manager.md)
47+
* [Global Reach](./expressroute-global-reach.md)
4848

4949
## Cross connecting VNets
5050

5151
Virtual network peering (VNet peering) provides the most optimal and the best network performance when connecting two virtual networks. VNet peering supports peering two VNets both within the same Azure region (commonly called VNet peering) and in two different Azure regions (commonly called Global VNet peering).
5252

53-
Let's configure Global VNet peering between the VNets in Contoso and Fabrikam Azure subscriptions. For how to create the virtual network peering between two virtual networks, see [Create a virtual network peering][Configure VNet peering] article.
53+
Let's configure Global VNet peering between the VNets in Contoso and Fabrikam Azure subscriptions. For how to create the virtual network peering between two virtual networks, see [Create a virtual network peering](../virtual-network/create-peering-different-subscriptions.md) article.
5454

5555
The following picture shows the network architecture after configuring Global VNet peering.
5656

57-
![The Architecture after VNet-peering](./media/cross-network-connectivity/vnet-peering.png)
57+
:::image type="content" source="./media/cross-network-connectivity/vnet-peering.png" alt-text="Diagram of network architecture after configuring Global VNet peering.":::
5858

5959
The following table shows the routes known to the Contoso subscription VM. Pay attention to the last entry of the table. This entry is the result of cross connecting the virtual networks.
6060

61-
![Contoso VM routes after VNet peering](./media/cross-network-connectivity/contosovm-routes-peering.png)
61+
:::image type="content" source="./media/cross-network-connectivity/contosovm-routes-peering.png" alt-text="Screenshot of Contoso VM routes after VNet peering.":::
6262

6363
The following table shows the routes known to the Fabrikam subscription VM. Pay attention to the last entry of the table. This entry is the result of cross connecting the virtual networks.
6464

65-
![Fabrikam VM routes after VNet peering](./media/cross-network-connectivity/fabrikamvm-routes-peering.png)
65+
:::image type="content" source="./media/cross-network-connectivity/fabrikamvm-routes-peering.png" alt-text="Screenshot of Fabrikam VM routes after VNet peering.":::
6666

6767
VNet peering directly links two virtual networks (see there are no next hop for *VNetGlobalPeering* entry in the two tables)
6868

6969
## Cross connecting VNets to the on-premises networks
7070

71-
We can connect an ExpressRoute circuit to multiple virtual networks. See [Subscription and service limits][Subscription limits] for the maximum number of virtual networks that can be connected to an ExpressRoute circuit.
71+
We can connect an ExpressRoute circuit to multiple virtual networks. See [Subscription and service limits](../azure-resource-manager/management/azure-subscription-service-limits.md#azure-networking-limits) for the maximum number of virtual networks that can be connected to an ExpressRoute circuit.
7272

73-
Let's connect Fabrikam ExpressRoute circuit to Contoso subscription VNet and similarly Contoso ExpressRoute circuit to Fabrikam subscription VNet to enable cross connectivity between virtual networks and the on-premises networks. To connect a virtual network to an ExpressRoute circuit in a different subscription, we need to create and use an authorization. See the article: [Connect a virtual network to an ExpressRoute circuit][Connect-ER-VNet].
73+
Let's connect Fabrikam ExpressRoute circuit to Contoso subscription VNet and similarly Contoso ExpressRoute circuit to Fabrikam subscription VNet to enable cross connectivity between virtual networks and the on-premises networks. To connect a virtual network to an ExpressRoute circuit in a different subscription, we need to create and use an authorization. See the article: [Connect a virtual network to an ExpressRoute circuit](./expressroute-howto-linkvnet-portal-resource-manager.md).
7474

7575
The following picture shows the network architecture after configuring the ExpressRoute cross connectivity to the virtual networks.
7676

77-
![The Architecture after ExpressRoutes cross connection](./media/cross-network-connectivity/exr-x-connect.png)
77+
:::image type="content" source="./media/cross-network-connectivity/exr-x-connect.png" alt-text="Diagram of network architecture after configuring ExpressRoute cross-connectivity.":::
7878

7979
The following table shows the route table of the private peering of the ExpressRoute of Contoso Ltd., after cross connecting virtual networks to the on-premises networks via ExpressRoute. See that the route table has routes belonging to both the virtual networks.
8080

81-
![Contoso ExpressRoute route table after cross connecting ExR and VNets](./media/cross-network-connectivity/contosoexr-rt-xconnect.png)
81+
:::image type="content" source="./media/cross-network-connectivity/contosoexr-rt-xconnect.png" alt-text="Screenshot of Contoso ExpressRoute route table after cross-connecting circuits and VNets.":::
8282

8383
The following table shows the route table of the private peering of the ExpressRoute of Fabrikam Inc., after cross connecting virtual networks to the on-premises networks via ExpressRoute. See that the route table has routes belonging to both the virtual networks.
8484

85-
![Fabrikam ExpressRoute route table after cross connecting ExR and VNets](./media/cross-network-connectivity/fabrikamexr-rt-xconnect.png)
85+
:::image type="content" source="./media/cross-network-connectivity/fabrikamexr-rt-xconnect.png" alt-text="Screenshot of Fabrikam ExpressRoute route table after cross-connecting circuits and VNets.":::
8686

8787
The following table shows the routes known to the Contoso subscription VM. Pay attention to *Virtual network gateway* entries of the table. The VM sees routes for both the on-premises networks.
8888

89-
![Contoso VM routes after cross connecting ExR and VNets](./media/cross-network-connectivity/contosovm-routes-xconnect.png)
89+
:::image type="content" source="./media/cross-network-connectivity/contosovm-routes-xconnect.png" alt-text="Screenshot of Contoso VM routes after cross-connecting circuits and VNets.":::
9090

9191
The following table shows the routes known to the Fabrikam subscription VM. Pay attention to *Virtual network gateway* entries of the table. The VM sees routes for both the on-premises networks.
9292

93-
![Fabrikam VM routes after cross connecting ExR and VNets](./media/cross-network-connectivity/fabrikamvm-routes-xconnect.png)
93+
:::image type="content" source="./media/cross-network-connectivity/fabrikamvm-routes-xconnect.png" alt-text="Screenshot of Fabrikam VM routes after cross-connecting circuits and VNets.":::
9494

9595
> [!NOTE]
9696
> In either the Fabrikam and/or Contoso subscriptions you can also have spoke VNets to the respective hub VNet (a hub and spoke design is not illustrated in the architecture diagrams in this article). The cross connections between the hub VNet gateways to ExpressRoute will also allow communication between East and West hubs and spokes.
9797
9898
## Cross connecting on-premises networks
9999

100-
ExpressRoute Global Reach provides connectivity between on-premises networks that are connected to different ExpressRoute circuits. Let's configure Global Reach between Contoso and Fabrikam ExpressRoute circuits. Because the ExpressRoute circuits are in different subscriptions, we need to create and use an authorization. See [Configure ExpressRoute Global Reach][Configure Global Reach] article for step by step guidance.
100+
ExpressRoute Global Reach provides connectivity between on-premises networks that are connected to different ExpressRoute circuits. Let's configure Global Reach between Contoso and Fabrikam ExpressRoute circuits. Because the ExpressRoute circuits are in different subscriptions, we need to create and use an authorization. See [Configure ExpressRoute Global Reach](./expressroute-howto-set-global-reach.md) article for step by step guidance.
101101

102102
The following picture shows the network architecture after configuring Global Reach.
103103

104-
![The Architecture after configuring Global Reach](./media/cross-network-connectivity/globalreach.png)
104+
:::image type="content" source="./media/cross-network-connectivity/globalreach.png" alt-text="Diagram of network architecture after configuring ExpressRoute Global Reach.":::
105105

106106
The following table shows the route table of the private peering of the ExpressRoute of Contoso Ltd., after configuring Global Reach. See that the route table has routes belonging to both the on-premises networks.
107107

108-
![Contoso ExpressRoute route table after Global Reach](./media/cross-network-connectivity/contosoexr-rt-gr.png)
108+
:::image type="content" source="./media/cross-network-connectivity/contosoexr-rt-gr.png" alt-text="Screenshot of Contoso ExpressRoute route table after configuring Global Reach.":::
109109

110110
The following table shows the route table of the private peering of the ExpressRoute of Fabrikam Inc., after configuring Global Reach. See that the route table has routes belonging to both the on-premises networks.
111111

112-
![Fabrikam ExpressRoute route table after Global Reach](./media/cross-network-connectivity/fabrikamexr-rt-gr.png)
112+
:::image type="content" source="./media/cross-network-connectivity/fabrikamexr-rt-gr.png" alt-text="Screenshot of Fabrikam ExpressRoute route table after configuring Global Reach.":::
113113

114114
## Next steps
115115

116-
See [virtual network FAQ][VNet-FAQ], for any further questions on VNet and VNet-peering. See [ExpressRoute FAQ][ER-FAQ] for any further questions on ExpressRoute and virtual network connectivity.
116+
See [virtual network FAQ](../virtual-network/virtual-networks-faq.md), for any further questions on VNet and VNet-peering. See [ExpressRoute FAQ](./expressroute-faqs.md) for any further questions on ExpressRoute and virtual network connectivity.
117117

118-
Global Reach is rolled out on a country/region by country/region basis. To see if Global Reach is available in the countries/regions that you want, see [ExpressRoute Global Reach][Global Reach].
119-
120-
<!--Link References-->
121-
[Virtual network peering]: ../virtual-network/virtual-network-peering-overview.md
122-
[connection]: ./expressroute-howto-linkvnet-portal-resource-manager.md
123-
[Global Reach]: ./expressroute-global-reach.md
124-
[Configure VNet peering]: ../virtual-network/create-peering-different-subscriptions.md
125-
[Configure Global Reach]: ./expressroute-howto-set-global-reach.md
126-
[Subscription limits]: ../azure-resource-manager/management/azure-subscription-service-limits.md#azure-networking-limits
127-
[Connect-ER-VNet]: ./expressroute-howto-linkvnet-portal-resource-manager.md
128-
[ER-FAQ]: ./expressroute-faqs.md
129-
[VNet-FAQ]: ../virtual-network/virtual-networks-faq.md
118+
Global Reach is rolled out on a country/region by country/region basis. To see if Global Reach is available in the countries/regions that you want, see [ExpressRoute Global Reach](./expressroute-global-reach.md).

0 commit comments

Comments
 (0)