Express Route Ports - Get

Dienst:: ExpressRoute

API-Version:: 2025-05-01

Ruft die angeforderte ExpressRoutePort-Ressource ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
expressRoutePortName	path	True	string	Der Name von ExpressRoutePort.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	ExpressRoutePort	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	CloudError	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

ExpressRoutePortGet

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

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

/**
 * This sample demonstrates how to Retrieves the requested ExpressRoutePort resource.
 *
 * @summary Retrieves the requested ExpressRoutePort resource.
 * x-ms-original-file: specification/network/resource-manager/Microsoft.Network/Network/stable/2025-05-01/examples/ExpressRoutePortGet.json
 */
async function expressRoutePortGet() {
  const subscriptionId = process.env["NETWORK_SUBSCRIPTION_ID"] || "subid";
  const resourceGroupName = process.env["NETWORK_RESOURCE_GROUP"] || "rg1";
  const expressRoutePortName = "portName";
  const credential = new DefaultAzureCredential();
  const client = new NetworkManagementClient(credential, subscriptionId);
  const result = await client.expressRoutePorts.get(resourceGroupName, expressRoutePortName);
  console.log(result);
}

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

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "portName",
  "type": "Microsoft.Network/expressRoutePorts",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/expressRoutePorts/portName",
  "location": "westus",
  "properties": {
    "allocationDate": "Friday, July 1, 2018",
    "bandwidthInGbps": 100,
    "billingType": "UnlimitedData",
    "circuits": [],
    "encapsulation": "QinQ",
    "etherType": "0x8100",
    "links": [
      {
        "name": "link1",
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/expressRoutePorts/portName/links/link1",
        "properties": {
          "adminState": "Disabled",
          "coloLocation": "coloLocation1",
          "connectorType": "LC",
          "interfaceName": "Ethernet 0/0",
          "patchPanelId": "patchPanelId1",
          "provisioningState": "Succeeded",
          "rackId": "rackId1",
          "routerName": "router1"
        }
      },
      {
        "name": "link2",
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Network/expressRoutePorts/portName/links/link2",
        "properties": {
          "adminState": "Disabled",
          "coloLocation": "coloLocation2",
          "connectorType": "LC",
          "interfaceName": "Ethernet 0/0",
          "patchPanelId": "patchPanelId2",
          "provisioningState": "Succeeded",
          "rackId": "rackId2",
          "routerName": "router2"
        }
      }
    ],
    "mtu": "1500",
    "peeringLocation": "peeringLocationName",
    "provisionedBandwidthInGbps": 0,
    "provisioningState": "Succeeded"
  }
}

Definitionen

Name	Beschreibung
CloudError	Eine Fehlerantwort vom Dienst.
CloudErrorBody	Eine Fehlerantwort vom Dienst.
ExpressRouteLink	ExpressRouteLink (ExpressRouteLink)
ExpressRouteLinkAdminState	Administrativer Zustand des physischen Ports.
ExpressRouteLinkConnectorType	Physischer Fiber-Port-Typ.
ExpressRouteLinkMacSecCipher	Mac-Sicherheitschiffre.
ExpressRouteLinkMacSecConfig	Definition der ExpressRouteLink Mac-Sicherheitskonfiguration.
ExpressRouteLinkMacSecSciState	Sci-Modus aktiviert/deaktiviert.
ExpressRoutePort	ExpressRoute-Anschluss
ExpressRoutePortsBillingType	Der Abrechnungstyp der ExpressRoutePort-Ressource.
ExpressRoutePortsEncapsulation	Kapselungsmethode für physische Ports.
ManagedServiceIdentity	Identität für die Ressource.
ManagedServiceIdentityUserAssignedIdentities
ProvisioningState	Bereitstellungszustände einer Ressource.
ResourceIdentityType	Der Identitätstyp, der für die Ressource verwendet wird. Der Typ "SystemAssigned, UserAssigned" enthält sowohl eine implizit erstellte Identität als auch eine Gruppe von vom Benutzer zugewiesenen Identitäten. Der Typ "None" entfernt alle Identitäten vom virtuellen Computer.
SubResource	Verweisen auf eine andere Unterressource.

CloudError

Objekt

Eine Fehlerantwort vom Dienst.

Name	Typ	Beschreibung
error	CloudErrorBody	Cloud-Fehlertext.

CloudErrorBody

Objekt

Eine Fehlerantwort vom Dienst.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
details	CloudErrorBody[]	Eine Liste mit zusätzlichen Details zum Fehler.
message	string	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
target	string	Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler.

ExpressRouteLink

Objekt

ExpressRouteLink (ExpressRouteLink)

Name	Typ	Beschreibung
etag	string	Eine eindeutige schreibgeschützte Zeichenfolge, die sich ändert, wenn die Ressource aktualisiert wird.
id	string	Ressourcen-ID.
name	string	Name der untergeordneten Portressource, die unter untergeordneten Portressourcen des übergeordneten Elements eindeutig ist.
properties.adminState	ExpressRouteLinkAdminState	Administrativer Zustand des physischen Ports.
properties.coloLocation	string	Cololocation für ExpressRoute Hybrid Direct.
properties.connectorType	ExpressRouteLinkConnectorType	Physischer Fiber-Port-Typ.
properties.interfaceName	string	Name der Azure-Routerschnittstelle.
properties.macSecConfig	ExpressRouteLinkMacSecConfig	Definition der ExpressRouteLink Mac-Sicherheitskonfiguration. MacSec-Konfiguration.
properties.patchPanelId	string	Zuordnung zwischen physischem Port und Patchpanel-Port.
properties.provisioningState	ProvisioningState	Der Bereitstellungsstatus der Expressroute-Verknüpfungsressource.
properties.rackId	string	Mapping des physischen Patchpanels auf das Rack.
properties.routerName	string	Name des Azure-Routers, der dem physischen Port zugeordnet ist.

ExpressRouteLinkAdminState

Enumeration

Administrativer Zustand des physischen Ports.

Wert	Beschreibung
Enabled	Aktiviert
Disabled	Deaktiviert

ExpressRouteLinkConnectorType

Enumeration

Physischer Fiber-Port-Typ.

Wert	Beschreibung
LC	LC
SC	SC

ExpressRouteLinkMacSecCipher

Enumeration

Mac-Sicherheitschiffre.

Wert	Beschreibung
GcmAes256	GcmAes256
GcmAes128	GcmAes128
GcmAesXpn128	GcmAesXpn128
GcmAesXpn256	GcmAesXpn256

ExpressRouteLinkMacSecConfig

Objekt

Definition der ExpressRouteLink Mac-Sicherheitskonfiguration.

Name	Typ	Beschreibung
cakSecretIdentifier	string	Keyvault Secret Identifier-URL, die Mac-Sicherheits-CAK-Schlüssel enthält.
cipher	ExpressRouteLinkMacSecCipher	Mac-Sicherheitschiffre.
cknSecretIdentifier	string	Keyvault Secret Identifier-URL mit Mac-Sicherheitsschlüssel CKN.
sciState	ExpressRouteLinkMacSecSciState	Sci-Modus aktiviert/deaktiviert.

ExpressRouteLinkMacSecSciState

Enumeration

Sci-Modus aktiviert/deaktiviert.

Wert	Beschreibung
Disabled	Deaktiviert
Enabled	Aktiviert