Express Route Ports - Get

Serviço:: ExpressRoute

Versão da API:: 2025-05-01

Recupera o recurso ExpressRoutePort solicitado.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
expressRoutePortName	path	True	string	O nome de ExpressRoutePort.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	ExpressRoutePort	A operação do Azure foi concluída com êxito.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

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

Resposta de exemplo

Código de status:: 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"
  }
}

Definições

Nome	Description
CloudError	Uma resposta de erro do serviço.
CloudErrorBody	Uma resposta de erro do serviço.
ExpressRouteLink	ExpressRouteLink
ExpressRouteLinkAdminState	Estado administrativo da porta física.
ExpressRouteLinkConnectorType	Tipo de porta de fibra física.
ExpressRouteLinkMacSecCipher	Codificação de segurança do Mac.
ExpressRouteLinkMacSecConfig	Definição da configuração de segurança do ExpressRouteLink para Mac.
ExpressRouteLinkMacSecSciState	Modo sci habilitado/desabilitado.
ExpressRoutePort	Porta do ExpressRoute
ExpressRoutePortsBillingType	O tipo de cobrança do recurso ExpressRoutePort.
ExpressRoutePortsEncapsulation	Método de encapsulamento em portas físicas.
ManagedServiceIdentity	Identidade do recurso.
ManagedServiceIdentityUserAssignedIdentities
ProvisioningState	Provisionando estados de um recurso.
ResourceIdentityType	O tipo de identidade usado para o recurso. O tipo 'SystemAssigned, UserAssigned' inclui uma identidade criada implicitamente e um conjunto de identidades atribuídas pelo usuário. O tipo 'None' removerá as identidades da máquina virtual.
SubResource	Referência a outro sub-recurso.

CloudError

Objeto

Uma resposta de erro do serviço.

Nome	Tipo	Description
error	CloudErrorBody	Corpo do erro da nuvem.

CloudErrorBody

Objeto

Uma resposta de erro do serviço.

Nome	Tipo	Description
code	string	Um identificador para o erro. Os códigos são invariáveis e devem ser consumidos programaticamente.
details	CloudErrorBody[]	Uma lista de detalhes adicionais sobre o erro.
message	string	Uma mensagem que descreve o erro, destinada a ser adequada para exibição em uma interface do usuário.
target	string	O destino do erro específico. Por exemplo, o nome da propriedade em erro.

ExpressRouteLink

Objeto

ExpressRouteLink

Nome	Tipo	Description
etag	string	Uma cadeia de caracteres somente leitura exclusiva que é alterada sempre que o recurso é atualizado.
id	string	ID do recurso.
name	string	Nome do recurso de porta filho exclusivo entre os recursos de porta filho do pai.
properties.adminState	ExpressRouteLinkAdminState	Estado administrativo da porta física.
properties.coloLocation	string	Cololocation para ExpressRoute Hybrid Direct.
properties.connectorType	ExpressRouteLinkConnectorType	Tipo de porta de fibra física.
properties.interfaceName	string	Nome da interface do roteador do Azure.
properties.macSecConfig	ExpressRouteLinkMacSecConfig	Definição da configuração de segurança do ExpressRouteLink para Mac. Configuração do MacSec.
properties.patchPanelId	string	Mapeamento entre a porta física e a porta do patch panel.
properties.provisioningState	ProvisioningState	O estado de provisionamento do recurso de link de rota expressa.
properties.rackId	string	Mapeamento do patch panel físico para o rack.
properties.routerName	string	Nome do roteador do Azure associado à porta física.

ExpressRouteLinkAdminState

Enumeração

Estado administrativo da porta física.

Valor	Description
Enabled	Habilitado
Disabled	Desactivado

ExpressRouteLinkConnectorType

Enumeração

Tipo de porta de fibra física.

Valor	Description
LC	LC
SC	SC

ExpressRouteLinkMacSecCipher

Enumeração

Codificação de segurança do Mac.

Valor	Description
GcmAes256	GcmAes256
GcmAes128	GcmAes128
GcmAesXpn128	GcmAesXpn128
GcmAesXpn256	GcmAesXpn256

ExpressRouteLinkMacSecConfig

Objeto

Definição da configuração de segurança do ExpressRouteLink para Mac.

Nome	Tipo	Description
cakSecretIdentifier	string	URL do Identificador de Segredo do Keyvault que contém a chave CAK de segurança do Mac.
cipher	ExpressRouteLinkMacSecCipher	Codificação de segurança do Mac.
cknSecretIdentifier	string	URL do Identificador de Segredo do Keyvault que contém a chave CKN de segurança do Mac.
sciState	ExpressRouteLinkMacSecSciState	Modo sci habilitado/desabilitado.

ExpressRouteLinkMacSecSciState

Enumeração

Modo sci habilitado/desabilitado.

Valor	Description
Disabled	Desactivado
Enabled	Habilitado