创建专线关联连接
功能介绍
创建专线全域接入网关的关联连接peer-link对象,用于连接企业路由器或者其他接入网关
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/dcaas/global-dc-gateways/{global_dc_gateway_id}/peer-links
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
租户项目ID 最小长度:0 最大长度:36 |
|
global_dc_gateway_id |
是 |
String |
全域接入网关ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 获取Token,请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 最小长度:0 最大长度:10240 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
peer_link |
是 |
peer_link object |
创建关联连接请求Body体 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
name |
是 |
String |
关联连接的名称 最小长度:0 最大长度:64 |
|
description |
否 |
String |
描述信息 最小长度:0 最大长度:128 |
|
peer_site |
是 |
peer_site object |
连接站点对象 |
响应参数
状态码:201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
request_id |
String |
请求ID |
|
peer_link |
ExternalCreatePeerLink object |
创建关联连接返回对象 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
状态信息。取值范围:
|
|
reason |
String |
失败原因 |
|
created_time |
String |
创建时间 |
|
updated_time |
String |
更新时间 |
请求示例
专线连接创建请求体
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 |
错误码
请参见错误码。