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

创建托管专线连接

功能介绍

用于合作伙伴用户最终租户创建托管专线 创建者必须拥有合作伙伴资质，并且已经构建好运营(hosting)专线

调用方法

请参见如何调用API。

URI

POST /v3/{project_id}/dcaas/hosted-connects

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

最小长度：0

最大长度：10240

表3 请求Body参数

参数

是否必选

参数类型

描述

hosted_connect

是

CreateHostedDirectConnect object

创建托管专线参数对象

表4 CreateHostedDirectConnect

参数

是否必选

参数类型

描述

name

否

String

托管物理专线的名字。

最小长度：0

最大长度：64

description

否

String

托管专线的描述信息

最小长度：0

最大长度：128

bandwidth

是

Integer

指定托管专线接入带宽,单位Mbps

最小值：2

最大值：400000

hosting_id

是

String

hosted物理专线对应的hosting物理专线的ID

vlan

是

Integer

指定托管(hosted)专线预分配的vlan

最小值：0

最大值：3999

resource_tenant_id

是

String

为其他租户创建托管专线，指定对应的租户ID

最小长度：0

最大长度：32

peer_location

否

String

物理专线对端所在的物理位置，省/市/街道或IDC名字。

最小长度：0

最大长度：255

响应参数

状态码： 201

表5 响应Body参数

参数

参数类型

描述

request_id

String

操作请求ID

hosted_connect

HostedDirectConnect object

托管专线对象信息

表6 HostedDirectConnect

参数

参数类型

描述

id

String

托管专线ID

最小长度：36

最大长度：36

tenant_id

String

实例所属项目ID。

name

String

物理专线名字

最小长度：0

最大长度：64

description

String

物理专线的描述信息

最小长度：0

最大长度：128

bandwidth

Integer

物理专线接入带宽，单位Mbps。

最小值：2

最大值：400000

location

String

专线的接入位置信息

最小长度：0

最大长度：255

peer_location

String

物理专线对端所在的物理位置，省/市/街道或IDC名字。

最小长度：0

最大长度：255

hosting_id

String

hosted物理专线对应的hosting物理专线的ID

provider

String

专线线路的提供商

admin_state_up

Boolean

管理状态：true或false

缺省值：true

vlan

Integer

hosted物理专线预分配的vlan。

最小值：0

最大值：3999

status

String

操作状态，合法值是： BUILD：已开通 ACTIVE：物理连接正常 DOWN：专线对应的端口处于down的状态，可能存在线路故障等异常。 ERROR：专线配置异常 PENDING_DELETE：删除中 PENDING_UPDATE：更新中 PENDING_CREATE：创建中

枚举值：

  • BUILD
  • ACTIVE
  • DOWN
  • ERROR
  • PENDING_DELETE
  • PENDING_UPDATE
  • PENDING_CREATE

apply_time

String

物理专线申请时间。采用UTC时间格式，格式为：yyyy-MM-ddTHH:mm:ss.SSSZ

create_time

String

物理专线创建时间。采用UTC时间格式，格式为：yyyy-MM-ddTHH:mm:ss.SSSZ

provider_status

String

物理专线的运营商操作状态，合法值是：ACTIVE， DOWN

枚举值：

  • ACTIVE
  • DOWN

port_type

String

物理专线接入接口的类型，支持1G 10G 40G 100G

枚举值：

  • 1G
  • 10G
  • 40G
  • 100G

type

String

物理专线的类型，类型为托管专线（hosted）。

缺省值：hosted

请求示例

创建一个托管物理连接，设置带宽为10，VLAN为441。

POST https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/hosted-connects

{
  "hosted_connect" : {
    "name" : "client-dc-faf1",
    "description" : "Hosted Connect",
    "resource_tenant_id" : "0605768a3300d5762f82c01180692873",
    "hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836",
    "vlan" : 441,
    "bandwidth" : 10
  }
}

响应示例

状态码： 201

Created

  • 成功创建托管专线连接 
    {
  "hosted_connect" : {
    "id" : "0278b472-ffa5-4eb3-8c0d-979d479f8ef6",
    "name" : "client-dc-faf1",
    "description" : "Hosted Connect",
    "tenant_id" : "0605768a3300d5762f82c01180692873",
    "hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836",
    "vlan" : 441,
    "bandwidth" : 10,
    "location" : "ExampleLocation",
    "peer_location" : "",
    "provider" : "ExampleProvider",
    "type" : "hosted",
    "port_type" : "10G",
    "provider_status" : "ACTIVE",
    "status" : "ACTIVE",
    "apply_time" : "2022-07-13T08:25:38.000Z",
    "admin_state_up" : true,
    "create_time" : "2022-07-13T08:25:38.000Z"
  },
  "request_id" : "a59a3776faa1d055f8124dc7b0977a90"
}

状态码

状态码

描述

201

Created

错误码

请参见错误码。

父主题：物理连接