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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter. |
|
subscription
|
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 |
Operacja platformy Azure została zakończona pomyślnie. |
|
| Other Status Codes |
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 |
|---|---|
|
Advertised |
Właściwości prefiksu wymagane do przeprowadzenia walidacji przy użyciu podpisu openssl. |
|
Advertised |
Anonsowany stan prefiksu publicznego, który wskazuje, czy prefiks jest zweryfikowany, czy nie. |
|
Authorization |
Stan użycia autoryzacji. |
|
Circuit |
Stan połączenia obwodu usługi Express Route. |
|
Cloud |
Odpowiedź o błędzie z usługi. |
|
Cloud |
Odpowiedź o błędzie z usługi. |
|
Express |
Zasób ExpressRouteCircuit. |
|
Express |
Autoryzacja w zasobie ExpressRouteCircuit. |
|
Express |
Połączenie obwodu usługi Express Route w zasobie ExpressRouteCircuitPeering. |
|
Express |
Odpowiedź operacji listy ExpressRouteCircuit. |
|
Express |
Komunikacja równorzędna w zasobie ExpressRouteCircuit. |
|
Express |
Anonsowany stan prefiksu publicznego zasobu komunikacji równorzędnej. |
|
Express |
Określa konfigurację komunikacji równorzędnej. |
|
Express |
Stan komunikacji równorzędnej. |
|
Express |
Zawiera właściwość ServiceProviderProperties w elemecie ExpressRouteCircuit. |
|
Express |
Zawiera jednostkę SKU w usłudze ExpressRouteCircuit. |
|
Express |
Rodzina jednostki SKU. |
|
Express |
Warstwa jednostki SKU. |
|
Express |
Zawiera statystyki skojarzone z komunikacją równorzędną. |
|
Express |
Identyfikator połączenia ExpressRouteConnection. |
|
Express |
Stan komunikacji równorzędnej. |
|
Express |
Typ komunikacji równorzędnej. |
|
Ipv6Circuit |
Właściwości połączenia obwodu IPv6 dla zasięgu globalnego. |
|
Ipv6Express |
Zawiera konfigurację komunikacji równorzędnej IPv6. |
|
Peer |
Równorzędne połączenie obwodu usługi Express Route w zasobie ExpressRouteCircuitPeering. |
|
Provisioning |
Stany aprowizacji zasobu. |
|
Service |
Stan ServiceProviderProvisioningState zasobu. |
|
Sub |
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 |
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 |
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 |
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 |
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 |
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 |
Lista komunikacji równorzędnej. |
|
| properties.provisioningState |
Stan aprowizacji zasobu obwodu trasy ekspresowej. |
|
| properties.serviceKey |
string |
Klucz usługi. |
| properties.serviceProviderNotes |
string |
Uwagi ServiceProvider. |
| properties.serviceProviderProperties |
Właściwość ServiceProvider. |
|
| properties.serviceProviderProvisioningState |
Stan ServiceProviderProvisioningState zasobu. |
|
| properties.stag |
integer (int32) |
Identyfikator ruchu obwodu. Zewnętrzny znacznik do enkapsulacji QinQ. |
| sku |
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 |
Stan użycia autoryzacji. |
|
| properties.connectionResourceUri |
string |
Odwołanie do zasobu połączenia usługi ExpressRoute przy użyciu autoryzacji. |
| properties.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 |
Stan połączenia obwodu usługi Express Route. |
|
| properties.expressRouteCircuitPeering |
Odwołanie do zasobu prywatnej komunikacji równorzędnej obwodu usługi Express Route inicjującego połączenie. |
|
| properties.ipv6CircuitConnectionConfig |
Prefiks adresu IPv6Właściwości połączenia obwodu usługi Express Route. |
|
| properties.peerExpressRouteCircuitPeering |
Odwołanie do zasobu prywatnej komunikacji równorzędnej obwodu usługi Express Route dla obwodu równorzędnego. |
|
| properties.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 |
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 |
Lista połączeń obwodu skojarzonych z prywatną komunikacją równorzędną platformy Azure dla tego obwodu. |
|
| properties.expressRouteConnection |
Połączenie usługi ExpressRoute. |
|
| properties.gatewayManagerEtag |
string |
Element Etag GatewayManager. |
| properties.ipv6PeeringConfig |
Konfiguracja komunikacji równorzędnej IPv6. |
|
| properties.lastModifiedBy |
string |
Kto był ostatni, aby zmodyfikować komunikację równorzędną. |
| properties.microsoftPeeringConfig |
Konfiguracja komunikacji równorzędnej firmy Microsoft. |
|
| properties.peerASN |
integer (int64) minimum: 1maximum: 4294967295 |
Równorzędny numer ASN. |
| properties.peeredConnections |
Lista połączeń obwodów równorzędnych skojarzonych z prywatną komunikacją równorzędną Azure dla tego obwodu. |
|
| properties.peeringType |
Typ komunikacji równorzędnej. |
|
| properties.primaryAzurePort |
string |
Port podstawowy. |
| properties.primaryPeerAddressPrefix |
string |
Prefiks adresu podstawowego. |
| properties.provisioningState |
Stan aprowizacji zasobu komunikacji równorzędnej obwodu trasy ekspresowej. |
|
| properties.routeFilter |
Odwołanie do zasobu RouteFilter. |
|
| properties.secondaryAzurePort |
string |
Port pomocniczy. |
| properties.secondaryPeerAddressPrefix |
string |
Prefiks adresu pomocniczego. |
| properties.sharedKey |
string |
Klucz wspólny. |
| properties.state |
Stan komunikacji równorzędnej. |
|
| properties.stats |
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 |
Lista informacji o prefiksie wymaganych do przeprowadzenia walidacji. |
|
| advertisedPublicPrefixes |
string[] |
Odwołanie do anonsowanychpublicPrefixes. |
| advertisedPublicPrefixesState |
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 |
Rodzina jednostki SKU. |
|
| name |
string |
Nazwa jednostki SKU. |
| tier |
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 |
Stan połączenia obwodu usługi Express Route. |
Ipv6ExpressRouteCircuitPeeringConfig
Zawiera konfigurację komunikacji równorzędnej IPv6.
| Nazwa | Typ | Opis |
|---|---|---|
| microsoftPeeringConfig |
Konfiguracja komunikacji równorzędnej firmy Microsoft. |
|
| primaryPeerAddressPrefix |
string |
Prefiks adresu podstawowego. |
| routeFilter |
Odwołanie do zasobu RouteFilter. |
|
| secondaryPeerAddressPrefix |
string |
Prefiks adresu pomocniczego. |
| state |
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 |
Stan połączenia obwodu usługi Express Route. |
|
| properties.connectionName |
string |
Nazwa zasobu połączenia obwodu trasy ekspresowej. |
| properties.expressRouteCircuitPeering |
Odwołanie do zasobu prywatnej komunikacji równorzędnej obwodu usługi Express Route. |
|
| properties.peerExpressRouteCircuitPeering |
Odwołanie do zasobu prywatnej komunikacji równorzędnej obwodu usługi Express Route dla obwodu równorzędnego. |
|
| properties.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. |