更新时间:2024-04-22 GMT+08:00

查询服务列表

功能介绍

该API用于获取所有的服务详情。

仅铂金版支持服务相关功能。

URI

GET /v2/{project_id}/edgemgr/services?{name=xxx,limit=xxx,offset=xxx}

表1 Path参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

表2 查询参数

参数

是否必选

参数类型

描述

limit

Long

指定分页查询每页的行数,最大为100,默认值为10。

offset

Long

指定要查询的偏移数量,默认为0。

sorted

String

响应中查询到的服务将按照指定的字段进行排序

name

String

服务名称

app

String

按照相关的应用查询服务

请求参数

表3 请求Header参数

参数

是否必选

类型

描述

Content-Type

String

消息体的类型(格式)

推荐您使用默认值application/json。

X-Auth-Token

String

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

ief-instance-id

String

铂金版实例ID,专业版实例为空值

响应参数

状态码为 200 时:

表4 响应Body参数

参数

参数类型

描述

count

Long

满足条件的端点个数

services

Array of ServiceRespDetail objects

服务列表

表5 ServiceRespDetail

参数

参数类型

描述

created_at

String

创建时间

id

String

服务ID

meta_data

SvcMetadata object

服务的静态属性

project_id

String

租户ID

spec

SvcSpec object

服务的动态属性

updated_at

String

更新时间

表6 SvcMetadata

参数

参数类型

描述

labels

Map<String,String>

自定义标签属性列表

name

String

服务名称,只允许英文小写字母、数字、中划线,最大长度64,英文小写字母开头,数字或小写字母结尾

表7 SvcSpec

参数

参数类型

描述

cluster_ip

String

虚拟服务IP地址

external_ips

Array of strings

外部IP列表(暂不支持)

external_name

String

外部域名(暂不支持)

ports

Array of SvcPort objects

服务需要暴露的端口列表

selector

Map<String,String>

标签选择器,将选择具有指定Label标签的Pod作为管理范围

type

String

服务的类型

表8 SvcPort

参数

参数类型

描述

name

String

服务端口必须进行命名,而且名称只允许是{protocol}-{suffix}这种格式,其中{protocol}可以是tcp、http等,IEF根据在端口上定义的协议来提供对应的路由能力。例如“name:http-0”和“name:tcp-0”是合法的端口名,“name:http2forecast”是非法的端口号。

node_port

String

当spec.type=NodePort时,指定映射到物理机的端口号

port

String

服务监听的端口号

protocol

String

具体的协议,比如TCP

target_port

String

需要转发到后端Pod的端口号

状态码为 500 时:

表9 响应Body参数

参数

参数类型

描述

error_code

String

异常错误信息编码

error_message

String

异常错误信息描述

请求示例

响应示例

状态码

状态码

描述

200

查询成功

500

错误响应

错误码

请参见错误码