华为云计算 云知识 查询租户的托管专线列表ListHostedDirectConnects
查询租户的托管专线列表ListHostedDirectConnects

 

功能介绍

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

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

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

操作状态,合法值是:ACTIVE, ERROR,PENDING_CREATE,PENDING_UPDATE。ACTIVE:虚拟网关正常ERROR: 虚拟网关异常PENDING_CREATE:创建中PENDING_UPDATE:更新中

枚举值:

  • BUILD

  • PAID

  • APPLY

  • PENDING_SURVEY

  • ACTIVE

  • DOWN

  • ERROR

  • PENDING_DELETE

  • DELETED

  • DENY

  • PENDING_PAY

  • ORDERING

  • ACCEPT

  • REJECTED

apply_time

String

物理专线申请时间

create_time

String

物理专线创建时间

provider_status

String

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

枚举值:

  • ACTIVE

  • DOWN

表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

{
  "request_id" : "a59a3776faa1d055f8124dc7b0977a90",
  "hosted_connects" : [ {
    "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"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

 

上一篇:挂载NFS文件系统到服务器 (Linux) 下一篇:云手机与其他市面解决方案相比有哪些优势?