查询微服务列表
功能介绍
查询微服务列表
调用方法
请参见如何调用API。
URI
POST /v2/{cloudProjectId}/component/list/query
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
cloudProjectId |
是 |
String |
参数解释: 项目ID,获取方式请参见获取项目ID。 约束限制: 不涉及。 取值范围: 32位字符,由数字和字母组成。 默认取值: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
offset |
是 |
Integer |
参数解释: 偏移量,表示从此偏移量开始查询。 约束限制: 不涉及。 取值范围: offset大于等于0。 默认取值: 不涉及。 |
|
limit |
是 |
Integer |
参数解释: 每次查询的条目数量。 约束限制: 不涉及。 取值范围: 大于等于0。 默认取值: 不涉及。 |
|
name |
否 |
String |
参数解释: 微服务名称。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
|
sort_dir |
否 |
String |
参数解释: 排序方向。 约束限制: 不涉及。 取值范围: 不涉及。 默认取值: 不涉及。 |
响应参数
状态码:200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
data |
Array of ComponentVO objects |
参数解释: 数据详情。 取值范围: 不涉及。 |
|
total |
Integer |
参数解释: 记录总数。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 微服务ID。 取值范围: 32位字符,由数字和字母组成。 |
|
name |
String |
参数解释: 微服务名称。 取值范围: 不涉及。 |
|
type |
String |
参数解释: 微服务类型。 取值范围: 不涉及。 |
|
description |
String |
参数解释: 微服务描述。 取值范围: 不涉及。 |
|
status |
String |
参数解释: 微服务状态。 取值范围: 不涉及。 |
|
parent_id |
String |
参数解释: 父ID。 取值范围: 不涉及。 |
|
cloud_project_id |
String |
参数解释: 项目ID。 取值范围: 32位字符,由数字和字母组成。 |
|
repos |
Array of ComponentRepoVO objects |
参数解释: 微服务代码仓。 取值范围: 不涉及。 |
|
is_followed |
Boolean |
参数解释: 组件是否被收藏。 取值范围:
|
|
creator_id |
String |
参数解释: 创建人ID。 取值范围: 32位字符,由数字和字母组成。 |
|
creator_name |
String |
参数解释: 创建人名称。 取值范围: 不涉及。 |
|
create_time |
String |
参数解释: 创建时间。 取值范围: 不涉及。 |
|
updater_id |
String |
参数解释: 更新人ID。 取值范围: 32位字符,由数字和字母组成。 |
|
updater_name |
String |
参数解释: 更新人名称。 取值范围: 不涉及。 |
|
update_time |
String |
参数解释: 更新时间。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
type |
String |
参数解释: 仓库类型。 取值范围: 不涉及。 |
|
repo_id |
String |
参数解释: Repo仓库ID。 取值范围: 不涉及。 |
|
http_url |
String |
参数解释: 仓库HTTP地址。 取值范围: 不涉及。 |
|
git_url |
String |
参数解释: 仓库GIT地址。 取值范围: 不涉及。 |
|
branch |
String |
参数解释: 分支。 取值范围: 不涉及。 |
|
language |
String |
参数解释: 语言。 取值范围: 不涉及。 |
|
endpoint_id |
String |
参数解释: 扩展点ID。 取值范围: 不涉及。 |
请求示例
GET https://{endpoint}/v2/2d09f712e9504b61b034cc8f40e475a8/component/list/query
{
"offset" : 0,
"limit" : 10,
"name" : "",
"sort_dir" : ""
}
响应示例
状态码:200
查询微服务列表响应体
{
"data" : [ {
"id" : "f7ced2341b204d2b82c607c6f0de5b4a",
"name" : "11",
"type" : "microservice",
"description" : null,
"status" : "active",
"parent_id" : null,
"cloud_project_id" : "2d09f712e9504b61b034cc8f40e475a8",
"repos" : null,
"is_followed" : true,
"creator_id" : "05d8ca972f114765a8984795a8aa4d41",
"creator_name" : "north-5",
"create_time" : "1709260209",
"updater_id" : "05d8ca972f114765a8984795a8aa4d41",
"updater_name" : "north-5",
"update_time" : "1719319144"
} ],
"total" : 1
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
查询微服务列表响应体 |
错误码
请参见错误码。