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

更新托管专线连接

功能介绍

合作伙伴更新托管专线.

调用方法

请参见如何调用API。

URI

PUT /v3/{project_id}/dcaas/hosted-connects/{hosted_connect_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID

hosted_connect_id

是

String

托管专线连接ID。

最小长度：36

最大长度：36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

最小长度：0

最大长度：10240
表3 请求Body参数

参数

是否必选

参数类型

描述

hosted_connect

否

UpdateHostedDirectConnect object

更新托管专线对象
表4 UpdateHostedDirectConnect

参数

是否必选

参数类型

描述

name

否

String

物理专线的名字

最小长度：0

最大长度：64

description

否

String

物理专线的描述信息

最小长度：0

最大长度：128

bandwidth

否

Integer

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

最小值：2

最大值：400000

peer_location

否

String

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

最小长度：0

最大长度：255

响应参数

状态码： 200

表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

请求示例

更新托管专线连接的名称和描述信息

PUT https://{dc_endpoint}/v3/6fbe9263116a4b68818cf1edce16bc4f/dcaas/hosted-connects/0278b472-ffa5-4eb3-8c0d-979d479f8ef6

{
  "hosted_connect" : {
    "name" : "client-dc-faf1",
    "description" : ""
  }
}

响应示例

状态码： 200

OK

  • 成功更新托管专线连接 
    {
  "hosted_connect" : {
    "id" : "0278b472-ffa5-4eb3-8c0d-979d479f8ef6",
    "name" : "client-dc-faf1",
    "description" : "",
    "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"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 物理连接