更新时间:2024-03-14 GMT+08:00

查询终端节点列表

功能介绍

查询当前用户下的终端节点的列表。

URI

GET /v1/{project_id}/vpc-endpoints?endpoint_service_name={endpoint_service_name}&vpc_id={vpc_id}&limit={limit}&offset={offset}&id={id}&sort_key={sort_key}&sort_dir={sort_dir}

参数说明如表1所示。
表1 参数说明

参数

是否必选

描述

project_id

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

表2 查询参数

名称

是否必选

参数类型

描述

endpoint_service_name

String

终端节点服务的名称,支持大小写,前后模糊匹配。

vpc_id

String

终端节点所在的VPC的ID。

id

String

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

limit

Integer

查询返回终端节点的数量限制,即每页返回的资源个数。

取值范围:0~1000,取值一般为10,20或者50,默认为10。

offset

Integer

偏移量。

偏移量为一个大于0小于终端节点服务总个数的整数,表示从偏移量后面的终端节点服务开始查询。

sort_key

String

查询结果中终端节点列表的排序字段,取值为:

  • created_at:终端节点的创建时间
  • updated_at:终端节点的更新时间

默认值为created_at。

sort_dir

String

查询结果中终端节点列表的排序方式,取值为:

  • desc:降序排序
  • asc:升序排序

默认值为desc。

请求消息

  • 参数说明

    无。

  • 请求样例
    GET https://{endpoint}/v1/{project_id}/vpc-endpoints

响应消息

  • 参数说明
    表3 响应参数

    参数

    参数类型

    描述

    endpoints

    Array of objects

    终端节点列表,详细内容请参见表4

    total_count

    Integer

    满足查询条件的终端节点总条数,不受分页(即limit、offset参数)影响。

    表4 endpoint要素说明

    属性

    参数类型

    描述

    id

    String

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

    service_type

    String

    终端节点连接的终端节点服务类型。

    • gateway:由运维人员配置。用户无需创建,可直接使用。
    • interface:包括运维人员配置的云服务和用户自己创建的私有服务。其中,运维人员配置的云服务无需创建,用户可直接使用。

    您可以通过创建终端节点创建访问Gateway和Interface类型终端节点服务的终端节点。

    status

    String

    终端节点的连接状态。

    • pendingAcceptance:待接受
    • creating:创建中
    • accepted:已接受
    • rejected:已拒绝
    • failed:失败
    • deleting:删除中

    active_status

    String

    账号状态。

    • arrear_frozen:欠费冻结
    • verify_frozen:未实名认证冻结
    • police_frozen:公安冻结
    • illegal_frozen:违规冻结
    • partner_frozen:合作伙伴冻结
    • active:解冻

    endpoint_service_name

    String

    终端节点服务的名称。

    marker_id

    Integer

    终端节点的报文标识。

    endpoint_service_id

    String

    终端节点服务的ID。

    enable_dns

    Boolean

    是否创建域名。

    • true:创建域名
    • false:不创建域名
    说明:

    当创建连接gateway类型终端节点服务的终端节点时,“enable_dns”设置为true或者false,均不创建域名。

    dns_names

    Array of strings

    访问所连接的终端节点服务的域名。

    说明:

    当创建连接Interface类型终端节点服务的终端节点,且“enable_dns”设置为true时,显示该参数。

    ip

    String

    访问所连接的终端节点服务的IP。

    仅当同时满足如下条件时,返回该参数:

    • 当查询连接interface类型终端节点服务的终端节点时。
    • 终端节点服务启用“连接审批”功能,且已经“接受”连接审批。

      “status”可以是“accepted”或者“rejected(仅支持“接受”连接审批后再“拒绝”的情况)”。

    vpc_id

    String

    终端节点所在的VPC的ID。

    subnet_id

    String

    vpc_id对应VPC下已创建的网络(network)的ID,UUID格式。

    说明:

    仅当查询连接interface类型终端节点服务的终端节点时返回该参数。

    created_at

    String

    终端节点的创建时间。

    采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ

    updated_at

    String

    终端节点的更新时间。

    采用UTC时间格式,格式为:YYYY-MM-DDTHH:MM:SSZ

    project_id

    String

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

    tags

    Array of objects

    资源标签列表,详细内容请参见表5

    error

    Array of objects

    错误信息。

    当终端节点状态异常,即“status”的值为“failed”时,会返回该字段,详细内容请参见表6

    whitelist

    Array of strings

    控制访问终端节点的白名单。

    若未创建,则返回空列表。

    说明:

    创建连接Interface类型终端节点服务的终端节点时,显示此参数。

    enable_whitelist

    Boolean

    是否开启网络ACL隔离。

    • true:开启网络ACL隔离
    • false:不开启网络ACL隔离

    若未指定,则返回false。

    说明:

    创建连接Interface类型终端节点服务的终端节点时,显示此参数。

    routetables

    Array of strings

    路由表ID列表。

    若未指定,返回默认VPC下路由表ID。

    说明:

    创建连接Gateway类型终端节点服务的终端节点时,显示此参数。

    enable_status

    String

    是否启用终端节点。

    • enable:启用。
    • disable:禁用。
    表5 Tags要素说明

    名称

    参数类型

    说明

    key

    String

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

    value

    String

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

    表6 Error要素说明

    属性

    参数类型

    描述

    error_code

    String

    错误编码。

    error_message

    String

    错误信息。

  • 响应样例
    {  
    "endpoints":
     [
        {
          "id":"03184a04-95d5-4555-86c4-e767a371ff99",
          "status":"accepted",
          "ip":"192.168.0.232",
          "marker_id":16777337,
          "active_status":"active",
          "vpc_id":"84758cf5-9c62-43ae-a778-3dbd8370c0a4",
          "service_type":"interface",
          "project_id":"295dacf46a4842fcbf7844dc2dc2489d",
          "subnet_id":"68bfbcc1-dff2-47e4-a9d4-332b9bc1b8de",
          "enable_dns":"true",
          "dns_name":"test123",
          "created_at":"2018-10-18T06:49:46Z",
          "updated_at":"2018-10-18T06:49:50Z",
          "endpoint_service_id":"5133655d-0e28-4090-b669-13f87b355c78",
          "endpoint_service_name":"test123",
          "whitelist":["127.0.0.1"],
          "enable_whitelist":true,
          "tags":
            [
              {
                "key":"test1",
                "value":"test1"
              }
            ]
        },
        {
          "id":"43b0e3b0-eec9-49da-866b-6687b75f9fe5",
          "status":"accepted",
          "ip":"192.168.0.115",
          "marker_id":16777322,
          "active_status":"active",
          "vpc_id":"e251b400-2963-4131-b38a-da81e32026ee",
          "service_type":"interface",
          "project_id":"295dacf46a4842fcbf7844dc2dc2489d",
          "subnet_id":"65528a22-59a1-4972-ba64-88984b3207cd",
          "enable_dns":"true",
          "dns_name":"test123",
          "created_at":"2018-10-18T06:36:20Z",
          "updated_at":"2018-10-18T06:36:24Z",
          "endpoint_service_id":"5133655d-0e28-4090-b669-13f87b355c78",
          "endpoint_service_name":"test123",
          "whitelist":["127.0.0.1"],
          "enable_whitelist":true,
          "tags":
            [
              {
                "key":"test1",
                "value":"test1"
              }
            ]
        }
     ],
     "total_count":2
    }

状态码

状态码请参见状态码