你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Peering Locations - List

列出指定对等互连类型的所有可用对等互连位置。

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Peering/peeringLocations?kind={kind}&api-version=2021-01-01
GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Peering/peeringLocations?kind={kind}&directPeeringType={directPeeringType}&api-version=2021-01-01

URI 参数

Name In Required Type Description
subscriptionId
path True
  • string

Azure 订阅 ID。

api-version
query True
  • string

客户端 API 版本。

kind
query True
  • string

对等互连的类型。

directPeeringType
query
  • string

直接对等互连的类型。

响应

Name Type Description
200 OK

OK

Other Status Codes

描述操作失败原因的错误响应。

安全性

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 模拟用户帐户

示例

List direct peering locations
List exchange peering locations

List direct peering locations

Sample Request

GET https://management.azure.com/subscriptions/subId/providers/Microsoft.Peering/peeringLocations?kind=Direct&api-version=2021-01-01

Sample Response

{
  "value": [
    {
      "kind": "Direct",
      "properties": {
        "direct": {
          "peeringFacilities": [
            {
              "address": "address1",
              "directPeeringType": "Edge",
              "peeringDBFacilityId": 99999,
              "peeringDBFacilityLink": "https://www.peeringdb.com/fac/99999"
            },
            {
              "address": "address3",
              "directPeeringType": "Cdn",
              "peeringDBFacilityId": 99999,
              "peeringDBFacilityLink": "https://www.peeringdb.com/fac/99999"
            }
          ],
          "bandwidthOffers": [
            {
              "offerName": "10Gbps",
              "valueInMbps": 10000
            },
            {
              "offerName": "100Gbps",
              "valueInMbps": 100000
            }
          ]
        },
        "peeringLocation": "peeringLocation1",
        "country": "country1"
      },
      "name": "peeringLocation1",
      "id": "/subscriptions/subId/providers/Microsoft.Peering/peeringLocations/peeringLocation1",
      "type": "Microsoft.Peering/peeringLocations"
    },
    {
      "kind": "Direct",
      "properties": {
        "direct": {
          "peeringFacilities": [
            {
              "address": "address2",
              "directPeeringType": "Edge",
              "peeringDBFacilityId": 99999,
              "peeringDBFacilityLink": "https://www.peeringdb.com/fac/99999"
            }
          ],
          "bandwidthOffers": [
            {
              "offerName": "10Gbps",
              "valueInMbps": 10000
            },
            {
              "offerName": "100Gbps",
              "valueInMbps": 100000
            }
          ]
        },
        "peeringLocation": "peeringLocation2",
        "country": "country2"
      },
      "name": "peeringLocation2",
      "id": "/subscriptions/subId/providers/Microsoft.Peering/peeringLocations/peeringLocation2",
      "type": "Microsoft.Peering/peeringLocations"
    }
  ]
}

List exchange peering locations

Sample Request

GET https://management.azure.com/subscriptions/subId/providers/Microsoft.Peering/peeringLocations?kind=Exchange&api-version=2021-01-01

Sample Response

{
  "value": [
    {
      "kind": "Exchange",
      "properties": {
        "exchange": {
          "peeringFacilities": [
            {
              "exchangeName": "name1",
              "bandwidthInMbps": 10000,
              "microsoftIPv4Address": "192.168.131.1",
              "microsoftIPv6Address": "fd00::1:1",
              "facilityIPv4Prefix": "192.168.128.0/17",
              "facilityIPv6Prefix": "fd00::1000:0/98",
              "peeringDBFacilityId": 99999,
              "peeringDBFacilityLink": "https://www.peeringdb.com/ix/99999"
            },
            {
              "exchangeName": "name3",
              "bandwidthInMbps": 10000,
              "microsoftIPv4Address": "192.168.2.2",
              "microsoftIPv6Address": "fd00::2",
              "facilityIPv4Prefix": "192.168.0.0/17",
              "facilityIPv6Prefix": "fd00::0/98",
              "peeringDBFacilityId": 99999,
              "peeringDBFacilityLink": "https://www.peeringdb.com/ix/99999"
            }
          ]
        },
        "peeringLocation": "peeringLocation1",
        "country": "country1"
      },
      "name": "peeringLocation1",
      "id": "/subscriptions/subId/providers/Microsoft.Peering/peeringLocations/peeringLocation1",
      "type": "Microsoft.Peering/peeringLocations"
    },
    {
      "kind": "Exchange",
      "properties": {
        "exchange": {
          "peeringFacilities": [
            {
              "exchangeName": "name2",
              "bandwidthInMbps": 10000,
              "microsoftIPv4Address": "192.168.2.1",
              "microsoftIPv6Address": "fd00::2",
              "facilityIPv4Prefix": "192.168.0.0/16",
              "facilityIPv6Prefix": "fd00::0/98",
              "peeringDBFacilityId": 99999,
              "peeringDBFacilityLink": "https://www.peeringdb.com/ix/99999"
            }
          ]
        },
        "peeringLocation": "peeringLocation2",
        "country": "country2"
      },
      "name": "peeringLocation2",
      "id": "/subscriptions/subId/providers/Microsoft.Peering/peeringLocations/peeringLocation2",
      "type": "Microsoft.Peering/peeringLocations"
    }
  ]
}

定义

DirectPeeringFacility

定义直接对等互连设施的属性。

directPeeringType

直接对等互连的类型。

ErrorDetail

描述操作失败的原因的错误详细信息。

ErrorResponse

指示操作失败的原因的错误响应。

ExchangePeeringFacility

定义交换对等互连设施的属性。

kind

对等互连的类型。

PeeringBandwidthOffer

定义对等互连带宽产品/服务的属性。

PeeringLocation

对等互连位置是可以建立到 Microsoft Cloud Edge 的连接的位置。

PeeringLocationListResult

对等互连位置的分页列表。

PeeringLocationPropertiesDirect

定义直接对等互连位置的属性。

PeeringLocationPropertiesExchange

定义交换对等互连位置的属性。

DirectPeeringFacility

定义直接对等互连设施的属性。

Name Type Description
address
  • string

直接对等互连设施的地址。

directPeeringType

直接对等互连的类型。

peeringDBFacilityId
  • integer

设施的 PeeringDB.com ID。

peeringDBFacilityLink
  • string

设施的 PeeringDB.com URL。

directPeeringType

直接对等互连的类型。

Name Type Description
Cdn
  • string
Edge
  • string
Internal
  • string
Ix
  • string
IxRs
  • string
Transit
  • string
Voice
  • string

ErrorDetail

描述操作失败的原因的错误详细信息。

Name Type Description
code
  • string

错误代码。

message
  • string

错误消息。

ErrorResponse

指示操作失败的原因的错误响应。

Name Type Description
error

描述操作失败的原因的错误详细信息。

ExchangePeeringFacility

定义交换对等互连设施的属性。

Name Type Description
bandwidthInMbps
  • integer

Microsoft 与交换对等互连设施之间的连接带宽。

exchangeName
  • string

交换对等互连设施的名称。

facilityIPv4Prefix
  • string

与交换对等互连设施关联的 IPv4 前缀。

facilityIPv6Prefix
  • string

与交换对等互连设施关联的 IPv6 前缀。

microsoftIPv4Address
  • string

Microsoft 在交换对等互连设施中的 IPv4 地址。

microsoftIPv6Address
  • string

Microsoft 在交换对等互连设施中的 IPv6 地址。

peeringDBFacilityId
  • integer

设施的 PeeringDB.com ID。

peeringDBFacilityLink
  • string

设施的 PeeringDB.com URL。

kind

对等互连的类型。

Name Type Description
Direct
  • string
Exchange
  • string

PeeringBandwidthOffer

定义对等互连带宽产品/服务的属性。

Name Type Description
offerName
  • string

带宽产品/服务的名称。

valueInMbps
  • integer

带宽套餐的值(以 Mbps 为单位)。

PeeringLocation

对等互连位置是可以建立到 Microsoft Cloud Edge 的连接的位置。

Name Type Description
id
  • string

资源的 ID。

kind

对等互连位置支持的对等互连类型。

name
  • string

资源的名称。

properties.azureRegion
  • string

与对等互连位置关联的 Azure 区域。

properties.country
  • string

对等互连位置所在的国家/地区。

properties.direct

定义直接对等互连位置的属性。

properties.exchange

定义交换对等互连位置的属性。

properties.peeringLocation
  • string

对等互连位置的名称。

type
  • string

资源类型。

PeeringLocationListResult

对等互连位置的分页列表。

Name Type Description
nextLink
  • string

用于提取对等互连位置的下一页的链接。

value

对等互连位置的列表。

PeeringLocationPropertiesDirect

定义直接对等互连位置的属性。

Name Type Description
bandwidthOffers

对等互连位置提供的带宽产品/服务列表。

peeringFacilities

对等互连位置的直接对等互连设施列表。

PeeringLocationPropertiesExchange

定义交换对等互连位置的属性。

Name Type Description
peeringFacilities

对等互连位置的交换对等互连设施列表。