文档首页/ 云专线 DC/ API参考 (巴黎) / API/ 物理连接/ 更新托管专线连接
更新时间：2024-07-25 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

物理专线的类型，类型包括标准(standard)，运营专线(hosting)，托管专线（hosted）。

缺省值：standard

枚举值：

  • standard
  • hosting
  • hosted
  • onestop_standard
  • onestop_hosted

请求示例

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

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

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

响应示例

状态码： 200

OK

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 物理连接