Express Route Ports - Get

Služba:: ExpressRoute

Verze rozhraní API:: 2025-05-01

Načte požadovaný prostředek ExpressRoutePort.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
expressRoutePortName	path	True	string	Název ExpressRoutePort.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	ExpressRoutePort	Operace Azure byla úspěšně dokončena.
Other Status Codes	CloudError	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

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

Ukázková odpověď

Stavový kó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"
  }
}

Definice

Name	Description
CloudError	Chybová odpověď ze služby.
CloudErrorBody	Chybová odpověď ze služby.
ExpressRouteLink	Odkaz na ExpressRouteLink
ExpressRouteLinkAdminState	Stav správy fyzického portu
ExpressRouteLinkConnectorType	Typ fyzického portu vlákna.
ExpressRouteLinkMacSecCipher	Šifra zabezpečení Mac.
ExpressRouteLinkMacSecConfig	Definice konfigurace zabezpečení MacRouteLinku na Macu.
ExpressRouteLinkMacSecSciState	Režim SCI je povolený nebo zakázaný.
ExpressRoutePort	ExpressRoute Port
ExpressRoutePortsBillingType	Typ fakturace prostředku ExpressRoutePort.
ExpressRoutePortsEncapsulation	Metoda zapouzdření na fyzických portech
ManagedServiceIdentity	Identita prostředku
ManagedServiceIdentityUserAssignedIdentities
ProvisioningState	Zřizování stavů zdroje.
ResourceIdentityType	Typ identity používané pro prostředek. Typ SystemAssigned, UserAssigned zahrnuje implicitně vytvořenou identitu i sadu identit přiřazených uživatelem. Typ None odebere všechny identity z virtuálního počítače.
SubResource	Odkaz na jiný podsourc.

CloudError

Objekt

Chybová odpověď ze služby.

Name	Typ	Description
error	CloudErrorBody	Tělo chyby cloudu.

CloudErrorBody

Objekt

Chybová odpověď ze služby.

Name	Typ	Description
code	string	Identifikátor chyby. Kódy jsou invariantní a mají být využity programově.
details	CloudErrorBody[]	Seznam dalších podrobností o chybě.
message	string	Zpráva popisující chybu, která má být vhodná pro zobrazení v uživatelském rozhraní.
target	string	Cíl konkrétní chyby. Například název vlastnosti v chybě.

ExpressRouteLink

Objekt

Odkaz na ExpressRouteLink

Name	Typ	Description
etag	string	Jedinečný řetězec jen pro čtení, který se změní při každé aktualizaci prostředku.
id	string	ID prostředku.
name	string	Název prostředku podřízeného portu, který je jedinečný mezi podřízenými prostředky portu nadřazeného objektu.
properties.adminState	ExpressRouteLinkAdminState	Stav správy fyzického portu
properties.coloLocation	string	kolokace pro ExpressRoute Hybrid Direct.
properties.connectorType	ExpressRouteLinkConnectorType	Typ fyzického portu vlákna.
properties.interfaceName	string	Název rozhraní směrovače Azure.
properties.macSecConfig	ExpressRouteLinkMacSecConfig	Definice konfigurace zabezpečení MacRouteLinku na Macu. Konfigurace MacSec.
properties.patchPanelId	string	Mapování mezi fyzickým portem a portem propojovacího panelu.
properties.provisioningState	ProvisioningState	Stav zřizování prostředku propojení Express Route.
properties.rackId	string	Mapování fyzického propojovacího panelu do racku.
properties.routerName	string	Název směrovače Azure přidruženého k fyzickému portu.

ExpressRouteLinkAdminState

Výčet

Stav správy fyzického portu

Hodnota	Description
Enabled	Enabled
Disabled	Disabled

ExpressRouteLinkConnectorType

Výčet

Typ fyzického portu vlákna.

Hodnota	Description
LC	LC
SC	SC

ExpressRouteLinkMacSecCipher

Výčet

Šifra zabezpečení Mac.

Hodnota	Description
GcmAes256	GcmAes256
GcmAes128	GcmAes128
GcmAesXpn128	GcmAesXpn128
GcmAesXpn256	GcmAesXpn256

ExpressRouteLinkMacSecConfig

Objekt

Definice konfigurace zabezpečení MacRouteLinku na Macu.

Name	Typ	Description
cakSecretIdentifier	string	Adresa URL tajného identifikátoru služby Keyvault obsahující klíč CAK zabezpečení Mac.
cipher	ExpressRouteLinkMacSecCipher	Šifra zabezpečení Mac.
cknSecretIdentifier	string	Adresa URL identifikátoru tajného klíče keyvault obsahující klíč CKN zabezpečení systému Mac.
sciState	ExpressRouteLinkMacSecSciState	Režim SCI je povolený nebo zakázaný.

ExpressRouteLinkMacSecSciState

Výčet

Režim SCI je povolený nebo zakázaný.

Hodnota	Description
Disabled	Disabled
Enabled	Enabled