更新时间:2024-10-17 GMT+08:00

获取终端节点连接

功能介绍

该接口用于获取终端节点连接。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。

URI

GET /v1.0/{project_id}/clusters/{cluster_id}/vpcepservice/connections

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。获取方法请参见获取项目ID和名称

cluster_id

String

指定待查询的集群ID。

表2 Query参数

参数

是否必选

参数类型

描述

start

Integer

指定查询起始值,默认值为1,即从第1个任务开始查询。

limit

Integer

指定查询个数,默认值为10,即一次查询10个任务信息。

请求参数

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

connections

Array of connections objects

连接信息

vpcServiceName

String

终端节点服务名称

permissions

Array of permissions objects

权限列表

vpcepUpdateSwitch

Boolean

终端节点更新开关。

  • true: 开启终端节点。

  • false: 关闭终端节点。

total_count

Integer

终端节点数量。

表4 connections

参数

参数类型

描述

id

String

终端节点ID。

status

String

终端节点状态。

  • accepted:允许该终端节点连接。

  • rejected:拒绝该终端节点连接。

maxSession

String

最大连接数。

specificationName

String

终端节点名称。

created_at

String

创建时间,格式为ISO8601:CCYY-MM-DDThh:mm:ss。

update_at

String

更新时间。默认为null。

domain_id

String

拥有者。

vpcepIp

String

终端节点IPv4。

vpcepIpv6Address

String

终端节点IPv6。

vpcepDnsName

String

终端节点内网域名。

表5 permissions

参数

参数类型

描述

id

String

id

permission

String

权限

permission_type

String

权限类型

created_at

String

创建时间

请求示例

响应示例

状态码: 200

请求已成功。

{
  "connections" : [ {
    "id" : "54b7f739-31a1-40d0-862b-ac85b83ab2da",
    "status" : "accepted",
    "maxSession" : "3000",
    "specificationName" : "default",
    "vpcepIp" : "192.168.0.122",
    "vpcepIpv6Address" : null,
    "vpcepDnsName" : null,
    "created_at" : "2024-06-11T09:36:24Z",
    "update_at" : null,
    "domain_id" : "db9b76a0d9ae431f8e85e89da2ca867c"
  }, {
    "id" : "e88ad0bc-c2c7-419c-bd9b-a961111f0a42",
    "status" : "accepted",
    "maxSession" : "3000",
    "specificationName" : "default",
    "vpcepIp" : "192.168.0.133",
    "vpcepIpv6Address" : null,
    "vpcepDnsName" : null,
    "created_at" : "2023-10-12T07:33:16Z",
    "update_at" : null,
    "domain_id" : "db9b76a0d9ae431f8e85e89da2ca867c"
  } ],
  "vpcepUpdateSwitch" : false,
  "total_count" : 2,
  "vpcServiceName" : "cn-north-4.css-op-no-delete.cf072729-b076-49db-83d3-020dc9f589bd",
  "permissions" : [ {
    "id" : "432a6429-f377-4168-8b24-feb5885af08c",
    "permission" : "iam:domain::db9b76a0d9ae431f8e85e89da2ca867c",
    "permission_type" : "domainId",
    "created_at" : "2023-10-12T07:33:11Z"
  } ]
}

状态码

状态码

描述

200

请求已成功。

400

非法请求。

建议直接修改该请求,不要重试该请求。

409

服务器在完成请求时发生冲突。

返回该状态码,表明客户端尝试创建的资源已经存在,或者由于冲突请求的更新操作不能被完成。

412

未满足前提条件,服务器未满足请求者在请求中设置的其中一个前提条件。

错误码

请参见错误码