Express Route Circuits - List

Servizio:: ExpressRoute

Versione API:: 2025-05-01

Ottiene tutti i circuiti di route rapida in un gruppo di risorse.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	ExpressRouteCircuitListResult	L'operazione di Azure è stata completata correttamente.
Other Status Codes	CloudError	Risposta di errore imprevista.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

List ExpressRouteCircuits in a resource group

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/expressRouteCircuits?api-version=2025-05-01

const { NetworkManagementClient } = require("@azure/arm-network");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Gets all the express route circuits in a resource group.
 *
 * @summary Gets all the express route circuits in a resource group.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/ExpressRouteCircuitListByResourceGroup.json
 */
async function listExpressRouteCircuitsInAResourceGroup() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const resArray = new Array();
  for await (const item of client.expressRouteCircuits.list(resourceGroupName)) {
    resArray.push(item);
  }
  console.log(resArray);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Risposta di esempio

Codice di stato:: 200

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

Definizioni

Nome	Descrizione
AdvertisedPublicPrefixProperties	Proprietà del prefisso necessarie per eseguire la convalida utilizzando la firma openssl.
AdvertisedPublicPrefixPropertiesValidationState	Prefisso pubblico annunciato: Stato che indica se il prefisso è convalidato o meno.
AuthorizationUseStatus	Stato di utilizzo dell'autorizzazione.
CircuitConnectionStatus	Stato della connessione del circuito Express Route.
CloudError	Risposta di errore dal servizio.
CloudErrorBody	Risposta di errore dal servizio.
ExpressRouteCircuit	Risorsa ExpressRouteCircuit.
ExpressRouteCircuitAuthorization	Autorizzazione in una risorsa ExpressRouteCircuit.
ExpressRouteCircuitConnection	Connessione circuito ExpressRoute in una risorsa ExpressRouteCircuitPeering.
ExpressRouteCircuitListResult	La risposta di un'operazione di lista ExpressRouteCircuit.
ExpressRouteCircuitPeering	Peering in una risorsa ExpressRouteCircuit.
ExpressRouteCircuitPeeringAdvertisedPublicPrefixState	Stato del prefisso pubblico annunciato della risorsa di peering.
ExpressRouteCircuitPeeringConfig	Specifica la configurazione del peering.
ExpressRouteCircuitPeeringState	Stato del peering.
ExpressRouteCircuitServiceProviderProperties	Contiene ServiceProviderProperties in expressRouteCircuit.
ExpressRouteCircuitSku	Contiene lo SKU in un'istanza di ExpressRouteCircuit.
ExpressRouteCircuitSkuFamily	Famiglia dello SKU.
ExpressRouteCircuitSkuTier	Livello dello SKU.
ExpressRouteCircuitStats	Contiene le statistiche associate al peering.
ExpressRouteConnectionId	ID di ExpressRouteConnection.
ExpressRoutePeeringState	Stato del peering.
ExpressRoutePeeringType	Tipo di peering.
Ipv6CircuitConnectionConfig	Proprietà di connessione circuito IPv6 per copertura globale.
Ipv6ExpressRouteCircuitPeeringConfig	Contiene la configurazione del peering IPv6.
PeerExpressRouteCircuitConnection	Peer ExpressRoute Circuit Connection in una risorsa ExpressRouteCircuitPeering.
ProvisioningState	Stati di provisioning di una risorsa.
ServiceProviderProvisioningState	Stato ServiceProviderProvisioningState della risorsa.
SubResource	Riferimento a un'altra sottorisorsa.

AdvertisedPublicPrefixProperties

Oggetto

Proprietà del prefisso necessarie per eseguire la convalida utilizzando la firma openssl.

Nome	Tipo	Descrizione
prefix	string	Prefisso pubblico pubblicizzato.
signature	string	Stringa firmata generata crittografando validationId con una chiave privata.
validationId	string	Stringa di convalida che contiene informazioni sul peering del circuito.
validationState	AdvertisedPublicPrefixPropertiesValidationState	Prefisso pubblico annunciato: Stato che indica se il prefisso è convalidato o meno.

AdvertisedPublicPrefixPropertiesValidationState

Enumerazione

Prefisso pubblico annunciato: Stato che indica se il prefisso è convalidato o meno.

Valore	Descrizione
NotConfigured	Non configurato
Configuring	Configurazione
Configured	Configurata
ValidationNeeded	ValidazioneNecessaria
ValidationFailed	ValidationFailed
ManualValidationNeeded	ManualeValidazioneNecessaria
AsnValidationFailed	AsnValidazioneFallita
CertificateMissingInRoutingRegistry	CertificatoMissingInRoutingRegistry
InvalidSignatureEncoding	InvalidSignatureEncoding
SignatureVerificationFailed	Verifica della firma non riuscita

AuthorizationUseStatus

Enumerazione

Stato di utilizzo dell'autorizzazione.

Valore	Descrizione
Available	Disponibile
InUse	InUse

CircuitConnectionStatus

Enumerazione

Stato della connessione del circuito Express Route.

Valore	Descrizione
Connected	Connesso
Connecting	Connecting
Disconnected	Scollegato

CloudError

Oggetto

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
error	CloudErrorBody	Corpo dell'errore cloud.

CloudErrorBody

Oggetto

Risposta di errore dal servizio.

Nome	Tipo	Descrizione
code	string	Identificatore dell'errore. I codici sono invarianti e devono essere utilizzati a livello di codice.
details	CloudErrorBody[]	Un elenco di dettagli aggiuntivi sull'errore.
message	string	Messaggio che descrive l'errore, destinato a essere adatto per la visualizzazione in un'interfaccia utente.
target	string	Destinazione dell'errore specifico. Ad esempio, il nome della proprietà in errore.

ExpressRouteCircuit

Oggetto

Risorsa ExpressRouteCircuit.

Nome	Tipo	Descrizione
etag	string	Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.
id	string	ID risorsa.
location	string	Percorso della risorsa.
name	string	Nome risorsa.
properties.allowClassicOperations	boolean	Consenti operazioni classiche.
properties.authorizationKey	string	AuthorizationKey.
properties.authorizationStatus	string	Lo stato di autorizzazione del Circuito.
properties.authorizations	ExpressRouteCircuitAuthorization[]	Elenco di autorizzazioni.
properties.bandwidthInGbps	number (float)	Larghezza di banda del circuito quando viene effettuato il provisioning del circuito in una risorsa ExpressRoutePort.
properties.circuitProvisioningState	string	Stato CircuitProvisioningState della risorsa.
properties.enableDirectPortRateLimit	boolean	Contrassegnare lo stato di limitazione della frequenza del circuito direct-port di ExpressRoute.
properties.expressRoutePort	SubResource	Riferimento alla risorsa ExpressRoutePort quando viene effettuato il provisioning del circuito in una risorsa ExpressRoutePort.
properties.gatewayManagerEtag	string	Etag gatewayManager.
properties.globalReachEnabled	boolean	Flag che indica lo stato di copertura globale.
properties.peerings	ExpressRouteCircuitPeering[]	Elenco di peering.
properties.provisioningState	ProvisioningState	Stato di provisioning della risorsa del circuito di route rapida.
properties.serviceKey	string	La ServiceKey.
properties.serviceProviderNotes	string	L'oggetto ServiceProviderNotes.
properties.serviceProviderProperties	ExpressRouteCircuitServiceProviderProperties	L'oggetto ServiceProviderProperties.
properties.serviceProviderProvisioningState	ServiceProviderProvisioningState	Stato ServiceProviderProvisioningState della risorsa.
properties.stag	integer (int32)	Identificatore del traffico del circuito. Tag esterno per l'incapsulamento QinQ.
sku	ExpressRouteCircuitSku	La SKU.
tags	object	Tag di risorsa.
type	string	Tipo di risorsa.

ExpressRouteCircuitAuthorization

Oggetto

Autorizzazione in una risorsa ExpressRouteCircuit.

Nome	Tipo	Descrizione
etag	string	Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.
id	string	ID risorsa.
name	string	Nome della risorsa.
properties.authorizationKey	string	Chiave di autorizzazione.
properties.authorizationUseStatus	AuthorizationUseStatus	Stato di utilizzo dell'autorizzazione.
properties.connectionResourceUri	string	Riferimento alla risorsa di connessione ExpressRoute tramite l'autorizzazione.
properties.provisioningState	ProvisioningState	Stato di provisioning della risorsa di autorizzazione.
type	string	Tipo di risorsa.

ExpressRouteCircuitConnection

Oggetto

Connessione circuito ExpressRoute in una risorsa ExpressRouteCircuitPeering.

Nome	Tipo	Descrizione
etag	string	Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.
id	string	ID risorsa.
name	string	Nome della risorsa.
properties.addressPrefix	string	/29 spazio indirizzi IP per ritagliare gli indirizzi cliente per i tunnel.
properties.authorizationKey	string	Chiave di autorizzazione.
properties.circuitConnectionStatus	CircuitConnectionStatus	Stato della connessione del circuito Express Route.
properties.expressRouteCircuitPeering	SubResource	Riferimento alla risorsa peering privato del circuito ExpressRoute dell'avvio della connessione.
properties.ipv6CircuitConnectionConfig	Ipv6CircuitConnectionConfig	IPv6 Address PrefixProperties della connessione del circuito ExpressRoute.
properties.peerExpressRouteCircuitPeering	SubResource	Riferimento alla risorsa peering privato del circuito ExpressRoute del circuito con peering.
properties.provisioningState	ProvisioningState	Stato di provisioning della risorsa di connessione al circuito di instradamento rapido.
type	string	Tipo di risorsa.

ExpressRouteCircuitListResult

Oggetto

La risposta di un'operazione di lista ExpressRouteCircuit.

Nome	Tipo	Descrizione
nextLink	string (uri)	Collegamento alla pagina successiva di elementi
value	ExpressRouteCircuit[]	Gli elementi ExpressRouteCircuit presenti in questa pagina

ExpressRouteCircuitPeering

Oggetto

Peering in una risorsa ExpressRouteCircuit.

Nome	Tipo	Descrizione
etag	string	Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.
id	string	ID risorsa.
name	string	Nome della risorsa.
properties.azureASN	integer (int32)	Asn di Azure.
properties.connections	ExpressRouteCircuitConnection[]	Elenco delle connessioni di circuito associate al peering privato di Azure per questo circuito.
properties.expressRouteConnection	ExpressRouteConnectionId	Connessione ExpressRoute.
properties.gatewayManagerEtag	string	Etag gatewayManager.
properties.ipv6PeeringConfig	Ipv6ExpressRouteCircuitPeeringConfig	Configurazione del peering IPv6.
properties.lastModifiedBy	string	Chi è stato l'ultimo a modificare il peering.
properties.microsoftPeeringConfig	ExpressRouteCircuitPeeringConfig	Configurazione del peering Microsoft.
properties.peerASN	integer (int64) minimum: 1 maximum: 4294967295	ASN peer.
properties.peeredConnections	PeerExpressRouteCircuitConnection[]	Elenco delle connessioni al circuito con peering associate al peering privato di Azure per questo circuito.
properties.peeringType	ExpressRoutePeeringType	Tipo di peering.
properties.primaryAzurePort	string	Porta primaria.
properties.primaryPeerAddressPrefix	string	Prefisso dell'indirizzo primario.
properties.provisioningState	ProvisioningState	Stato di provisioning della risorsa peering del circuito di route rapida.
properties.routeFilter	SubResource	Riferimento alla risorsa RouteFilter.
properties.secondaryAzurePort	string	Porta secondaria.
properties.secondaryPeerAddressPrefix	string	Prefisso dell'indirizzo secondario.
properties.sharedKey	string	Chiave condivisa.
properties.state	ExpressRoutePeeringState	Stato del peering.
properties.stats	ExpressRouteCircuitStats	Statistiche di peering del circuito ExpressRoute.
properties.vlanId	integer (int32)	ID VLAN.
type	string	Tipo di risorsa.

ExpressRouteCircuitPeeringAdvertisedPublicPrefixState

Enumerazione

Stato del prefisso pubblico annunciato della risorsa di peering.

Valore	Descrizione
NotConfigured	Non configurato
Configuring	Configurazione
Configured	Configurata
ValidationNeeded	ValidazioneNecessaria

ExpressRouteCircuitPeeringConfig

Oggetto

Specifica la configurazione del peering.

Nome	Tipo	Descrizione
advertisedCommunities	string[]	Le comunità del peering bgp. Specificato per il peering Microsoft.
advertisedPublicPrefixInfo	AdvertisedPublicPrefixProperties[]	Elenco delle informazioni sul prefisso necessarie per eseguire la convalida.
advertisedPublicPrefixes	string[]	Riferimento a AdvertisedPublicPrefixes.
advertisedPublicPrefixesState	ExpressRouteCircuitPeeringAdvertisedPublicPrefixState	Stato del prefisso pubblico annunciato della risorsa di peering.
customerASN	integer (int32)	CustomerASN del peering.
legacyMode	integer (int32)	Modalità legacy del peering.
routingRegistryName	string	RoutingRegistryName della configurazione.

ExpressRouteCircuitPeeringState

Enumerazione

Stato del peering.

Valore	Descrizione
Disabled	Disattivato
Enabled	Enabled

ExpressRouteCircuitServiceProviderProperties

Oggetto

Contiene ServiceProviderProperties in expressRouteCircuit.

Nome	Tipo	Descrizione
bandwidthInMbps	integer (int32)	Il valore BandwidthInMbps.
peeringLocation	string	Posizione del peering.
serviceProviderName	string	ServiceProviderName.

ExpressRouteCircuitSku

Oggetto

Contiene lo SKU in un'istanza di ExpressRouteCircuit.

Nome	Tipo	Descrizione
family	ExpressRouteCircuitSkuFamily	Famiglia dello SKU.
name	string	Nome dello SKU.
tier	ExpressRouteCircuitSkuTier	Livello dello SKU.

ExpressRouteCircuitSkuFamily

Enumerazione

Famiglia dello SKU.

Valore	Descrizione
UnlimitedData	UnlimitedData
MeteredData	MeteredData

ExpressRouteCircuitSkuTier

Enumerazione

Livello dello SKU.

Valore	Descrizione
Standard	Standard
Premium	Premium
Basic	Basic
Local	Locale

ExpressRouteCircuitStats

Oggetto

Contiene le statistiche associate al peering.

Nome	Tipo	Descrizione
primarybytesIn	integer (int64)	Byte primariin del peering.
primarybytesOut	integer (int64)	BytesOut primario del peering.
secondarybytesIn	integer (int64)	Byte secondariIn del peering.
secondarybytesOut	integer (int64)	Byte secondariOut del peering.

ExpressRouteConnectionId

Oggetto

ID di ExpressRouteConnection.

Nome	Tipo	Descrizione
id	string	ID di ExpressRouteConnection.

ExpressRoutePeeringState

Enumerazione

Stato del peering.

Valore	Descrizione
Disabled	Disattivato
Enabled	Enabled

ExpressRoutePeeringType

Enumerazione

Tipo di peering.

Valore	Descrizione
AzurePublicPeering	AzurePublicPeering
AzurePrivatePeering	AzurePrivatePeering
MicrosoftPeering	MicrosoftPeering

Ipv6CircuitConnectionConfig

Oggetto

Proprietà di connessione circuito IPv6 per copertura globale.

Nome	Tipo	Descrizione
addressPrefix	string	/125 spazio degli indirizzi IP per ritagliare gli indirizzi dei clienti per la copertura globale.
circuitConnectionStatus	CircuitConnectionStatus	Stato della connessione del circuito Express Route.

Ipv6ExpressRouteCircuitPeeringConfig

Oggetto

Contiene la configurazione del peering IPv6.

Nome	Tipo	Descrizione
microsoftPeeringConfig	ExpressRouteCircuitPeeringConfig	Configurazione del peering Microsoft.
primaryPeerAddressPrefix	string	Prefisso dell'indirizzo primario.
routeFilter	SubResource	Riferimento alla risorsa RouteFilter.
secondaryPeerAddressPrefix	string	Prefisso dell'indirizzo secondario.
state	ExpressRouteCircuitPeeringState	Stato del peering.

PeerExpressRouteCircuitConnection

Oggetto

Peer ExpressRoute Circuit Connection in una risorsa ExpressRouteCircuitPeering.

Nome	Tipo	Descrizione
etag	string	Stringa di sola lettura univoca che cambia ogni volta che la risorsa viene aggiornata.
id	string	ID risorsa.
name	string	Nome della risorsa.
properties.addressPrefix	string	/29 spazio indirizzi IP per ritagliare gli indirizzi cliente per i tunnel.
properties.authResourceGuid	string	GUID della risorsa dell'autorizzazione utilizzata per la connessione al circuito di route rapida.
properties.circuitConnectionStatus	CircuitConnectionStatus	Stato della connessione del circuito Express Route.
properties.connectionName	string	Nome della risorsa di connessione al circuito di instradamento rapido.
properties.expressRouteCircuitPeering	SubResource	Riferimento alla risorsa di peering privato Express Route Circuit del circuito.
properties.peerExpressRouteCircuitPeering	SubResource	Riferimento alla risorsa peering privato del circuito ExpressRoute del circuito con peering.
properties.provisioningState	ProvisioningState	Stato di provisioning della risorsa di connessione del circuito di route rapida peer-to-peer.
type	string	Tipo di risorsa.

ProvisioningState

Enumerazione

Stati di provisioning di una risorsa.

Valore	Descrizione
Failed	Non riuscito
Succeeded	Succeeded
Canceled	Operazione annullata
Creating	Creazione
Updating	Aggiornamento
Deleting	Deleting

ServiceProviderProvisioningState

Enumerazione

Stato ServiceProviderProvisioningState della risorsa.

Valore	Descrizione
NotProvisioned	NotProvisioned
Provisioning	Provisioning
Provisioned	Sottoposto a provisioning
Deprovisioning	Revoca delle autorizzazioni

SubResource

Oggetto

Riferimento a un'altra sottorisorsa.

Nome	Tipo	Descrizione
id	string	ID risorsa.

Condividi tramite

Express Route Circuits - List

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

List ExpressRouteCircuits in a resource group

Esempio di richiesta

Risposta di esempio

Definizioni

AdvertisedPublicPrefixProperties

AdvertisedPublicPrefixPropertiesValidationState

AuthorizationUseStatus

CircuitConnectionStatus

CloudError

CloudErrorBody

ExpressRouteCircuit

ExpressRouteCircuitAuthorization

ExpressRouteCircuitConnection

ExpressRouteCircuitListResult

ExpressRouteCircuitPeering

ExpressRouteCircuitPeeringAdvertisedPublicPrefixState

ExpressRouteCircuitPeeringConfig

ExpressRouteCircuitPeeringState

ExpressRouteCircuitServiceProviderProperties

ExpressRouteCircuitSku

ExpressRouteCircuitSkuFamily

ExpressRouteCircuitSkuTier

ExpressRouteCircuitStats

ExpressRouteConnectionId

ExpressRoutePeeringState

ExpressRoutePeeringType

Ipv6CircuitConnectionConfig

Ipv6ExpressRouteCircuitPeeringConfig

PeerExpressRouteCircuitConnection

ProvisioningState

ServiceProviderProvisioningState

SubResource