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

Имя	В	Обязательно	Тип	Описание
expressRoutePortName	path	True	string	Имя ExpressRoutePort.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя регистронезависимо.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть Универсальным Уникальным Идентификатором (UUID).
api-version	query	True	string minLength: 1	Версия API, используемая для данной операции.

Ответы

Имя	Тип	Описание
200 OK	ExpressRoutePort	Операция Azure успешно завершена.
Other Status Codes	CloudError	Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
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"
  }
}

Определения

Имя	Описание
CloudError	Ответ об ошибке от сервиса.
CloudErrorBody	Ответ об ошибке от сервиса.
ExpressRouteLink	ExpressRouteLink
ExpressRouteLinkAdminState	Административное состояние физического порта.
ExpressRouteLinkConnectorType	Тип физического оптоволоконного порта.
ExpressRouteLinkMacSecCipher	Шифр безопасности Mac.
ExpressRouteLinkMacSecConfig	Определение конфигурации безопасности ExpressRouteLink Mac.
ExpressRouteLinkMacSecSciState	Режим Sci включен или отключен.
ExpressRoutePort	Порт ExpressRoute
ExpressRoutePortsBillingType	Тип выставления счетов ресурса ExpressRoutePort.
ExpressRoutePortsEncapsulation	Метод инкапсуляции для физических портов.
ManagedServiceIdentity	Удостоверение ресурса.
ManagedServiceIdentityUserAssignedIdentities
ProvisioningState	Инициализация состояний ресурса.
ResourceIdentityType	Тип удостоверения, используемого для ресурса. Тип SystemAssigned, UserAssigned включает как неявное созданное удостоверение, так и набор назначенных пользователем удостоверений. Тип "Нет" приведет к удалению удостоверений из виртуальной машины.
SubResource	Ссылка на другой подресурс.

CloudError

Объект

Ответ об ошибке от сервиса.

Имя	Тип	Описание
error	CloudErrorBody	Тело ошибки облака.

CloudErrorBody

Объект

Ответ об ошибке от сервиса.

Имя	Тип	Описание
code	string	Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.
details	CloudErrorBody[]	Список дополнительных сведений об ошибке.
message	string	Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе.
target	string	Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

ExpressRouteLink

Объект

ExpressRouteLink

Имя	Тип	Описание
etag	string	Уникальная строка только для чтения, которая изменяется при обновлении ресурса.
id	string	Идентификатор ресурса.
name	string	Имя дочернего ресурса порта, уникального среди дочерних ресурсов порта родительского порта.
properties.adminState	ExpressRouteLinkAdminState	Административное состояние физического порта.
properties.coloLocation	string	Колоlocation для ExpressRoute Hybrid Direct.
properties.connectorType	ExpressRouteLinkConnectorType	Тип физического оптоволоконного порта.
properties.interfaceName	string	Имя интерфейса маршрутизатора Azure.
properties.macSecConfig	ExpressRouteLinkMacSecConfig	Определение конфигурации безопасности ExpressRouteLink Mac. Конфигурация MacSec.
properties.patchPanelId	string	Сопоставление между физическим портом и портом коммутационной панели.
properties.provisioningState	ProvisioningState	Состояние подготовки ресурса связи экспресс-маршрута.
properties.rackId	string	Сопоставление физической патч-панели со стойкой.
properties.routerName	string	Имя маршрутизатора Azure, связанного с физическим портом.

ExpressRouteLinkAdminState

Перечисление

Административное состояние физического порта.

Значение	Описание
Enabled	Enabled
Disabled	Disabled

ExpressRouteLinkConnectorType

Перечисление

Тип физического оптоволоконного порта.

Значение	Описание
LC	ЛК
SC	SC

ExpressRouteLinkMacSecCipher

Перечисление

Шифр безопасности Mac.

Значение	Описание
GcmAes256	GcmAes256
GcmAes128	GcmAes128
GcmAesXpn128	GcmAesXpn128
GcmAesXpn256	GcmAesXpn256

ExpressRouteLinkMacSecConfig

Объект

Определение конфигурации безопасности ExpressRouteLink Mac.

Имя	Тип	Описание
cakSecretIdentifier	string	URL-адрес секретного идентификатора Keyvault, содержащий ключ CAK безопасности Mac.
cipher	ExpressRouteLinkMacSecCipher	Шифр безопасности Mac.
cknSecretIdentifier	string	URL-адрес секретного идентификатора Keyvault, содержащий ключ CKN безопасности Mac.
sciState	ExpressRouteLinkMacSecSciState	Режим Sci включен или отключен.

ExpressRouteLinkMacSecSciState

Перечисление

Режим Sci включен или отключен.

Значение	Описание
Disabled	Disabled
Enabled	Enabled