更新时间:2024-07-25 GMT+08:00

查询租户的托管专线列表

功能介绍

查询合作伙伴创建的托管专线连接列表.

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

租户项目ID

表2 Query参数

参数

是否必选

参数类型

描述

limit

Integer

每页返回的个数。 取值范围:1~2000。

最小值:1

最大值:2000

缺省值:2000

marker

String

上一页最后一条资源记录的ID,为空时为查询第一页。 使用说明:必须与limit一起使用。

最小长度:0

最大长度:36

fields

Array

显示字段列表

数组长度:1 - 5

sort_dir

Array

返回结果按照升序(asc)或降序(desc)排列,默认为asc

sort_key

String

排序字段。

缺省值:id

最小长度:0

最大长度:36

hosting_id

Array

根椐运营专线ID过滤托管专线列表

数组长度:0 - 5

id

Array

根据资源ID过滤实例

数组长度:1 - 5

name

Array

根据名字过滤查询,可查询多个名字。

数组长度:1 - 5

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

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

最小长度:0

最大长度:10240

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

request_id

String

本次操作的请求ID

hosted_connects

Array of HostedDirectConnect objects

托管专线对象信息

page_info

PageInfo object

分页查询页的信息

表5 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
表6 PageInfo

参数

参数类型

描述

previous_marker

String

上一页的marker,值为资源的uuid

最小长度:0

最大长度:36

current_count

Integer

当前列表中资源数量

最小值:0

最大值:2000

next_marker

String

下一页的marker,值为资源的uuid,为空时表示最后一页

最小长度:0

最大长度:36

请求示例

查询合作伙伴创建的托管专线列表

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

响应示例

状态码: 200

OK

状态码

状态码

描述

200

OK

错误码

请参见错误码