Express Route Ports - List
List all the ExpressRoutePort resources in the specified subscription.
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/ExpressRoutePorts?api-version=2023-09-01
URI Parameters
Name | In | Required | Type | Description |
---|---|---|---|---|
subscription
|
path | True |
string |
The subscription credentials which uniquely identify the Microsoft Azure subscription. The subscription ID forms part of the URI for every service call. |
api-version
|
query | True |
string |
Client API version. |
Responses
Name | Type | Description |
---|---|---|
200 OK |
Request successful. The operation returns a list of ExpressRoutePort resources. If there are no ExpressRoutePort resources then an empty list is returned. |
|
Other Status Codes |
Error response describing why the operation failed. |
Security
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | impersonate your user account |
Examples
ExpressRoutePortList
Sample Request
Sample Response
{
"value": [
{
"name": "portName",
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/expressRoutePorts/portName",
"type": "Microsoft.Network/expressRoutePorts",
"location": "westus",
"properties": {
"provisioningState": "Succeeded",
"peeringLocation": "peeringLocationName",
"bandwidthInGbps": 100,
"provisionedBandwidthInGbps": 0,
"mtu": "1500",
"encapsulation": "QinQ",
"billingType": "UnlimitedData",
"etherType": "0x8100",
"allocationDate": "Friday, July 1, 2018",
"links": [
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/expressRoutePorts/portName/links/link1",
"name": "link1",
"properties": {
"provisioningState": "Succeeded",
"routerName": "router1",
"interfaceName": "Ethernet 0/0",
"patchPanelId": "patchPanelId1",
"rackId": "rackId1",
"coloLocation": "coloLocation1",
"connectorType": "LC",
"adminState": "Disabled"
}
},
{
"id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/expressRoutePorts/portName/links/link2",
"name": "link2",
"properties": {
"provisioningState": "Succeeded",
"routerName": "router2",
"interfaceName": "Ethernet 0/0",
"patchPanelId": "patchPanelId2",
"rackId": "rackId2",
"coloLocation": "coloLocation2",
"connectorType": "LC",
"adminState": "Disabled"
}
}
],
"circuits": []
}
}
]
}
Definitions
Name | Description |
---|---|
Cloud |
An error response from the service. |
Cloud |
An error response from the service. |
Express |
ExpressRouteLink |
Express |
Administrative state of the physical port. |
Express |
Physical fiber port type. |
Express |
Mac security cipher. |
Express |
Definition of ExpressRouteLink Mac Security configuration. |
Express |
Sci mode enabled/disabled. |
Express |
ExpressRoute Port |
Express |
ExpressRoute Port List Result |
Express |
The billing type of the ExpressRoutePort resource. |
Express |
Encapsulation method on physical ports. |
Managed |
Identity for the resource. |
Provisioning |
The current provisioning state. |
Resource |
The type of identity used for the resource. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the virtual machine. |
Sub |
Reference to another subresource. |
User |
The list of user identities associated with resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
CloudError
An error response from the service.
Name | Type | Description |
---|---|---|
error |
Cloud error body. |
CloudErrorBody
An error response from the service.
Name | Type | Description |
---|---|---|
code |
string |
An identifier for the error. Codes are invariant and are intended to be consumed programmatically. |
details |
A list of additional details about the error. |
|
message |
string |
A message describing the error, intended to be suitable for display in a user interface. |
target |
string |
The target of the particular error. For example, the name of the property in error. |
ExpressRouteLink
ExpressRouteLink
Name | Type | Description |
---|---|---|
etag |
string |
A unique read-only string that changes whenever the resource is updated. |
id |
string |
Resource ID. |
name |
string |
Name of child port resource that is unique among child port resources of the parent. |
properties.adminState |
Administrative state of the physical port. |
|
properties.coloLocation |
string |
Cololocation for ExpressRoute Hybrid Direct. |
properties.connectorType |
Physical fiber port type. |
|
properties.interfaceName |
string |
Name of Azure router interface. |
properties.macSecConfig |
Definition of ExpressRouteLink Mac Security configuration. |
|
properties.patchPanelId |
string |
Mapping between physical port to patch panel port. |
properties.provisioningState |
The provisioning state of the express route link resource. |
|
properties.rackId |
string |
Mapping of physical patch panel to rack. |
properties.routerName |
string |
Name of Azure router associated with physical port. |
ExpressRouteLinkAdminState
Administrative state of the physical port.
Name | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ExpressRouteLinkConnectorType
Physical fiber port type.
Name | Type | Description |
---|---|---|
LC |
string |
|
SC |
string |
ExpressRouteLinkMacSecCipher
Mac security cipher.
Name | Type | Description |
---|---|---|
GcmAes128 |
string |
|
GcmAes256 |
string |
|
GcmAesXpn128 |
string |
|
GcmAesXpn256 |
string |
ExpressRouteLinkMacSecConfig
Definition of ExpressRouteLink Mac Security configuration.
Name | Type | Description |
---|---|---|
cakSecretIdentifier |
string |
Keyvault Secret Identifier URL containing Mac security CAK key. |
cipher |
Mac security cipher. |
|
cknSecretIdentifier |
string |
Keyvault Secret Identifier URL containing Mac security CKN key. |
sciState |
Sci mode enabled/disabled. |
ExpressRouteLinkMacSecSciState
Sci mode enabled/disabled.
Name | Type | Description |
---|---|---|
Disabled |
string |
|
Enabled |
string |
ExpressRoutePort
ExpressRoute Port
Name | Type | Description |
---|---|---|
etag |
string |
A unique read-only string that changes whenever the resource is updated. |
id |
string |
Resource ID. |
identity |
The identity of ExpressRoutePort, if configured. |
|
location |
string |
Resource location. |
name |
string |
Resource name. |
properties.allocationDate |
string |
Date of the physical port allocation to be used in Letter of Authorization. |
properties.bandwidthInGbps |
integer |
Bandwidth of procured ports in Gbps. |
properties.billingType |
The billing type of the ExpressRoutePort resource. |
|
properties.circuits |
Reference the ExpressRoute circuit(s) that are provisioned on this ExpressRoutePort resource. |
|
properties.encapsulation |
Encapsulation method on physical ports. |
|
properties.etherType |
string |
Ether type of the physical port. |
properties.links |
ExpressRouteLink Sub-Resources |
|
properties.mtu |
string |
Maximum transmission unit of the physical port pair(s). |
properties.peeringLocation |
string |
The name of the peering location that the ExpressRoutePort is mapped to physically. |
properties.provisionedBandwidthInGbps |
number |
Aggregate Gbps of associated circuit bandwidths. |
properties.provisioningState |
The provisioning state of the express route port resource. |
|
properties.resourceGuid |
string |
The resource GUID property of the express route port resource. |
tags |
object |
Resource tags. |
type |
string |
Resource type. |
ExpressRoutePortListResult
ExpressRoute Port List Result
Name | Type | Description |
---|---|---|
nextLink |
string |
The URL to get the next set of results. |
value |
A list of ExpressRoutePort resources. |
ExpressRoutePortsBillingType
The billing type of the ExpressRoutePort resource.
Name | Type | Description |
---|---|---|
MeteredData |
string |
|
UnlimitedData |
string |
ExpressRoutePortsEncapsulation
Encapsulation method on physical ports.
Name | Type | Description |
---|---|---|
Dot1Q |
string |
|
QinQ |
string |
ManagedServiceIdentity
Identity for the resource.
Name | Type | Description |
---|---|---|
principalId |
string |
The principal id of the system assigned identity. This property will only be provided for a system assigned identity. |
tenantId |
string |
The tenant id of the system assigned identity. This property will only be provided for a system assigned identity. |
type |
The type of identity used for the resource. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the virtual machine. |
|
userAssignedIdentities |
The list of user identities associated with resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'. |
ProvisioningState
The current provisioning state.
Name | Type | Description |
---|---|---|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
ResourceIdentityType
The type of identity used for the resource. The type 'SystemAssigned, UserAssigned' includes both an implicitly created identity and a set of user assigned identities. The type 'None' will remove any identities from the virtual machine.
Name | Type | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
SubResource
Reference to another subresource.
Name | Type | Description |
---|---|---|
id |
string |
Resource ID. |
UserAssignedIdentities
The list of user identities associated with resource. The user identity dictionary key references will be ARM resource ids in the form: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.
Name | Type | Description |
---|---|---|
|