更新时间:2023-12-07 GMT+08:00

查询终端节点服务详情

功能介绍

查询终端节点服务的详细信息。

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

最小长度:1

最大长度:64

vpc_endpoint_service_id

String

终端节点服务的ID。

最小长度:1

最大长度:64

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

Content-Type

String

发送的实体的MIME类型。推荐用户默认使用application/json, 如果API是对象、镜像上传等接口,媒体类型可按照流类型的不同进行确定。

缺省值:application/json

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

id

String

终端节点服务的ID,唯一标识。

最小长度:1

最大长度:64

port_id

String

标识终端节点服务后端资源的ID, 格式为通用唯一识别码(Universally Unique Identifier,下文简称UUID)。取值为:

  • LB类型:负载均衡器内网IP对应的端口ID。

  • VM类型:弹性云服务器IP地址对应的网卡ID。

  • VIP类型:虚拟资源所在物理服务器对应的网卡ID。(该字段已废弃,请优先使用LB类型)

service_name

String

终端节点服务的名称。

最小长度:0

最大长度:128

server_type

String

资源类型。

  • VM:云服务器。

  • VIP:虚拟IP。

  • LB:增强负载均衡型。

vpc_id

String

终端节点服务对应后端资源所在的VPC的ID。

最小长度:1

最大长度:64

approval_enabled

Boolean

是否需要审批。

  • false:不需要审批,创建的终端节点连接直接为accepted状态。

  • true:需要审批,创建的终端节点连接为pendingAcceptance状态, 需要终端节点服务所属用户审核后方可使用。

status

String

终端节点服务的状态。

  • creating:创建中

  • available:可连接

  • failed:失败

  • deleting:删除中

service_type

String

终端节点服务类型。 终端节点服务类型包括“网关(gateway)型”和“接口(interface)型”:

  • gateway:由运维人员配置。用户无需创建,可直接使用。

  • interface:包括运维人员配置的云服务和用户自己创建的私有服务。 其中,运维人员配置的云服务无需创建,用户可直接使用。 您可以通过创建终端节点创建访问Gateway和Interface类型终端节点服务的终端节。

created_at

String

终端节点服务的创建时间。 采用UTC时间格式,格式为:YYYY-MMDDTHH:MM:SSZ

updated_at

String

终端节点服务的更新时间。 采用UTC时间格式,格式为:YYYY-MMDDTHH:MM:SSZ

project_id

String

项目ID,获取方法请参见获取项目ID。

最小长度:1

最大长度:64

cidr_type

String

网段类型。 public:公网网段 internal:内网网段 默认值为internal。

ports

Array of PortList objects

服务开放的端口映射列表,详细内容请参见表4-17 同一个终端节点服务下,不允许重复的端口映射。若多个终端节点服务共用一个port_id,则 终端节点服务之间的所有端口映射的server_port和protocol的组合不能重复。

tcp_proxy

String

用于控制将哪些信息(如客户端的源IP、源端口、marker_id等)携带到服务端。 支持携带的客户端信息包括如下两种类型:

  • TCP TOA:表示将客户端信息插入到tcp option字段中携带至服务端。 说明:仅当后端资源为OBS时,支持TCP TOA类型信息携带方式。

  • Proxy Protocol:表示将客户端信息插入到tcp payload字段中携带至服务端。 仅当服务端支持解析上述字段时,该参数设置才有效。 该参数的取值包括:

  • close:表示关闭代理协议。

  • toa_open:表示开启代理协议“tcp_toa”。

  • proxy_open:表示开启代理协议“proxy_protocol”。

  • open:表示同时开启代理协议“tcp_toa”和“proxy_protocol”。

  • proxy_vni: 关闭toa,开启proxy和vni。 默认值为“close”。

tags

Array of TagList objects

资源标签列表

error

Array of Error objects

提交任务异常时返回的异常信息

enable_policy

Boolean

是否开启终端节点策略。

  • false:不支持设置终端节点策略

  • true:支持设置终端节点策略 默认为false

description

String

描述字段,支持中英文字母、数字等字符,不支持“<”或“>”字符。

最小长度:0

最大长度:512

表4 PortList

参数

参数类型

描述

client_port

Integer

终端节点访问的端口。 终端节点提供给用户,作为访问终端节点服务的端口,范围1-65535。

最小值:1

最大值:65535

最小长度:1

最大长度:65535

server_port

Integer

终端节点服务的端口。 终端节点服务绑定了后端资源,作为提供服务的端口,范围1-65535。

最小值:1

最大值:65535

最小长度:1

最大长度:65535

protocol

String

端口映射协议,支持TCP。

缺省值:TCP

表5 TagList

参数

参数类型

描述

key

String

键。 最大长度36个unicode字符。 key不能为空。不能包含“=”、“*”、“<”、“>”、“\”、“,”、“|”和“/”,且首尾字符不能为空格。

最小长度:1

最大长度:36

value

String

值。 每个值最大长度43个unicode字符,可以为空字符串。 不能包含“=”、“*”、“<”、“>”、“\”、“,”、“|”和“/”,且首尾字符不能为空格。

最小长度:1

最大长度:43

表6 Error

参数

参数类型

描述

message

String

任务异常错误信息描述

最小长度:0

最大长度:1024

code

String

任务异常错误信息编码

最小长度:0

最大长度:10

请求示例

查询终端节点服务详情

GET https://{endpoint}/v1/{project_id}/vpc-endpoint-services/{vpc_endpoint_service_id}

查询ID为“4189d3c2-8882-4871-a3c2-d380272eed88”的终端节点服务详情。 GET https://{endpoint}/v1/{project_id}/vpc-endpoint-services/4189d3c2-8882-4871-a3c2-d380272eed88

响应示例

状态码: 200

服务器已成功处理了请求

{
  "id" : "4189d3c2-8882-4871-a3c2-d380272eed83",
  "port_id" : "4189d3c2-8882-4871-a3c2-d380272eed88",
  "vpc_id" : "4189d3c2-8882-4871-a3c2-d380272eed80",
  "status" : "available",
  "approval_enabled" : false,
  "service_name" : "test123",
  "server_type" : "VM",
  "service_type" : "interface",
  "ports" : [ {
    "client_port" : "8080",
    "server_port" : "80",
    "protocol" : "TCP"
  }, {
    "client_port" : "8081",
    "server_port" : "80",
    "protocol" : "TCP"
  } ],
  "project_id" : "6e9dfd51d1124e8d8498dce894923a0d",
  "created_at" : "2022-04-14T09:35:47Z",
  "updated_at" : "2022-04-14T09:36:47Z"
}

状态码

状态码

描述

200

服务器已成功处理了请求

错误码

请参见错误码