Express Route Ports - Get

Layanan:: ExpressRoute

Versi API:: 2025-05-01

Mengambil sumber daya ExpressRoutePort yang diminta.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
expressRoutePortName	path	True	string	Nama ExpressRoutePort.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string (uuid)	ID langganan target. Nilainya harus sebuah UUID.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Respons

Nama	Jenis	Deskripsi
200 OK	ExpressRoutePort	Operasi Azure berhasil diselesaikan.
Other Status Codes	CloudError	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

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

Respon sampel

Kode 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"
  }
}

Definisi

Nama	Deskripsi
CloudError	Respons kesalahan dari layanan.
CloudErrorBody	Respons kesalahan dari layanan.
ExpressRouteLink	ExpressRouteLink
ExpressRouteLinkAdminState	Status administratif port fisik.
ExpressRouteLinkConnectorType	Jenis port serat fisik.
ExpressRouteLinkMacSecCipher	Sandi keamanan Mac.
ExpressRouteLinkMacSecConfig	Definisi konfigurasi Keamanan Mac ExpressRouteLink.
ExpressRouteLinkMacSecSciState	Mode Sci diaktifkan/dinonaktifkan.
ExpressRoutePort	Pelabuhan ExpressRoute
ExpressRoutePortsBillingType	Jenis penagihan sumber daya ExpressRoutePort.
ExpressRoutePortsEncapsulation	Metode enkapulasi pada port fisik.
ManagedServiceIdentity	Identitas untuk sumber daya.
ManagedServiceIdentityUserAssignedIdentities
ProvisioningState	Status provisi sumber daya.
ResourceIdentityType	Jenis identitas yang digunakan untuk sumber daya. Jenis 'SystemAssigned, UserAssigned' mencakup identitas yang dibuat secara implisit dan sekumpulan identitas yang ditetapkan pengguna. Jenis 'None' akan menghapus identitas apa pun dari komputer virtual.
SubResource	Referensi ke sub sumber daya lain.

CloudError

Objek

Respons kesalahan dari layanan.

Nama	Jenis	Deskripsi
error	CloudErrorBody	Badan kesalahan cloud.

CloudErrorBody

Objek

Respons kesalahan dari layanan.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
details	CloudErrorBody[]	Daftar detail tambahan tentang kesalahan.
message	string	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
target	string	Target kesalahan tertentu. Misalnya, nama properti dalam kesalahan.

ExpressRouteLink

Objek

ExpressRouteLink

Nama	Jenis	Deskripsi
etag	string	String baca-saja unik yang berubah setiap kali sumber daya diperbarui.
id	string	ID Sumber Daya.
name	string	Nama sumber daya port anak yang unik di antara sumber daya port anak induk.
properties.adminState	ExpressRouteLinkAdminState	Status administratif port fisik.
properties.coloLocation	string	Cololocation untuk ExpressRoute Hybrid Direct.
properties.connectorType	ExpressRouteLinkConnectorType	Jenis port serat fisik.
properties.interfaceName	string	Nama antarmuka router Azure.
properties.macSecConfig	ExpressRouteLinkMacSecConfig	Definisi konfigurasi Keamanan Mac ExpressRouteLink. Konfigurasi MacSec.
properties.patchPanelId	string	Pemetaan antara port fisik ke port panel patch.
properties.provisioningState	ProvisioningState	Status provisi sumber daya tautan rute ekspres.
properties.rackId	string	Pemetaan panel patch fisik ke rak.
properties.routerName	string	Nama router Azure yang terkait dengan port fisik.

ExpressRouteLinkAdminState

Enumerasi

Status administratif port fisik.

Nilai	Deskripsi
Enabled	Enabled
Disabled	Nonaktif

ExpressRouteLinkConnectorType

Enumerasi

Jenis port serat fisik.

Nilai	Deskripsi
LC	LC
SC	SC

ExpressRouteLinkMacSecCipher

Enumerasi

Sandi keamanan Mac.

Nilai	Deskripsi
GcmAes256	GcmAes256
GcmAes128	GcmAes128
GcmAesXpn128	GcmAesXpn128
GcmAesXpn256	GcmAesXpn256

ExpressRouteLinkMacSecConfig

Objek

Definisi konfigurasi Keamanan Mac ExpressRouteLink.

Nama	Jenis	Deskripsi
cakSecretIdentifier	string	URL Pengidentifikasi Rahasia Keyvault yang berisi kunci CAK keamanan Mac.
cipher	ExpressRouteLinkMacSecCipher	Sandi keamanan Mac.
cknSecretIdentifier	string	URL Pengidentifikasi Rahasia Keyvault yang berisi kunci CKN keamanan Mac.
sciState	ExpressRouteLinkMacSecSciState	Mode Sci diaktifkan/dinonaktifkan.

ExpressRouteLinkMacSecSciState

Enumerasi

Mode Sci diaktifkan/dinonaktifkan.

Nilai	Deskripsi
Disabled	Nonaktif
Enabled	Enabled