查询终端节点列表

功能介绍

该接口用于查询终端节点列表，提供服务访问入口。

URI

• URI格式

  GET /v3/endpoints{?interface, service_id}

• 参数说明

  参数	是否必选	类型	说明
  interface	否	String	终端节点平面。 可能取值为：public，internal或admin。 public： 用户可在公共网络接口上看到。 internal：用户可在内部网络接口上看到。 admin：管理员可以在安全的网络接口上看到。
  service_id	否	String	服务ID。

请求

• Request Header参数说明

  参数	是否必选	类型	说明
  Content-Type	是	String	该字段内容填为“application/json;charset=utf8”。
  X-Auth-Token	是	String	已认证的token。

• 请求样例

  curl -i -k -H 'Accept:application/json' -H 'Content-Type:application/json;charset=utf8' -H "X-Auth-Token:$token" -X GET https://sample.domain.com/v3/endpoints?interface=public&service_id=43cbe5e77aaf4665bbb962062dc1fc9d

响应

• Response Body参数说明

  参数	是否必选	类型	说明
  links	是	dict	终端节点的资源链接。
  endpoints	是	list	终端节点列表。

• endpoints格式说明

  参数	是否必选	类型	说明
  id	是	String	终端节点ID。
  url	是	String	终端节点的地址。
  region	是	String	终端节点的区域。
  region_id	是	String	终端节点的区域ID。
  enabled	是	Boolean	终端节点是否可用。
  interface	是	String	终端节点的平面。
  service_id	是	String	终端节点所属服务的ID。
  links	是	dict	终端节点的资源链接。

• 响应样例（请求成功）

  {
      "endpoints": [
          {
              "region_id": null,
              "links": {
                  "self": "https://sample.domain.com/v3/endpoints/162277d696f54cf592f19b569f85d158"
              },
              "url": "https://sample.domain.com/v3",
              "region": null,
              "enabled": true,
              "interface": "public",
              "service_id": "053d21d488d1463c818132d9d08fb617",
              "id": "162277d696f54cf592f19b569f85d158"
          }
      ],
      "links": {
          "self": "https://sample.domain.com/v3/endpoints?service_id=053d21d488d1463c818132d9d08fb617&interface=public",
          "previous": null,
          "next": null
      }
  }

状态码