Express Route Ports - Get

Service:: ExpressRoute

API-versie:: 2025-05-01

Hiermee wordt de aangevraagde ExpressRoutePort-resource opgehaald.

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

URI-parameters

Name	In	Vereist	Type	Description
expressRoutePortName	path	True	string	De naam van ExpressRoutePort.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	ExpressRoutePort	Azure-operatie succesvol voltooid.
Other Status Codes	CloudError	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

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

Voorbeeldrespons

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

Definities

Name	Description
CloudError	Een foutreactie van de service.
CloudErrorBody	Een foutreactie van de service.
ExpressRouteLink	ExpressRouteLink
ExpressRouteLinkAdminState	Beheerstatus van de fysieke poort.
ExpressRouteLinkConnectorType	Type fysieke glasvezelpoort.
ExpressRouteLinkMacSecCipher	Mac-beveiligingscode.
ExpressRouteLinkMacSecConfig	Definitie van ExpressRouteLink Mac-beveiligingsconfiguratie.
ExpressRouteLinkMacSecSciState	Sci-modus ingeschakeld/uitgeschakeld.
ExpressRoutePort	ExpressRoute-poort
ExpressRoutePortsBillingType	Het factureringstype van de ExpressRoutePort-resource.
ExpressRoutePortsEncapsulation	Inkapselingsmethode op fysieke poorten.
ManagedServiceIdentity	Identiteit voor de resource.
ManagedServiceIdentityUserAssignedIdentities
ProvisioningState	Inrichtingsstatussen van een resource.
ResourceIdentityType	Het type identiteit dat wordt gebruikt voor de resource. Het type SystemAssigned, UserAssigned bevat zowel een impliciet gemaakte identiteit als een set door de gebruiker toegewezen identiteiten. Met het type None worden alle identiteiten van de virtuele machine verwijderd.
SubResource	Verwijzing naar een andere subresource.

CloudError

Object

Een foutreactie van de service.

Name	Type	Description
error	CloudErrorBody	Wolk fout lichaam.

CloudErrorBody

Object

Een foutreactie van de service.

Name	Type	Description
code	string	Een id voor de fout. Codes zijn invariant en zijn bedoeld om programmatisch te worden gebruikt.
details	CloudErrorBody[]	Een lijst met aanvullende details over de fout.
message	string	Een bericht met een beschrijving van de fout, bedoeld om te worden weergegeven in een gebruikersinterface.
target	string	Het doel van de specifieke fout. Bijvoorbeeld de naam van de eigenschap in fout.

ExpressRouteLink

Object

ExpressRouteLink

Name	Type	Description
etag	string	Een unieke alleen-lezen tekenreeks die wordt gewijzigd wanneer de resource wordt bijgewerkt.
id	string	Resource-id.
name	string	Naam van onderliggende poortresource die uniek is tussen onderliggende poortresources van het bovenliggende item.
properties.adminState	ExpressRouteLinkAdminState	Beheerstatus van de fysieke poort.
properties.coloLocation	string	Cololocatie voor ExpressRoute Hybrid Direct.
properties.connectorType	ExpressRouteLinkConnectorType	Type fysieke glasvezelpoort.
properties.interfaceName	string	Naam van de Azure-routerinterface.
properties.macSecConfig	ExpressRouteLinkMacSecConfig	Definitie van ExpressRouteLink Mac-beveiligingsconfiguratie. MacSec-configuratie.
properties.patchPanelId	string	Mapping tussen fysieke poort naar patchpaneelpoort.
properties.provisioningState	ProvisioningState	De inrichtingsstatus van de resource voor expresroutekoppelingen.
properties.rackId	string	Mapping van fysiek patchpaneel naar rack.
properties.routerName	string	Naam van Azure-router die is gekoppeld aan fysieke poort.

ExpressRouteLinkAdminState

Opsomming

Beheerstatus van de fysieke poort.

Waarde	Description
Enabled	Ingeschakeld
Disabled	Uitgeschakeld

ExpressRouteLinkConnectorType

Opsomming

Type fysieke glasvezelpoort.

Waarde	Description
LC	LC
SC	SC

ExpressRouteLinkMacSecCipher

Opsomming

Mac-beveiligingscode.

Waarde	Description
GcmAes256	GcmAes256
GcmAes128	GcmAes128
GcmAesXpn128	GcmAesXpn128
GcmAesXpn256	GcmAesXpn256

ExpressRouteLinkMacSecConfig

Object

Definitie van ExpressRouteLink Mac-beveiligingsconfiguratie.

Name	Type	Description
cakSecretIdentifier	string	Keyvault Secret Identifier URL met Mac-beveiligings-CAK-sleutel.
cipher	ExpressRouteLinkMacSecCipher	Mac-beveiligingscode.
cknSecretIdentifier	string	Keyvault Secret Identifier URL met Mac-beveiliging CKN-sleutel.
sciState	ExpressRouteLinkMacSecSciState	Sci-modus ingeschakeld/uitgeschakeld.

ExpressRouteLinkMacSecSciState

Opsomming

Sci-modus ingeschakeld/uitgeschakeld.

Waarde	Description
Disabled	Uitgeschakeld
Enabled	Ingeschakeld