获取容器舰队列表
功能介绍
获取所有容器舰队信息
URI
GET /v1/clustergroups
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
limit |
否 |
Integer |
分页获取列表时，页的大小，默认为-1 |
offset |
否 |
Integer |
分页获取列表时，起始偏移量，默认为0 |
order_by |
否 |
String |
分页获取列表时，排序参数，支持 create_at 和 update_at |
order |
否 |
String |
分页获取列表时，排序方向，支持 desc 和 asc |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
身份认证信息 最小长度：1 最大长度：16384 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
items |
Array of ClusterGroup objects |
容器舰队列表信息 |
total |
Integer |
所有页的结果的总数 |
参数 |
参数类型 |
描述 |
|---|---|---|
kind |
String |
API类型，固定值"ClusterGroup"，该值不可修改。 |
apiVersion |
String |
API版本，固定值“v1”，该值不可修改。 |
metadata |
ObjectMeta object |
舰队的基本信息，为集合类的元素类型，包含一组由不同名称定义的属性。 |
spec |
ClusterGroupSpec object |
spec是集合类的元素类型，您对需要管理的对象进行详细描述的主体部分都在spec中给出。UCS通过spec的描述来创建或更新对象。 |
status |
ClusterGroupStatus object |
运行状态信息。集合类的元素类型，用于记录对象在系统中的当前状态信息。 |
参数 |
参数类型 |
描述 |
|---|---|---|
uid |
String |
集群ID |
name |
String |
集群名称。 |
labels |
Map<String,String> |
标签 |
creationTimestamp |
String |
创建时间。它以 RFC3339 形式表示，采用 UTC。 |
updateTimestamp |
String |
更新时间戳 |
请求示例
无
响应示例
状态码： 200
返回容器舰队列表信息
{
"items" : [ {
"kind" : "ClusterGroup",
"apiVersion" : "v1",
"metadata" : {
"name" : "cluster-test",
"uid" : "bffbb35b-7949-11ee-886c-0255ac100037",
"creationTimestamp" : "2023-11-02 06:33:35.558128 +0000 UTC",
"updateTimestamp" : "2023-11-14 06:20:20.446476 +0000 UTC"
},
"spec" : {
"federationId" : "e2f27cc6-82b5-11ee-84e3-0255ac100032",
"federationVersion" : "v1.7.0-t1109",
"dnsSuffix" : [ "www.oidc.com" ]
},
"status" : {
"conditions" : [ {
"type" : "Federation",
"status" : "Unavailable",
"reason" : "FederationUnavailable",
"message" : "component volcano-scheduler is unhealthy",
"lastTransitionTime" : "0001-01-01T00:00:00Z"
} ]
}
}, {
"kind" : "ClusterGroup",
"apiVersion" : "v1",
"metadata" : {
"name" : "cluster-dev",
"uid" : "4557ad49-22bf-11ee-b0c9-0255ac10004b",
"creationTimestamp" : "2023-07-15 03:25:39.253589 +0000 UTC",
"updateTimestamp" : "2023-10-19 11:52:14.509405 +0000 UTC"
},
"spec" : { },
"status" : { }
}, {
"kind" : "ClusterGroup",
"apiVersion" : "v1",
"metadata" : {
"name" : "test0131",
"uid" : "108f5981-a105-11ed-a23e-0255ac100032",
"creationTimestamp" : "2023-01-31 01:17:44.309185 +0000 UTC",
"updateTimestamp" : "2023-06-29 01:02:28.78095 +0000 UTC"
},
"spec" : { },
"status" : { }
} ],
"total" : 3
}
状态码
状态码 |
描述 |
|---|---|
200 |
返回容器舰队列表信息 |
400 |
客户端请求错误，服务器无法执行请求 |
403 |
服务器拒绝执行请求 |
500 |
服务器内部错误 |
错误码
请参见错误码。
