你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Express Route Provider Ports Location - List
检索订阅中的所有 ExpressRouteProviderPorts。
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/expressRouteProviderPorts?api-version=2023-09-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/expressRouteProviderPorts?api-version=2023-09-01&$filter={$filter}
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
subscription
|
path | True |
string |
可以唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。 |
api-version
|
query | True |
string |
客户端 API 版本。 |
$filter
|
query |
string |
要应用于操作的筛选器。 例如,可以使用 $filter=location eq“{state}”。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
请求成功。 该操作返回某个位置的 ExpressRouteProviderPort 资源列表。 如果没有提供程序的端口,则返回空列表。 |
|
Other Status Codes |
描述操作失败原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
ExpressRouteProviderPortList
Sample Request
Sample Response
{
"value": [
{
"id": "/subscriptions/subid/providers/Microsoft.Network/ExpressRoutePortsLocations/SiliconValley/bvtazureixpportpair1",
"type": "Microsoft.Network/expressRouteProviderPort",
"location": "uswest",
"etag": "W/\"c0e6477e-8150-4d4f-9bf6-bb10e6acb63a\"",
"properties": {
"portPairDescriptor": "bvtazureixpportpair1",
"primaryAzurePort": "bvtazureixp01",
"secondaryAzurePort": "bvtazureixp01",
"peeringLocation": "SiliconValley",
"overprovisionFactor": 4,
"portBandwidthInMbps": 4000,
"usedBandwidthInMbps": 2500,
"remainingBandwidthInMbps": 1500
}
},
{
"id": "/subscriptions/subid/providers/Microsoft.Network/ExpressRoutePortsLocations/SiliconValley/bvtazureixpportpair2",
"type": "Microsoft.Network/expressRouteProviderPort",
"location": "uswest",
"etag": "W/\"c0e6477e-8150-4d4f-9bf6-bb10e6acb63a\"",
"properties": {
"portPairDescriptor": "bvtazureixpportpair2",
"primaryAzurePort": "bvtazureixp02",
"secondaryAzurePort": "bvtazureixp02",
"peeringLocation": "seattle",
"overprovisionFactor": 4,
"portBandwidthInMbps": 4000,
"usedBandwidthInMbps": 1200,
"remainingBandwidthInMbps": 1800
}
}
]
}
定义
名称 | 说明 |
---|---|
Cloud |
来自服务的错误响应。 |
Cloud |
来自服务的错误响应。 |
Express |
ExpressRouteProviderPort 资源。 |
Express |
ListExpressRouteProviderPort API 服务调用的响应。 |
CloudError
来自服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
云错误正文。 |
CloudErrorBody
来自服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误的标识符。 代码是固定的,旨在以编程方式使用。 |
details |
有关错误的其他详细信息的列表。 |
|
message |
string |
描述错误的消息,该消息适用于在用户界面中显示。 |
target |
string |
特定错误的目标。 例如,属性的名称出错。 |
ExpressRouteProviderPort
ExpressRouteProviderPort 资源。
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
一个唯一的只读字符串,每当资源更新时都会更改。 |
id |
string |
资源的完全限定的资源 ID。 |
location |
string |
资源位置。 |
name |
string |
资源的名称 |
properties.overprovisionFactor |
integer |
端口对的过度预配因素。 |
properties.peeringLocation |
string |
端口对的对等互连位置。 |
properties.portBandwidthInMbps |
integer |
端口的带宽(以 Mbps 为单位) |
properties.portPairDescriptor |
string |
端口对的名称。 |
properties.primaryAzurePort |
string |
主端口的名称。 |
properties.remainingBandwidthInMbps |
integer |
端口的剩余带宽(以 Mbps 为单位) |
properties.secondaryAzurePort |
string |
辅助端口的名称。 |
properties.usedBandwidthInMbps |
integer |
端口的已用带宽(以 Mbps 为单位) |
tags |
object |
资源标记。 |
type |
string |
资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
ExpressRouteProviderPortListResult
ListExpressRouteProviderPort API 服务调用的响应。
名称 | 类型 | 说明 |
---|---|---|
nextLink |
string |
用于获取下一组结果的 URL。 |
value |
ExpressRouteProviderPort 资源的列表。 |