Express Route Ports - Get

Szolgáltatás:: ExpressRoute

API-verzió:: 2025-05-01

Lekéri a kért ExpressRoutePort-erőforrást.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
expressRoutePortName	path	True	string	Az ExpressRoutePort neve.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string (uuid)	A cél-előfizetés azonosítója. Az értéknek UUID-nek kell lennie.
api-version	query	True	string minLength: 1	A művelethez használandó API-verzió.

Válaszok

Name	Típus	Description
200 OK	ExpressRoutePort	Az Azure-művelet sikeresen befejeződött.
Other Status Codes	CloudError	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory OAuth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

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

Mintaválasz

Állapotkód:: 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"
  }
}

Definíciók

Name	Description
CloudError	Hibaválasz a szolgáltatástól.
CloudErrorBody	Hibaválasz a szolgáltatástól.
ExpressRouteLink	ExpressRouteLink
ExpressRouteLinkAdminState	A fizikai port felügyeleti állapota.
ExpressRouteLinkConnectorType	Fizikai szálas port típusa.
ExpressRouteLinkMacSecCipher	Mac biztonsági titkosítás.
ExpressRouteLinkMacSecConfig	Az ExpressRouteLink Mac biztonsági konfigurációjának meghatározása.
ExpressRouteLinkMacSecSciState	A Sci mód engedélyezve/letiltva.
ExpressRoutePort	ExpressRoute-port
ExpressRoutePortsBillingType	Az ExpressRoutePort-erőforrás számlázási típusa.
ExpressRoutePortsEncapsulation	Beágyazási módszer fizikai portokon.
ManagedServiceIdentity	Az erőforrás identitása.
ManagedServiceIdentityUserAssignedIdentities
ProvisioningState	Erőforrás kiépítési állapotai.
ResourceIdentityType	Az erőforráshoz használt identitás típusa. A "SystemAssigned, UserAssigned" típus egy implicit módon létrehozott identitást és egy felhasználó által hozzárendelt identitáskészletet is tartalmaz. A "Nincs" típus eltávolít minden identitást a virtuális gépről.
SubResource	Hivatkozás egy másik alforrásra.

CloudError

Tárgy

Hibaválasz a szolgáltatástól.

Name	Típus	Description
error	CloudErrorBody	Felhőhiba törzse.

CloudErrorBody

Tárgy

Hibaválasz a szolgáltatástól.

Name	Típus	Description
code	string	A hiba azonosítója. A kódok invariánsak, és programozott módon használhatók.
details	CloudErrorBody[]	A hiba további részleteinek listája.
message	string	A hibát leíró üzenet, amely alkalmas a felhasználói felületen való megjelenítésre.
target	string	Az adott hiba célja. Például a tulajdonság neve hibás.

ExpressRouteLink

Tárgy

ExpressRouteLink

Name	Típus	Description
etag	string	Egyedi írásvédett sztring, amely az erőforrás frissítésekor változik.
id	string	Erőforrás-azonosító.
name	string	A szülő gyermekport-erőforrásai között egyedi gyermekport-erőforrás neve.
properties.adminState	ExpressRouteLinkAdminState	A fizikai port felügyeleti állapota.
properties.coloLocation	string	Cololocation az ExpressRoute Hybrid Directhez.
properties.connectorType	ExpressRouteLinkConnectorType	Fizikai szálas port típusa.
properties.interfaceName	string	Az Azure-útválasztó felületének neve.
properties.macSecConfig	ExpressRouteLinkMacSecConfig	Az ExpressRouteLink Mac biztonsági konfigurációjának meghatározása. MacSec-konfiguráció.
properties.patchPanelId	string	Leképezés a fizikai port és a patch panel portja között.
properties.provisioningState	ProvisioningState	Az expressz útvonalkapcsolati erőforrás kiépítési állapota.
properties.rackId	string	A fizikai patch panel leképezése az állványhoz.
properties.routerName	string	A fizikai porthoz társított Azure-útválasztó neve.

ExpressRouteLinkAdminState

Felsorolás

A fizikai port felügyeleti állapota.

Érték	Description
Enabled	Engedélyezett
Disabled	Disabled

ExpressRouteLinkConnectorType

Felsorolás

Fizikai szálas port típusa.

Érték	Description
LC	LC
SC	SC

ExpressRouteLinkMacSecCipher

Felsorolás

Mac biztonsági titkosítás.

Érték	Description
GcmAes256	GcmAes256
GcmAes128	GcmAes128
GcmAesXpn128	GcmAesXpn128
GcmAesXpn256	GcmAesXpn256

ExpressRouteLinkMacSecConfig

Tárgy

Az ExpressRouteLink Mac biztonsági konfigurációjának meghatározása.

Name	Típus	Description
cakSecretIdentifier	string	Keyvault Titkos azonosító URL-címe, amely Mac biztonsági CAK-kulcsot tartalmaz.
cipher	ExpressRouteLinkMacSecCipher	Mac biztonsági titkosítás.
cknSecretIdentifier	string	Keyvault Titkos azonosító URL-címe, amely Mac biztonsági CKN-kulcsot tartalmaz.
sciState	ExpressRouteLinkMacSecSciState	A Sci mód engedélyezve/letiltva.

ExpressRouteLinkMacSecSciState

Felsorolás

A Sci mód engedélyezve/letiltva.

Érték	Description
Disabled	Disabled
Enabled	Engedélyezett