Express Route Ports - Get

서비스:: ExpressRoute

API 버전:: 2025-05-01

요청된 ExpressRoutePort 리소스를 검색합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
expressRoutePortName	path	True	string	ExpressRoutePort의 이름입니다.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string (uuid)	대상 구독의 ID입니다. 값은 UUID여야 합니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

응답

Name	형식	Description
200 OK	ExpressRoutePort	Azure 작업이 성공적으로 완료되었습니다.
Other Status Codes	CloudError	예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

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

샘플 응답

상태 코드:: 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"
  }
}

정의

Name	Description
CloudError	서비스의 오류 응답입니다.
CloudErrorBody	서비스의 오류 응답입니다.
ExpressRouteLink	ExpressRoute링크
ExpressRouteLinkAdminState	실제 포트의 관리 상태입니다.
ExpressRouteLinkConnectorType	물리적 파이버 포트 유형.
ExpressRouteLinkMacSecCipher	Mac 보안 암호입니다.
ExpressRouteLinkMacSecConfig	ExpressRouteLink Mac 보안 구성의 정의입니다.
ExpressRouteLinkMacSecSciState	Sci 모드 사용/사용 안 함
ExpressRoutePort	ExpressRoute 포트
ExpressRoutePortsBillingType	ExpressRoutePort 리소스의 청구 유형입니다.
ExpressRoutePortsEncapsulation	실제 포트의 캡슐화 메서드입니다.
ManagedServiceIdentity	리소스의 ID입니다.
ManagedServiceIdentityUserAssignedIdentities
ProvisioningState	리소스의 상태를 프로비전합니다.
ResourceIdentityType	리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.
SubResource	다른 하위 리소스에 대한 참조입니다.

CloudError

Object

서비스의 오류 응답입니다.

Name	형식	Description
error	CloudErrorBody	클라우드 오류 본문.

CloudErrorBody

Object

서비스의 오류 응답입니다.

Name	형식	Description
code	string	오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details	CloudErrorBody[]	오류에 대한 추가 세부 정보 목록입니다.
message	string	사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target	string	특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

ExpressRouteLink

Object

ExpressRoute링크

Name	형식	Description
etag	string	리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다.
id	string	리소스 ID입니다.
name	string	부모의 자식 포트 리소스 중 고유한 자식 포트 리소스의 이름입니다.
properties.adminState	ExpressRouteLinkAdminState	실제 포트의 관리 상태입니다.
properties.coloLocation	string	ExpressRoute 하이브리드 다이렉트에 대한 공동 배치입니다.
properties.connectorType	ExpressRouteLinkConnectorType	물리적 파이버 포트 유형.
properties.interfaceName	string	Azure 라우터 인터페이스의 이름입니다.
properties.macSecConfig	ExpressRouteLinkMacSecConfig	ExpressRouteLink Mac 보안 구성의 정의입니다. MacSec 구성.
properties.patchPanelId	string	물리적 포트와 패치 패널 포트 간의 매핑.
properties.provisioningState	ProvisioningState	Express Route 링크 리소스의 프로비저닝 상태입니다.
properties.rackId	string	물리적 패치 패널을 랙에 매핑합니다.
properties.routerName	string	물리적 포트와 연결된 Azure 라우터의 이름입니다.

ExpressRouteLinkAdminState

열거형

실제 포트의 관리 상태입니다.

값	Description
Enabled	활성화됨
Disabled	비활성화

ExpressRouteLinkConnectorType

열거형

물리적 파이버 포트 유형.

값	Description
LC	LC (영어)
SC	사우스 캐롤라이나

ExpressRouteLinkMacSecCipher

열거형

Mac 보안 암호입니다.

값	Description
GcmAes256	GcmAes256
GcmAes128	GcmAes128
GcmAesXpn128	GcmAesXpn128
GcmAesXpn256	GcmAesXpn256

ExpressRouteLinkMacSecConfig

Object

ExpressRouteLink Mac 보안 구성의 정의입니다.

Name	형식	Description
cakSecretIdentifier	string	Mac 보안 CAK 키를 포함하는 Keyvault 비밀 식별자 URL입니다.
cipher	ExpressRouteLinkMacSecCipher	Mac 보안 암호입니다.
cknSecretIdentifier	string	Mac 보안 CKN 키를 포함하는 Keyvault 비밀 식별자 URL입니다.
sciState	ExpressRouteLinkMacSecSciState	Sci 모드 사용/사용 안 함

ExpressRouteLinkMacSecSciState

열거형

Sci 모드 사용/사용 안 함

값	Description
Disabled	비활성화
Enabled	활성화됨

ExpressRoutePort

Object

ExpressRoute 포트

Name	형식	Description
etag	string	리소스를 업데이트할 때마다 변경되는 고유한 읽기 전용 문자열입니다.
id	string	리소스 ID입니다.
identity	ManagedServiceIdentity	구성된 경우 ExpressRoutePort의 ID입니다.
location	string	리소스 위치입니다.
name	string	리소스 이름입니다.
properties.allocationDate	string	승인서에 사용할 물리적 포트 할당 날짜입니다.
properties.bandwidthInGbps	integer (int32)	조달된 포트의 대역폭(Gbps)입니다.
properties.billingType	ExpressRoutePortsBillingType	ExpressRoutePort 리소스의 청구 유형입니다.
properties.circuits	SubResource[]	이 ExpressRoutePort 리소스에 프로비전된 ExpressRoute 회로를 참조합니다.
properties.encapsulation	ExpressRoutePortsEncapsulation	실제 포트의 캡슐화 메서드입니다.
properties.etherType	string	물리적 포트의 Ether 유형입니다.
properties.links	ExpressRouteLink[]	익스프레스루트링크 Sub-Resources ExpressRoutePort 리소스의 실제 링크 집합입니다.
properties.mtu	string	물리적 포트 쌍의 최대 전송 단위입니다.
properties.peeringLocation	string	ExpressRoutePort가 물리적으로 매핑되는 피어링 위치의 이름입니다.
properties.provisionedBandwidthInGbps	number (float)	연결된 회로 대역폭의 Gbps를 집계합니다.
properties.provisioningState	ProvisioningState	Express Route 포트 리소스의 프로비저닝 상태입니다.
properties.resourceGuid	string	Express 경로 포트 리소스의 리소스 GUID 속성입니다.
tags	object	리소스 태그.
type	string	리소스 종류입니다.

ExpressRoutePortsBillingType

열거형

ExpressRoutePort 리소스의 청구 유형입니다.

값	Description
MeteredData	미터데이터(MeteredData)
UnlimitedData	언리미티드데이터

ExpressRoutePortsEncapsulation

열거형

실제 포트의 캡슐화 메서드입니다.

값	Description
Dot1Q	Dot1Q
QinQ	친큐

ManagedServiceIdentity

Object

리소스의 ID입니다.

Name	형식	Description
principalId	string	시스템 할당 ID의 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
tenantId	string	시스템 할당 ID의 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
type	ResourceIdentityType	리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.
userAssignedIdentities	<string, ManagedServiceIdentityUserAssignedIdentities>	리소스와 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

ManagedServiceIdentityUserAssignedIdentities

Object

Name	형식	Description
clientId	string	사용자 할당 ID의 클라이언트 ID입니다.
principalId	string	사용자 할당 ID의 보안 주체 ID입니다.

ProvisioningState

열거형

리소스의 상태를 프로비전합니다.

값	Description
Failed	실패
Succeeded	성공함
Canceled	취소됨
Creating	만드는 중
Updating	업데이트 중
Deleting	삭제 중

ResourceIdentityType

열거형

리소스에 사용되는 ID의 형식입니다. 'SystemAssigned, UserAssigned' 형식에는 암시적으로 생성된 ID와 사용자 할당 ID 집합이 모두 포함됩니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.

값	Description
SystemAssigned	시스템 지정됨
UserAssigned	UserAssigned
SystemAssigned, UserAssigned	SystemAssigned, UserAssigned(시스템할당)
None	없음

SubResource

Object

다른 하위 리소스에 대한 참조입니다.

Name	형식	Description
id	string	리소스 ID입니다.

다음을 통해 공유

Express Route Ports - Get

URI 매개 변수

응답

보안

azure_auth

범위

예제

ExpressRoutePortGet

샘플 요청

샘플 응답

정의

CloudError

CloudErrorBody

ExpressRouteLink

ExpressRouteLinkAdminState

ExpressRouteLinkConnectorType

ExpressRouteLinkMacSecCipher

ExpressRouteLinkMacSecConfig

ExpressRouteLinkMacSecSciState

ExpressRoutePort

ExpressRoutePortsBillingType

ExpressRoutePortsEncapsulation

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

ProvisioningState

ResourceIdentityType

SubResource