Udostępnij za pośrednictwem


Express Route Circuits - List

Pobiera wszystkie obwody trasy ekspresowej w grupie zasobów.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
path True

string (uuid)

Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa Typ Opis
200 OK

ExpressRouteCircuitListResult

Operacja platformy Azure została zakończona pomyślnie.

Other Status Codes

CloudError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

List ExpressRouteCircuits in a resource group

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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"
      }
    }
  ]
}

Definicje

Nazwa Opis
AdvertisedPublicPrefixProperties

Właściwości prefiksu wymagane do przeprowadzenia walidacji przy użyciu podpisu openssl.

AdvertisedPublicPrefixPropertiesValidationState

Anonsowany stan prefiksu publicznego, który wskazuje, czy prefiks jest zweryfikowany, czy nie.

AuthorizationUseStatus

Stan użycia autoryzacji.

CircuitConnectionStatus

Stan połączenia obwodu usługi Express Route.

CloudError

Odpowiedź o błędzie z usługi.

CloudErrorBody

Odpowiedź o błędzie z usługi.

ExpressRouteCircuit

Zasób ExpressRouteCircuit.

ExpressRouteCircuitAuthorization

Autoryzacja w zasobie ExpressRouteCircuit.

ExpressRouteCircuitConnection

Połączenie obwodu usługi Express Route w zasobie ExpressRouteCircuitPeering.

ExpressRouteCircuitListResult

Odpowiedź operacji listy ExpressRouteCircuit.

ExpressRouteCircuitPeering

Komunikacja równorzędna w zasobie ExpressRouteCircuit.

ExpressRouteCircuitPeeringAdvertisedPublicPrefixState

Anonsowany stan prefiksu publicznego zasobu komunikacji równorzędnej.

ExpressRouteCircuitPeeringConfig

Określa konfigurację komunikacji równorzędnej.

ExpressRouteCircuitPeeringState

Stan komunikacji równorzędnej.

ExpressRouteCircuitServiceProviderProperties

Zawiera właściwość ServiceProviderProperties w elemecie ExpressRouteCircuit.

ExpressRouteCircuitSku

Zawiera jednostkę SKU w usłudze ExpressRouteCircuit.

ExpressRouteCircuitSkuFamily

Rodzina jednostki SKU.

ExpressRouteCircuitSkuTier

Warstwa jednostki SKU.

ExpressRouteCircuitStats

Zawiera statystyki skojarzone z komunikacją równorzędną.

ExpressRouteConnectionId

Identyfikator połączenia ExpressRouteConnection.

ExpressRoutePeeringState

Stan komunikacji równorzędnej.

ExpressRoutePeeringType

Typ komunikacji równorzędnej.

Ipv6CircuitConnectionConfig

Właściwości połączenia obwodu IPv6 dla zasięgu globalnego.

Ipv6ExpressRouteCircuitPeeringConfig

Zawiera konfigurację komunikacji równorzędnej IPv6.

PeerExpressRouteCircuitConnection

Równorzędne połączenie obwodu usługi Express Route w zasobie ExpressRouteCircuitPeering.

ProvisioningState

Stany aprowizacji zasobu.

ServiceProviderProvisioningState

Stan ServiceProviderProvisioningState zasobu.

SubResource

Odwołanie do innego podźródła.

AdvertisedPublicPrefixProperties

Właściwości prefiksu wymagane do przeprowadzenia walidacji przy użyciu podpisu openssl.

Nazwa Typ Opis
prefix

string

Anonsowany prefiks publiczny.

signature

string

Podpisany ciąg wygenerowany przez zaszyfrowanie validationId przy użyciu klucza prywatnego.

validationId

string

Ciąg walidacji zawierający informacje o komunikacji równorzędnej obwodów.

validationState

AdvertisedPublicPrefixPropertiesValidationState

Anonsowany stan prefiksu publicznego, który wskazuje, czy prefiks jest zweryfikowany, czy nie.

AdvertisedPublicPrefixPropertiesValidationState

Anonsowany stan prefiksu publicznego, który wskazuje, czy prefiks jest zweryfikowany, czy nie.

Wartość Opis
NotConfigured

NotConfigured

Configuring

Konfigurowanie

Configured

Skonfigurowany

ValidationNeeded

Potrzebna walidacja

ValidationFailed

ValidationFailed

ManualValidationNeeded

Wymagana manualna walidacja

AsnValidationFailed

AsnValidationFailed

CertificateMissingInRoutingRegistry

CertificateMissingInRoutingRegistry

InvalidSignatureEncoding

NieprawidłowePodpisowe kodowanie

SignatureVerificationFailed

WeryfikacjaPodpisuNiepowiodłaSię

AuthorizationUseStatus

Stan użycia autoryzacji.

Wartość Opis
Available

Dostępny

InUse

InUse

CircuitConnectionStatus

Stan połączenia obwodu usługi Express Route.

Wartość Opis
Connected

Połączono

Connecting

Connecting

Disconnected

Disconnected

CloudError

Odpowiedź o błędzie z usługi.

Nazwa Typ Opis
error

CloudErrorBody

Ciało błędu chmury.

CloudErrorBody

Odpowiedź o błędzie z usługi.

Nazwa Typ Opis
code

string

Identyfikator błędu. Kody są niezmienne i mają być używane programowo.

details

CloudErrorBody[]

Lista dodatkowych szczegółów dotyczących błędu.

message

string

Komunikat opisujący błąd, który ma być odpowiedni do wyświetlania w interfejsie użytkownika.

target

string

Element docelowy określonego błędu. Na przykład nazwa właściwości w błędzie.

ExpressRouteCircuit

Zasób ExpressRouteCircuit.

Nazwa Typ Opis
etag

string

Unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób jest aktualizowany.

id

string

Identyfikator zasobu.

location

string

Lokalizacja zasobu.

name

string

Nazwa zasobu.

properties.allowClassicOperations

boolean

Zezwalaj na operacje klasyczne.

properties.authorizationKey

string

Klucz autoryzacji.

properties.authorizationStatus

string

Status autoryzacji obwodu.

properties.authorizations

ExpressRouteCircuitAuthorization[]

Lista autoryzacji.

properties.bandwidthInGbps

number (float)

Przepustowość obwodu, gdy obwód jest aprowizowany w zasobie ExpressRoutePort.

properties.circuitProvisioningState

string

Stan CircuitProvisioningState zasobu.

properties.enableDirectPortRateLimit

boolean

Flaga oznaczający stan ograniczania szybkości obwodu bezpośredniego usługi ExpressRoute.

properties.expressRoutePort

SubResource

Odwołanie do zasobu ExpressRoutePort podczas aprowizowania obwodu w zasobie ExpressRoutePort.

properties.gatewayManagerEtag

string

Element Etag GatewayManager.

properties.globalReachEnabled

boolean

Flaga oznaczającą stan globalnego zasięgu.

properties.peerings

ExpressRouteCircuitPeering[]

Lista komunikacji równorzędnej.

properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu obwodu trasy ekspresowej.

properties.serviceKey

string

Klucz usługi.

properties.serviceProviderNotes

string

Uwagi ServiceProvider.

properties.serviceProviderProperties

ExpressRouteCircuitServiceProviderProperties

Właściwość ServiceProvider.

properties.serviceProviderProvisioningState

ServiceProviderProvisioningState

Stan ServiceProviderProvisioningState zasobu.

properties.stag

integer (int32)

Identyfikator ruchu obwodu. Zewnętrzny znacznik do enkapsulacji QinQ.

sku

ExpressRouteCircuitSku

Jednostka SKU.

tags

object

Tagi zasobów.

type

string

Typ zasobu.

ExpressRouteCircuitAuthorization

Autoryzacja w zasobie ExpressRouteCircuit.

Nazwa Typ Opis
etag

string

Unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób jest aktualizowany.

id

string

Identyfikator zasobu.

name

string

Nazwa zasobu.

properties.authorizationKey

string

Klucz autoryzacji.

properties.authorizationUseStatus

AuthorizationUseStatus

Stan użycia autoryzacji.

properties.connectionResourceUri

string

Odwołanie do zasobu połączenia usługi ExpressRoute przy użyciu autoryzacji.

properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu autoryzacji.

type

string

Typ zasobu.

ExpressRouteCircuitConnection

Połączenie obwodu usługi Express Route w zasobie ExpressRouteCircuitPeering.

Nazwa Typ Opis
etag

string

Unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób jest aktualizowany.

id

string

Identyfikator zasobu.

name

string

Nazwa zasobu.

properties.addressPrefix

string

/29 przestrzeń adresów IP, aby wyrzucić adresy klienta dla tuneli.

properties.authorizationKey

string

Klucz autoryzacji.

properties.circuitConnectionStatus

CircuitConnectionStatus

Stan połączenia obwodu usługi Express Route.

properties.expressRouteCircuitPeering

SubResource

Odwołanie do zasobu prywatnej komunikacji równorzędnej obwodu usługi Express Route inicjującego połączenie.

properties.ipv6CircuitConnectionConfig

Ipv6CircuitConnectionConfig

Prefiks adresu IPv6Właściwości połączenia obwodu usługi Express Route.

properties.peerExpressRouteCircuitPeering

SubResource

Odwołanie do zasobu prywatnej komunikacji równorzędnej obwodu usługi Express Route dla obwodu równorzędnego.

properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu połączenia obwodu usługi Express Route.

type

string

Typ zasobu.

ExpressRouteCircuitListResult

Odpowiedź operacji listy ExpressRouteCircuit.

Nazwa Typ Opis
nextLink

string (uri)

Link do następnej strony elementów

value

ExpressRouteCircuit[]

Elementy ExpressRouteCircuit na tej stronie

ExpressRouteCircuitPeering

Komunikacja równorzędna w zasobie ExpressRouteCircuit.

Nazwa Typ Opis
etag

string

Unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób jest aktualizowany.

id

string

Identyfikator zasobu.

name

string

Nazwa zasobu.

properties.azureASN

integer (int32)

Numer ASN platformy Azure.

properties.connections

ExpressRouteCircuitConnection[]

Lista połączeń obwodu skojarzonych z prywatną komunikacją równorzędną platformy Azure dla tego obwodu.

properties.expressRouteConnection

ExpressRouteConnectionId

Połączenie usługi ExpressRoute.

properties.gatewayManagerEtag

string

Element Etag GatewayManager.

properties.ipv6PeeringConfig

Ipv6ExpressRouteCircuitPeeringConfig

Konfiguracja komunikacji równorzędnej IPv6.

properties.lastModifiedBy

string

Kto był ostatni, aby zmodyfikować komunikację równorzędną.

properties.microsoftPeeringConfig

ExpressRouteCircuitPeeringConfig

Konfiguracja komunikacji równorzędnej firmy Microsoft.

properties.peerASN

integer (int64)

minimum: 1
maximum: 4294967295

Równorzędny numer ASN.

properties.peeredConnections

PeerExpressRouteCircuitConnection[]

Lista połączeń obwodów równorzędnych skojarzonych z prywatną komunikacją równorzędną Azure dla tego obwodu.

properties.peeringType

ExpressRoutePeeringType

Typ komunikacji równorzędnej.

properties.primaryAzurePort

string

Port podstawowy.

properties.primaryPeerAddressPrefix

string

Prefiks adresu podstawowego.

properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu komunikacji równorzędnej obwodu trasy ekspresowej.

properties.routeFilter

SubResource

Odwołanie do zasobu RouteFilter.

properties.secondaryAzurePort

string

Port pomocniczy.

properties.secondaryPeerAddressPrefix

string

Prefiks adresu pomocniczego.

properties.sharedKey

string

Klucz wspólny.

properties.state

ExpressRoutePeeringState

Stan komunikacji równorzędnej.

properties.stats

ExpressRouteCircuitStats

Statystyki komunikacji równorzędnej obwodu usługi Express Route.

properties.vlanId

integer (int32)

Identyfikator sieci VLAN.

type

string

Typ zasobu.

ExpressRouteCircuitPeeringAdvertisedPublicPrefixState

Anonsowany stan prefiksu publicznego zasobu komunikacji równorzędnej.

Wartość Opis
NotConfigured

NotConfigured

Configuring

Konfigurowanie

Configured

Skonfigurowany

ValidationNeeded

Potrzebna walidacja

ExpressRouteCircuitPeeringConfig

Określa konfigurację komunikacji równorzędnej.

Nazwa Typ Opis
advertisedCommunities

string[]

Społeczności komunikacji równorzędnej bgp. Określono dla komunikacji równorzędnej firmy Microsoft.

advertisedPublicPrefixInfo

AdvertisedPublicPrefixProperties[]

Lista informacji o prefiksie wymaganych do przeprowadzenia walidacji.

advertisedPublicPrefixes

string[]

Odwołanie do anonsowanychpublicPrefixes.

advertisedPublicPrefixesState

ExpressRouteCircuitPeeringAdvertisedPublicPrefixState

Anonsowany stan prefiksu publicznego zasobu komunikacji równorzędnej.

customerASN

integer (int32)

Nazwa CustomerASN komunikacji równorzędnej.

legacyMode

integer (int32)

Starszy tryb komunikacji równorzędnej.

routingRegistryName

string

RoutingRegistryName konfiguracji.

ExpressRouteCircuitPeeringState

Stan komunikacji równorzędnej.

Wartość Opis
Disabled

Wyłączony

Enabled

Enabled

ExpressRouteCircuitServiceProviderProperties

Zawiera właściwość ServiceProviderProperties w elemecie ExpressRouteCircuit.

Nazwa Typ Opis
bandwidthInMbps

integer (int32)

PrzepustowośćInMbps.

peeringLocation

string

Lokalizacja komunikacji równorzędnej.

serviceProviderName

string

ServiceProviderName.

ExpressRouteCircuitSku

Zawiera jednostkę SKU w usłudze ExpressRouteCircuit.

Nazwa Typ Opis
family

ExpressRouteCircuitSkuFamily

Rodzina jednostki SKU.

name

string

Nazwa jednostki SKU.

tier

ExpressRouteCircuitSkuTier

Warstwa jednostki SKU.

ExpressRouteCircuitSkuFamily

Rodzina jednostki SKU.

Wartość Opis
UnlimitedData

UnlimitedData

MeteredData

MeteredData

ExpressRouteCircuitSkuTier

Warstwa jednostki SKU.

Wartość Opis
Standard

Standard

Premium

Premium

Basic

Basic

Local

Lokalny

ExpressRouteCircuitStats

Zawiera statystyki skojarzone z komunikacją równorzędną.

Nazwa Typ Opis
primarybytesIn

integer (int64)

Podstawowy bajtW komunikacji równorzędnej.

primarybytesOut

integer (int64)

Podstawowy bajt bajtów komunikacji równorzędnej.

secondarybytesIn

integer (int64)

Pomocnicze bajtyW komunikacji równorzędnej.

secondarybytesOut

integer (int64)

Pomocniczy bajt bajtów komunikacji równorzędnej.

ExpressRouteConnectionId

Identyfikator połączenia ExpressRouteConnection.

Nazwa Typ Opis
id

string

Identyfikator połączenia ExpressRouteConnection.

ExpressRoutePeeringState

Stan komunikacji równorzędnej.

Wartość Opis
Disabled

Wyłączony

Enabled

Enabled

ExpressRoutePeeringType

Typ komunikacji równorzędnej.

Wartość Opis
AzurePublicPeering

AzurePublicPeering

AzurePrivatePeering

AzurePrivatePeering

MicrosoftPeering

MicrosoftPeering

Ipv6CircuitConnectionConfig

Właściwości połączenia obwodu IPv6 dla zasięgu globalnego.

Nazwa Typ Opis
addressPrefix

string

/125 przestrzeń adresów IP, aby wyrzuceć adresy klientów na potrzeby zasięgu globalnego.

circuitConnectionStatus

CircuitConnectionStatus

Stan połączenia obwodu usługi Express Route.

Ipv6ExpressRouteCircuitPeeringConfig

Zawiera konfigurację komunikacji równorzędnej IPv6.

Nazwa Typ Opis
microsoftPeeringConfig

ExpressRouteCircuitPeeringConfig

Konfiguracja komunikacji równorzędnej firmy Microsoft.

primaryPeerAddressPrefix

string

Prefiks adresu podstawowego.

routeFilter

SubResource

Odwołanie do zasobu RouteFilter.

secondaryPeerAddressPrefix

string

Prefiks adresu pomocniczego.

state

ExpressRouteCircuitPeeringState

Stan komunikacji równorzędnej.

PeerExpressRouteCircuitConnection

Równorzędne połączenie obwodu usługi Express Route w zasobie ExpressRouteCircuitPeering.

Nazwa Typ Opis
etag

string

Unikatowy ciąg tylko do odczytu, który zmienia się za każdym razem, gdy zasób jest aktualizowany.

id

string

Identyfikator zasobu.

name

string

Nazwa zasobu.

properties.addressPrefix

string

/29 przestrzeń adresów IP, aby wyrzucić adresy klienta dla tuneli.

properties.authResourceGuid

string

Identyfikator GUID zasobu autoryzacji używanej dla połączenia obwodu usługi Express Route.

properties.circuitConnectionStatus

CircuitConnectionStatus

Stan połączenia obwodu usługi Express Route.

properties.connectionName

string

Nazwa zasobu połączenia obwodu trasy ekspresowej.

properties.expressRouteCircuitPeering

SubResource

Odwołanie do zasobu prywatnej komunikacji równorzędnej obwodu usługi Express Route.

properties.peerExpressRouteCircuitPeering

SubResource

Odwołanie do zasobu prywatnej komunikacji równorzędnej obwodu usługi Express Route dla obwodu równorzędnego.

properties.provisioningState

ProvisioningState

Stan aprowizacji zasobu połączenia równorzędnego obwodu trasy ekspresowej.

type

string

Typ zasobu.

ProvisioningState

Stany aprowizacji zasobu.

Wartość Opis
Failed

Niepowodzenie

Succeeded

Powodzenie

Canceled

Anulowane

Creating

Tworzenie

Updating

Aktualizowanie

Deleting

Usuwanie

ServiceProviderProvisioningState

Stan ServiceProviderProvisioningState zasobu.

Wartość Opis
NotProvisioned

NotProvisioned

Provisioning

Zapewnianie zasobów

Provisioned

Udostępnione

Deprovisioning

Deprowizjonowanie

SubResource

Odwołanie do innego podźródła.

Nazwa Typ Opis
id

string

Identyfikator zasobu.