> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/api-reference/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/api-reference/cn/ipt/ip-transit/describeiptransitdatacenters.md).

# DescribeIPTransitDatacenters

## 1. 接口描述

本接口(DescribeIPTransitDatacenters)用于查询IP Transit可连接数据中心。

{% hint style="info" %}
**BGP 档位**

* `routingType=BGP` 的条目会返回 `availableBgpTiers`（该数据中心可选的 BGP 档位：`STANDARD` 普通 / `PREMIUM` 优质）与 `peerAsns`（各档位对应的 Zenlayer 侧对端 AS 号，普通 `29752` / 优质 `21859`），请以 `peerAsns` 为准配置您本地路由器的 BGP 邻居。
* 普通 BGP 仅在部分数据中心开放；仅支持固定带宽计费，带宽只能取固定档位值（如 10000/50000/100000，单位 Mbps；传入非档位值时错误信息中会返回完整的可选档位列表）。
* `zbgRegionId` 非空（基于 router 的 IP Transit）时不支持普通档：返回的 `availableBgpTiers` 只含 `PREMIUM`，`peerAsns` 只含 `21859`；不具备优质档底层能力的数据中心不会出现在结果中。
  {% endhint %}

## 2. 请求参数

以下请求参数列表仅列出了接口中需要的请求参数

| 参数名称        | 必选 | 类型     | 描述                                                                   |
| ----------- | -- | ------ | -------------------------------------------------------------------- |
| peerPortId  | 否  | String | <p>对端数据中心端口 ID。</p><p>传入时查询以该数据中心端口为接入侧的可连接数据中心列表。</p>               |
| peerDcId    | 否  | String | 对端数据中心 ID。                                                           |
| zbgRegionId | 否  | String | <p>ZBG 接入节点 ID。</p><p>非空时查询以该 ZBG 节点为接入侧的 Router RIPT 可连接 DC 列表。</p> |

## 3. 响应结果

| 参数名称       | 类型                                                                                         | 描述                                                       |
| ---------- | ------------------------------------------------------------------------------------------ | -------------------------------------------------------- |
| requestId  | String                                                                                     | <p>唯一请求 ID。</p><p>每次请求都会返回。定位问题时需要提供该次请求的 requestId。</p> |
| supportSet | Array of [IPTransitDatacenter](/api-reference/cn/ipt/datastructure.md#iptransitdatacenter) | 可连接数据中心结果集。                                              |

## 4. 代码示例

{% tabs %}
{% tab title="示例" %}

{% endtab %}

{% tab title="示例1" %}

{% endtab %}

{% tab %}
**1.查询从指定数据中心支持的IPT 数据中心信息。**
{% endtab %}

{% tab %}

```
POST /api/v2/ipt HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeIPTransitDatacenters
<Common Request Params>

Request: 
{
    "peerDcId": "xxxx-xxxx-xxx-xxxx"
}

Response: 
{
    "requestId": "T22D41676-006F-4577-9A0A-3C08DAAD4C6D",
    "response": {
        "requestId": "T22D41676-006F-4577-9A0A-3C08DAAD4C6D",
        "supportSet": [
            {
                "dataCenter": {
                    "dcId": "822b9bd9-44f0-4279-a64d-568f5bc4a77b",
                    "cityName": "Amsterdam",
                    "areaName": "Europe",
                    "dcName": "Equinix AM3",
                    "latitude": 52.35501600,
                    "dcAddress": "Science Park 610, 1098 XH Amsterdam, Netherlands",
                    "countryName": "Netherlands",
                    "longitude": 4.96093800
                },
                "availableRoutingTypes": [
                    {
                        "routingType": "Static",
                        "deliveryType": "Manual",
                        "publicInterconnectNetmasks": [30, 31]
                    },
                    {
                        "routingType": "Gateway",
                        "deliveryType": "Manual",
                        "publicInterconnectNetmasks": [30, 31]
                    },
                    {
                        "routingType": "BGP",
                        "deliveryType": "Auto",
                        "availableBgpRouteTypes": ["ALL_ROUTES", "DEFAULT_ROUTES", "ALL_ROUTES_WITH_DEFAULT_ROUTES"],
                        "availableBgpTiers": ["STANDARD", "PREMIUM"],
                        "peerAsns": [
                            {"tier": "STANDARD", "asn": 29752},
                            {"tier": "PREMIUM", "asn": 21859}
                        ],
                        "publicInterconnectNetmasks": [30, 31]
                    }
                ]
            }
        ]
    }
}
```

{% endtab %}

{% tab title="示例2" %}
**1.查询指定数据中心端口支持的IPT 数据中心信息。**

```
POST /api/v2/ipt HTTP/1.1
Host: console.zenlayer.com
Content-Type: application/json
X-ZC-Action: DescribeIPTransitDatacenters
<Common Request Params>

Request: 
{
    "peerPortId": "your-port-id"
}

Response: 
{
    "requestId": "T22D41676-006F-4577-9A0A-3C08DAAD4C6D",
    "response": {
        "requestId": "T22D41676-006F-4577-9A0A-3C08DAAD4C6D",
        "supportSet": [
            {
                "dataCenter": {
                    "dcId": "822b9bd9-44f0-4279-a64d-568f5bc4a77b",
                    "cityName": "Amsterdam",
                    "areaName": "Europe",
                    "dcName": "Equinix AM3",
                    "latitude": 52.35501600,
                    "dcAddress": "Science Park 610, 1098 XH Amsterdam, Netherlands",
                    "countryName": "Netherlands",
                    "longitude": 4.96093800
                },
                "availableRoutingTypes": [
                    {
                        "routingType": "Static",
                        "deliveryType": "Manual",
                        "publicInterconnectNetmasks": [30, 31]
                    },
                    {
                        "routingType": "Gateway",
                        "deliveryType": "Manual",
                        "publicInterconnectNetmasks": [30, 31]
                    }
                ]
            }
        ]
    }
}
```

{% endtab %}
{% endtabs %}

## 5. 开发者工具

Zenlayer Cloud API 2.0 提供了配套的[开发工具集（SDK）](/api-reference/cn/api-introduction/toolkit.md)，未来会陆续支持更多开发语言，方便快速接入和使用Zenlayer的产品和服务。

## 6. 错误码

下面包含业务逻辑中遇到的错误码，其他错误码见[公共错误码](/api-reference/cn/api-introduction/instruction/commonerrorcode.md)

| HTTP状态码 | 错误码 | 说明 |
| ------- | --- | -- |