更新时间:2026-09-15 GMT+08:00

查询终端节点

功能介绍

查询终端节点。

URI

GET /v2.1/endpoints/{endpoint_id}

表1 路径参数

参数

是否必选

参数类型

描述

endpoint_id

String

终端节点ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

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

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

endpoint

EndpointResp object

终端节点对象。

表4 EndpointResp

参数

参数类型

描述

id

String

终端节点的ID,UUID形式的一个资源标识。

name

String

终端节点的名称。

direction

String

终端节点方向。

取值:

inbound,表示入站终端节点。

outbound,表示出站终端节点。

status

String

资源状态。

取值范围:
  • ACTIVE:正常

  • PENDING_CREATE:创建中

  • PENDING_DELETE:删除中

  • ERROR:失败

vpc_id

String

终端节点所属的VPC ID。

ipaddress_count

Integer

该终端节点下的IP地址数量。

resolver_rule_count

Integer

该终端节点下的转发规则数量。

仅创建出站终端节点时返回该参数。

create_time

String

创建时间。

格式:yyyy-MM-dd'T'HH:mm:ss.SSS。

update_time

String

更新时间。

格式:yyyy-MM-dd'T'HH:mm:ss.SSS。

请求示例

响应示例

状态码:200

查询终端节点响应。

{
  "endpoint" : {
    "id" : "ff80808169b445ab0169b541bc5c0000",
    "name" : "poi-17",
    "direction" : "inbound",
    "status" : "ACTIVE",
    "vpc_id" : "02443811-acf1-4c22-8f44-e3adf19f6097",
    "ipaddress_count" : 4,
    "resolver_rule_count" : 0,
    "create_time" : "2019-03-25T14:29:37.997",
    "update_time" : "2019-03-25T14:29:37.997"
  }
}

状态码

状态码

描述

200

查询终端节点响应。

错误码

请参见错误码