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

Peering Locations - List

参考

Service:: Peering

API Version:: 2021-01-01

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

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

With optional parameters:

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

URI 参数

名称	在	必需	类型	说明
subscriptionId	path	True	string	Azure 订阅 ID。
api-version	query	True	string	客户端 API 版本。
kind	query	True	string	对等互连的类型。
directPeeringType	query		string	直接对等互连的类型。

响应

名称	类型	说明
200 OK	PeeringLocationListResult	确定
Other Status Codes	ErrorResponse	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

List direct peering locations

List exchange peering locations

List direct peering locations

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

import com.azure.resourcemanager.peering.models.PeeringLocationsKind;

/** Samples for PeeringLocations List. */
public final class Main {
    /*
     * x-ms-original-file: specification/peering/resource-manager/Microsoft.Peering/stable/2021-01-01/examples/ListDirectPeeringLocations.json
     */
    /**
     * Sample code: List direct peering locations.
     *
     * @param manager Entry point to PeeringManager.
     */
    public static void listDirectPeeringLocations(com.azure.resourcemanager.peering.PeeringManager manager) {
        manager.peeringLocations().list(PeeringLocationsKind.DIRECT, null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "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

HTTP
Java

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

import com.azure.resourcemanager.peering.models.PeeringLocationsKind;

/** Samples for PeeringLocations List. */
public final class Main {
    /*
     * x-ms-original-file: specification/peering/resource-manager/Microsoft.Peering/stable/2021-01-01/examples/ListExchangePeeringLocations.json
     */
    /**
     * Sample code: List exchange peering locations.
     *
     * @param manager Entry point to PeeringManager.
     */
    public static void listExchangePeeringLocations(com.azure.resourcemanager.peering.PeeringManager manager) {
        manager.peeringLocations().list(PeeringLocationsKind.EXCHANGE, null, com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "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

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

名称	类型	说明
address	string	直接对等互连设施的地址。
directPeeringType	directPeeringType	直接对等互连的类型。
peeringDBFacilityId	integer	设施的 PeeringDB.com ID。
peeringDBFacilityLink	string	设施 PeeringDB.com URL。

directPeeringType

直接对等互连的类型。

名称	类型	说明
Cdn	string
Edge	string
Internal	string
Ix	string
IxRs	string
Transit	string
Voice	string

ErrorDetail

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

名称	类型	说明
code	string	错误代码。
message	string	错误消息。

ErrorResponse

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

名称	类型	说明
error	ErrorDetail	描述操作失败原因的错误详细信息。

ExchangePeeringFacility

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

名称	类型	说明
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

对等互连的类型。

名称	类型	说明
Direct	string
Exchange	string

PeeringBandwidthOffer

定义对等互连带宽套餐的属性。

名称	类型	说明
offerName	string	带宽套餐的名称。
valueInMbps	integer	带宽套餐的值（以 Mbps 为单位）。