Express Route Circuits - List

Gets all the express route circuits in a resource group.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/expressRouteCircuits?api-version=2023-09-01

URI Parameters

Name In Required Type Description
resourceGroupName
path True

string

The name of the resource group.

subscriptionId
path True

string

The subscription credentials which uniquely identify the Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.

api-version
query True

string

Client API version.

Responses

Name Type Description
200 OK

ExpressRouteCircuitListResult

Request successful. The operation returns the resulting ExpressRouteCircuitAuthorization resource.

Other Status Codes

CloudError

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

List ExpressRouteCircuits in a resource group

Sample Request

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/expressRouteCircuits?api-version=2023-09-01

Sample Response

{
  "value": [
    {
      "name": "circuitName1",
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/expressRouteCircuits/circuitName1",
      "etag": "W/\"832b28c3-f5fd-4d2a-a2cb-6e4a2fe452b3\"",
      "type": "Microsoft.Network/expressRouteCircuits",
      "location": "westus",
      "properties": {
        "provisioningState": "Succeeded",
        "peerings": [],
        "authorizations": [
          {
            "name": "MyAuthorization1",
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/expressRouteCircuits/circuitName/authorizations/MyAuthorization1",
            "etag": "W/\"832b28c3-f5fd-4d2a-a2cb-6e4a2fe452b3\"",
            "properties": {
              "provisioningState": "Succeeded",
              "authorizationKey": "authkey",
              "authorizationUseStatus": "Available"
            }
          }
        ],
        "serviceProviderProperties": {
          "serviceProviderName": "providerName",
          "peeringLocation": "peeringLocation",
          "bandwidthInMbps": 200
        },
        "circuitProvisioningState": "Enabled",
        "allowClassicOperations": false,
        "gatewayManagerEtag": "113",
        "serviceKey": "a1410692-ed3b-4ceb-b94a-b90b95d398d1",
        "serviceProviderProvisioningState": "Provisioned"
      },
      "sku": {
        "name": "Standard_MeteredData",
        "tier": "Standard",
        "family": "MeteredData"
      }
    },
    {
      "name": "circuitName2",
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/expressRouteCircuits/circuitName2",
      "etag": "W/\"e33c875f-48df-4a91-b7d3-eb95b5ddbb89\"",
      "type": "Microsoft.Network/expressRouteCircuits",
      "location": "westus",
      "properties": {
        "provisioningState": "Succeeded",
        "peerings": [],
        "authorizations": [
          {
            "name": "MyAuthorization2",
            "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/expressRouteCircuits/circuitName2/authorizations/MyAuthorization2",
            "etag": "W/\"e33c875f-48df-4a91-b7d3-eb95b5ddbb89\"",
            "properties": {
              "provisioningState": "Succeeded",
              "authorizationKey": "authkey",
              "authorizationUseStatus": "Available"
            }
          }
        ],
        "serviceProviderProperties": {
          "serviceProviderName": "providerName",
          "peeringLocation": "peeringLocation",
          "bandwidthInMbps": 200
        },
        "circuitProvisioningState": "Enabled",
        "allowClassicOperations": false,
        "gatewayManagerEtag": "",
        "serviceKey": "6569625a-9ba4-498b-9719-14d778eef609",
        "serviceProviderProvisioningState": "NotProvisioned"
      },
      "sku": {
        "name": "Standard_MeteredData",
        "tier": "Standard",
        "family": "MeteredData"
      }
    }
  ]
}

Definitions

Name Description
AuthorizationUseStatus

The authorization use status.

CircuitConnectionStatus

Express Route Circuit connection state.

CloudError

An error response from the service.

CloudErrorBody

An error response from the service.

ExpressRouteCircuit

ExpressRouteCircuit resource.

ExpressRouteCircuitAuthorization

Authorization in an ExpressRouteCircuit resource.

ExpressRouteCircuitConnection

Express Route Circuit Connection in an ExpressRouteCircuitPeering resource.

ExpressRouteCircuitListResult

Response for ListExpressRouteCircuit API service call.

ExpressRouteCircuitPeering

Peering in an ExpressRouteCircuit resource.

ExpressRouteCircuitPeeringAdvertisedPublicPrefixState

The advertised public prefix state of the Peering resource.

ExpressRouteCircuitPeeringConfig

Specifies the peering configuration.

ExpressRouteCircuitPeeringState

The state of peering.

ExpressRouteCircuitServiceProviderProperties

Contains ServiceProviderProperties in an ExpressRouteCircuit.

ExpressRouteCircuitSku

Contains SKU in an ExpressRouteCircuit.

ExpressRouteCircuitSkuFamily

The family of the SKU.

ExpressRouteCircuitSkuTier

The tier of the SKU.

ExpressRouteCircuitStats

Contains stats associated with the peering.

ExpressRouteConnectionId

The ID of the ExpressRouteConnection.

ExpressRoutePeeringState

The state of peering.

ExpressRoutePeeringType

The peering type.

Ipv6CircuitConnectionConfig

IPv6 Circuit Connection properties for global reach.

Ipv6ExpressRouteCircuitPeeringConfig

Contains IPv6 peering config.

PeerExpressRouteCircuitConnection

Peer Express Route Circuit Connection in an ExpressRouteCircuitPeering resource.

ProvisioningState

The current provisioning state.

ServiceProviderProvisioningState

The ServiceProviderProvisioningState state of the resource.

SubResource

Reference to another subresource.

AuthorizationUseStatus

The authorization use status.

Name Type Description
Available

string

InUse

string

CircuitConnectionStatus

Express Route Circuit connection state.

Name Type Description
Connected

string

Connecting

string

Disconnected

string

CloudError

An error response from the service.

Name Type Description
error

CloudErrorBody

Cloud error body.

CloudErrorBody

An error response from the service.

Name Type Description
code

string

An identifier for the error. Codes are invariant and are intended to be consumed programmatically.

details

CloudErrorBody[]

A list of additional details about the error.

message

string

A message describing the error, intended to be suitable for display in a user interface.

target

string

The target of the particular error. For example, the name of the property in error.

ExpressRouteCircuit

ExpressRouteCircuit resource.

Name Type Description
etag

string

A unique read-only string that changes whenever the resource is updated.

id

string

Resource ID.

location

string

Resource location.

name

string

Resource name.

properties.allowClassicOperations

boolean

Allow classic operations.

properties.authorizationKey

string

The authorizationKey.

properties.authorizationStatus

string

The authorization status of the Circuit.

properties.authorizations

ExpressRouteCircuitAuthorization[]

The list of authorizations.

properties.bandwidthInGbps

number

The bandwidth of the circuit when the circuit is provisioned on an ExpressRoutePort resource.

properties.circuitProvisioningState

string

The CircuitProvisioningState state of the resource.

properties.expressRoutePort

SubResource

The reference to the ExpressRoutePort resource when the circuit is provisioned on an ExpressRoutePort resource.

properties.gatewayManagerEtag

string

The GatewayManager Etag.

properties.globalReachEnabled

boolean

Flag denoting global reach status.

properties.peerings

ExpressRouteCircuitPeering[]

The list of peerings.

properties.provisioningState

ProvisioningState

The provisioning state of the express route circuit resource.

properties.serviceKey

string

The ServiceKey.

properties.serviceProviderNotes

string

The ServiceProviderNotes.

properties.serviceProviderProperties

ExpressRouteCircuitServiceProviderProperties

The ServiceProviderProperties.

properties.serviceProviderProvisioningState

ServiceProviderProvisioningState

The ServiceProviderProvisioningState state of the resource.

properties.stag

integer

The identifier of the circuit traffic. Outer tag for QinQ encapsulation.

sku

ExpressRouteCircuitSku

The SKU.

tags

object

Resource tags.

type

string

Resource type.

ExpressRouteCircuitAuthorization

Authorization in an ExpressRouteCircuit resource.

Name Type Description
etag

string

A unique read-only string that changes whenever the resource is updated.

id

string

Resource ID.

name

string

The name of the resource that is unique within a resource group. This name can be used to access the resource.

properties.authorizationKey

string

The authorization key.

properties.authorizationUseStatus

AuthorizationUseStatus

The authorization use status.

properties.provisioningState

ProvisioningState

The provisioning state of the authorization resource.

type

string

Type of the resource.

ExpressRouteCircuitConnection

Express Route Circuit Connection in an ExpressRouteCircuitPeering resource.

Name Type Description
etag

string

A unique read-only string that changes whenever the resource is updated.

id

string

Resource ID.

name

string

The name of the resource that is unique within a resource group. This name can be used to access the resource.

properties.addressPrefix

string

/29 IP address space to carve out Customer addresses for tunnels.

properties.authorizationKey

string

The authorization key.

properties.circuitConnectionStatus

CircuitConnectionStatus

Express Route Circuit connection state.

properties.expressRouteCircuitPeering

SubResource

Reference to Express Route Circuit Private Peering Resource of the circuit initiating connection.

properties.ipv6CircuitConnectionConfig

Ipv6CircuitConnectionConfig

IPv6 Address PrefixProperties of the express route circuit connection.

properties.peerExpressRouteCircuitPeering

SubResource

Reference to Express Route Circuit Private Peering Resource of the peered circuit.

properties.provisioningState

ProvisioningState

The provisioning state of the express route circuit connection resource.

type

string

Type of the resource.

ExpressRouteCircuitListResult

Response for ListExpressRouteCircuit API service call.

Name Type Description
nextLink

string

The URL to get the next set of results.

value

ExpressRouteCircuit[]

A list of ExpressRouteCircuits in a resource group.

ExpressRouteCircuitPeering

Peering in an ExpressRouteCircuit resource.

Name Type Description
etag

string

A unique read-only string that changes whenever the resource is updated.

id

string

Resource ID.

name

string

The name of the resource that is unique within a resource group. This name can be used to access the resource.

properties.azureASN

integer

The Azure ASN.

properties.connections

ExpressRouteCircuitConnection[]

The list of circuit connections associated with Azure Private Peering for this circuit.

properties.expressRouteConnection

ExpressRouteConnectionId

The ExpressRoute connection.

properties.gatewayManagerEtag

string

The GatewayManager Etag.

properties.ipv6PeeringConfig

Ipv6ExpressRouteCircuitPeeringConfig

The IPv6 peering configuration.

properties.lastModifiedBy

string

Who was the last to modify the peering.

properties.microsoftPeeringConfig

ExpressRouteCircuitPeeringConfig

The Microsoft peering configuration.

properties.peerASN

integer

The peer ASN.

properties.peeredConnections

PeerExpressRouteCircuitConnection[]

The list of peered circuit connections associated with Azure Private Peering for this circuit.

properties.peeringType

ExpressRoutePeeringType

The peering type.

properties.primaryAzurePort

string

The primary port.

properties.primaryPeerAddressPrefix

string

The primary address prefix.

properties.provisioningState

ProvisioningState

The provisioning state of the express route circuit peering resource.

properties.routeFilter

SubResource

The reference to the RouteFilter resource.

properties.secondaryAzurePort

string

The secondary port.

properties.secondaryPeerAddressPrefix

string

The secondary address prefix.

properties.sharedKey

string

The shared key.

properties.state

ExpressRoutePeeringState

The peering state.

properties.stats

ExpressRouteCircuitStats

The peering stats of express route circuit.

properties.vlanId

integer

The VLAN ID.

type

string

Type of the resource.

ExpressRouteCircuitPeeringAdvertisedPublicPrefixState

The advertised public prefix state of the Peering resource.

Name Type Description
Configured

string

Configuring

string

NotConfigured

string

ValidationNeeded

string

ExpressRouteCircuitPeeringConfig

Specifies the peering configuration.

Name Type Description
advertisedCommunities

string[]

The communities of bgp peering. Specified for microsoft peering.

advertisedPublicPrefixes

string[]

The reference to AdvertisedPublicPrefixes.

advertisedPublicPrefixesState

ExpressRouteCircuitPeeringAdvertisedPublicPrefixState

The advertised public prefix state of the Peering resource.

customerASN

integer

The CustomerASN of the peering.

legacyMode

integer

The legacy mode of the peering.

routingRegistryName

string

The RoutingRegistryName of the configuration.

ExpressRouteCircuitPeeringState

The state of peering.

Name Type Description
Disabled

string

Enabled

string

ExpressRouteCircuitServiceProviderProperties

Contains ServiceProviderProperties in an ExpressRouteCircuit.

Name Type Description
bandwidthInMbps

integer

The BandwidthInMbps.

peeringLocation

string

The peering location.

serviceProviderName

string

The serviceProviderName.

ExpressRouteCircuitSku

Contains SKU in an ExpressRouteCircuit.

Name Type Description
family

ExpressRouteCircuitSkuFamily

The family of the SKU.

name

string

The name of the SKU.

tier

ExpressRouteCircuitSkuTier

The tier of the SKU.

ExpressRouteCircuitSkuFamily

The family of the SKU.

Name Type Description
MeteredData

string

UnlimitedData

string

ExpressRouteCircuitSkuTier

The tier of the SKU.

Name Type Description
Basic

string

Local

string

Premium

string

Standard

string

ExpressRouteCircuitStats

Contains stats associated with the peering.

Name Type Description
primarybytesIn

integer

The Primary BytesIn of the peering.

primarybytesOut

integer

The primary BytesOut of the peering.

secondarybytesIn

integer

The secondary BytesIn of the peering.

secondarybytesOut

integer

The secondary BytesOut of the peering.

ExpressRouteConnectionId

The ID of the ExpressRouteConnection.

Name Type Description
id

string

The ID of the ExpressRouteConnection.

ExpressRoutePeeringState

The state of peering.

Name Type Description
Disabled

string

Enabled

string

ExpressRoutePeeringType

The peering type.

Name Type Description
AzurePrivatePeering

string

AzurePublicPeering

string

MicrosoftPeering

string

Ipv6CircuitConnectionConfig

IPv6 Circuit Connection properties for global reach.

Name Type Description
addressPrefix

string

/125 IP address space to carve out customer addresses for global reach.

circuitConnectionStatus

CircuitConnectionStatus

Express Route Circuit connection state.

Ipv6ExpressRouteCircuitPeeringConfig

Contains IPv6 peering config.

Name Type Description
microsoftPeeringConfig

ExpressRouteCircuitPeeringConfig

The Microsoft peering configuration.

primaryPeerAddressPrefix

string

The primary address prefix.

routeFilter

SubResource

The reference to the RouteFilter resource.

secondaryPeerAddressPrefix

string

The secondary address prefix.

state

ExpressRouteCircuitPeeringState

The state of peering.

PeerExpressRouteCircuitConnection

Peer Express Route Circuit Connection in an ExpressRouteCircuitPeering resource.

Name Type Description
etag

string

A unique read-only string that changes whenever the resource is updated.

id

string

Resource ID.

name

string

The name of the resource that is unique within a resource group. This name can be used to access the resource.

properties.addressPrefix

string

/29 IP address space to carve out Customer addresses for tunnels.

properties.authResourceGuid

string

The resource guid of the authorization used for the express route circuit connection.

properties.circuitConnectionStatus

CircuitConnectionStatus

Express Route Circuit connection state.

properties.connectionName

string

The name of the express route circuit connection resource.

properties.expressRouteCircuitPeering

SubResource

Reference to Express Route Circuit Private Peering Resource of the circuit.

properties.peerExpressRouteCircuitPeering

SubResource

Reference to Express Route Circuit Private Peering Resource of the peered circuit.

properties.provisioningState

ProvisioningState

The provisioning state of the peer express route circuit connection resource.

type

string

Type of the resource.

ProvisioningState

The current provisioning state.

Name Type Description
Deleting

string

Failed

string

Succeeded

string

Updating

string

ServiceProviderProvisioningState

The ServiceProviderProvisioningState state of the resource.

Name Type Description
Deprovisioning

string

NotProvisioned

string

Provisioned

string

Provisioning

string

SubResource

Reference to another subresource.

Name Type Description
id

string

Resource ID.