Edit

Deploy ExpressRoute connection from the service catalog into a workload

Use the ExpressRoute connection template to connect a transit hub ExpressRoute gateway to a customer-owned ExpressRoute circuit. This template creates the connection object that links the service catalog deployment to your existing circuit.

In this article, you:

  • Deploy the ExpressRoute connection service catalog template into an existing workload from the Azure portal.

Note

This article covers the service catalog deployment flow only. You still need a provisioned ExpressRoute circuit with AzurePrivatePeering configured before the connection can become active.

Before you begin

Prerequisites

  1. An active ExpressRoute circuit provisioned through a carrier.
  2. AzurePrivatePeering configured on the circuit.
  3. If the circuit is in another subscription, an authorization key from the circuit owner.
  4. The circuit SKU supports the transit hub region:
    • Standard is the minimum recommended SKU.
    • Local only works when the transit hub is in the same metro.
    • Premium is required for cross-geo connectivity.

Use these Azure PowerShell commands to confirm the circuit is ready:

$circuit = Get-AzExpressRouteCircuit -ResourceGroupName "<circuit-rg>" -Name "<circuit-name>"
$circuit | Select-Object Name, SkuTier, CircuitProvisioningState, ServiceProviderProvisioningState, PeeringLocation | Format-Table
$circuit.Peerings | Select-Object Name, State, PeeringType | Format-Table

If AzurePrivatePeering is missing, your network team must add it before deployment.

Deploy the template

  1. Go to the workload for the intended deployment.

  2. Select + Add an Azure Service.

  3. Select ExpressRoute Connection from the service catalog list, confirm the version you need (default: latest), and then select Next.

    Screenshot showing the ExpressRoute connection template selected from the service catalog list.

  4. Enter the required values on each tab.

  5. Review any prepopulated values and adjust them as needed.

  6. Select Review + Create. If validation passes, select Create.

Validate the deployment

Go to the target resource group and confirm that the ExpressRoute connection is created.

You can also verify the connection by using Azure PowerShell.

Get-AzResource -ResourceGroupName "<hosted-resources-rg>" -ResourceType "Microsoft.Network/expressRouteGateways/expressRouteConnections" -Name "<connection-name>" | Select-Object Name, ResourceId, Location | Format-Table

Delete the deployment

If you don't plan to keep the connection, remove it from the workload to avoid unnecessary Azure charges.

Recommendations

  • Keep the circuit and gateway configuration aligned with the same peering and authorization details.
  • Add tags to service catalog deployments to track ownership, purpose, and version.
  • Review the Azure ExpressRoute documentation for circuit and peering guidance: