获取单个容器舰队 - ShowClusterGroup
功能介绍
获取单个容器舰队
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见权限和授权项。
URI
GET /v1/clustergroups/{clustergroupid}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
clustergroupid |
是 |
String |
容器舰队id |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
身份认证信息 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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> |
标签 |
|
annotations |
Map<String,String> |
插件注解 |
|
creationTimestamp |
String |
创建时间 |
|
updateTimestamp |
String |
更新时间 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
ruleNamespaces |
Array of strings |
权限策略关联的命名空间列表 |
|
federationId |
String |
舰队启用联邦ID |
|
description |
String |
描述信息 |
|
dnsSuffix |
Array of strings |
舰队对应联邦的DNS后缀，开启联邦后可见 |
|
federationExpirationTimestamp |
String |
联邦到期时间戳 |
|
policyId |
String |
策略管理id |
|
federationVersion |
String |
舰队启用联邦的版本 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
type |
String |
类型。 |
|
status |
String |
舰队启用的联邦或权限策略的状态 |
|
reason |
String |
状态原因 |
|
message |
String |
状态信息 |
|
lastTransitionTime |
String |
状态更新时间 |
状态码：400
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
- |
状态码：403
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
- |
状态码：404
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
- |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
- |
String |
- |
请求示例
无
响应示例
状态码：200
容器舰队对象
{
"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",
"dnsSuffix" : [ "www.oidc.com" ],
},
"status" : {
"conditions" : [ {
"type" : "Federation",
"status" : "Unavailable",
"reason" : "FederationUnavailable",
"message" : "component volcano-scheduler is unhealthy",
"lastTransitionTime" : "0001-01-01T00:00:00Z"
} ]
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
容器舰队对象 |
|
400 |
客户端请求错误，服务器无法执行请求 |
|
403 |
服务器拒绝执行请求 |
|
404 |
资源不存在 |
|
500 |
服务器内部错误 |
错误码
请参见错误码。
