功能介绍
用于合作伙伴用户最终租户创建托管专线 创建者必须拥有合作伙伴资质，并且已经构建好运营(hosting)专线
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
POST /v3/{project_id}/dcaas/hosted-connects
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
租户项目ID |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 获取Token ，请参考《 统一身份认证 服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 最小长度：0 最大长度：10240 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
操作状态，合法值是：ACTIVE， ERROR，PENDING_CREATE，PENDING_UPDATE。ACTIVE：虚拟网关正常ERROR： 虚拟网关异常PENDING_CREATE：创建中PENDING_UPDATE：更新中 枚举值：
|
|
apply_time |
String |
物理专线申请时间 |
|
create_time |
String |
物理专线创建时间 |
|
provider_status |
String |
物理专线的运营商操作状态，合法值是：ACTIVE， DOWN 枚举值：
|
请求示例
创建一个托管物理连接，设置带宽为10，VLAN为441。
POST https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/hosted-connects
{
"hosted_connect" : {
"name" : "client-dc-faf1",
"description" : "connect to beijing",
"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" : "connect to beijing",
"tenant_id" : "0605768a3300d5762f82c01180692873",
"hosting_id" : "2cfb53be-b05f-40d5-a2f8-3a59ac383836",
"vlan" : 441,
"bandwidth" : 10,
"location" : "hangzhou",
"peer_location" : "",
"provider" : "client-dc-faf1%20\n\n",
"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 |
错误码
请参见错误码。
