文档首页/云专线 DC/API参考 (联盟区域) /API/专线关联连接/创建专线关联连接
更新时间：2026-01-08 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建专线关联连接

功能介绍

创建专线全域接入网关的关联连接peer-link对象，用于连接企业路由器或者其他接入网关

调用方法

请参见如何调用API。

URI

POST /v3/{project_id}/dcaas/global-dc-gateways/{global_dc_gateway_id}/peer-links

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID

最小长度：0

最大长度：36

global_dc_gateway_id

是

String

全域接入网关ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。 获取Token，请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

最小长度：0

最大长度：10240

表3 请求Body参数

参数

是否必选

参数类型

描述

peer_link

是

peer_link object

创建关联连接请求Body体

表4 peer_link

参数

是否必选

参数类型

描述

name

是

String

关联连接的名称

最小长度：0

最大长度：64

description

否

String

描述信息

最小长度：0

最大长度：128

peer_site

是

peer_site object

连接站点对象

表5 peer_site

参数

是否必选

参数类型

描述

gateway_id

是

String

全域接入网关连接对端的实例(当前ER实例)ID

最小长度：0

最大长度：36

project_id

是

String

对端实例(ER实例)归属的项目ID

最小长度：0

最大长度：36

region_id

是

String

归属的区域ID

最小长度：0

最大长度：36

响应参数

状态码：201

表6 响应Body参数

参数

参数类型

描述

request_id

String

请求ID

peer_link

ExternalCreatePeerLink object

创建关联连接返回对象

表7 ExternalCreatePeerLink

参数

参数类型

描述

id

String

专线对等连接

instance_id

String

专线对等连接实例ID

tenant_id

String

租户ID

name

String

名称

description

String

描述信息

global_dc_gateway_id

String

全域接入网关ID

bandwidth_info

BandwidthInfoExternal object

带宽信息

peer_site

PeerSiteExternal object

连接站点信息

status

String

状态信息。取值范围：

  • ACTIVE：正常

  • ERROR：异常

reason

String

失败原因

created_time

String

创建时间

updated_time

String

更新时间

表8 BandwidthInfoExternal

参数

参数类型

描述

bandwidth_size

Long

带宽值

gcb_id

String

带宽包ID

表9 PeerSiteExternal

参数

参数类型

描述

gateway_id

String

全域接入网关ID

link_id

String

连接ID

region_id

String

局点ID

project_id

String

项目ID

site_code

String

网点编码

type

String

连接类型。取值范围：

  • CC：云连接

  • ER：企业路由器

  • GDGW：全域接入网关

请求示例

专线连接创建请求体

POST https://{dc_endpoint}/v3/b197c48159d44a66b32c538c3f8da89a/dcaas/global-dc-gateways/1c6edc27-5fdb-4dae-ac77-72d47c70ed83/peer-links

{
  "peer_link" : {
    "name" : "dgw-peer-link-94dc",
    "peer_site" : {
      "gateway_id" : "70e29908-12f8-4d5d-9adf-4da5465b91b2",
      "project_id" : "b197c48159d44a66b32c538c3f8da89a",
      "region_id" : "cn-southwest-242"
    }
  }
}

响应示例

状态码：201

Created

专线连接创建返回体

{
  "peer_link" : {
    "name" : "dgw-peer-link-94dc",
    "id" : "d6ea4641-9575-4675-ac4f-906884e37f28",
    "tenant_id" : "b197c48159d44a66b32c538c3f8da89a",
    "description" : null,
    "status" : "PENDING_CREATE",
    "reason" : null,
    "created_time" : "2024-12-12T00:16:40.000Z",
    "global_dc_gateway_id" : "335cb548-0ea0-4aff-80f5-502a2dab5325",
    "bandwidth_info" : {
      "bandwidth_size" : 0,
      "gcb_id" : null
    },
    "peer_site" : {
      "gateway_id" : "70e29908-12f8-4d5d-9adf-4da5465b91b2",
      "link_id" : null,
      "region_id" : "cn-southwest-242",
      "site_code" : "cn-southwest-242",
      "project_id" : "b197c48159d44a66b32c538c3f8da89a",
      "type" : "ER"
    },
    "instance_id" : null
  },
  "request_id" : "196ab00b7bbf03be9187606853d80cee"
}

状态码

状态码

描述

201

Created

错误码

请参见错误码。

父主题：专线关联连接