查询集群详情
功能介绍
查询集群详情接口。
调用方法
请参见如何调用API。
URI
GET /v1.1/{project_id}/clusters/{cluster_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID,获取方法请参见项目ID和账号ID。 |
| cluster_id | 是 | String | 集群ID。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| publicEndpoint | String | 集群绑定的EIP。 |
| instances | Array of ClusterDetailInstance objects | 集群的节点信息,请参见instances参数说明。 |
| security_group_id | String | 安全组id。 |
| subnet_id | String | 子网id。 |
| vpc_id | String | 虚拟私有云ID。 |
| customerConfig | CustomerConfig object | 用户配置信息。 |
| datastore | Datastore object | cdm信息。 |
| isAutoOff | Boolean | 自动关机。 |
| publicEndpointDomainName | String | 集群绑定的EIP域名。 |
| bakExpectedStartTime | String | 开始时间。 |
| bakKeepDay | Integer | 保留时间。 |
| maintainWindow | maintainWindow object | 维护窗口。 |
| recentEvent | Integer | 事件数。 |
| flavorName | String | 规格名称。 |
| azName | String | az名称。 |
| endpointDomainName | String | 对端域名。 |
| publicEndpointStatus | publicEndpointStatus object | EIP状态信息。 |
| isScheduleBootOff | Boolean | 选择是否启用定时开关机功能。定时开关机功能和自动关机功能不可同时开启。 |
| namespace | String | 命名空间。 |
| eipId | String | 弹性ip id。 |
| failedReasons | FailedReasons object | 失败原因。集群处于正常状态时不返回。 |
| dbuser | String | 数据库用户。 |
| links | Array of ClusterLinks objects | 集群连接信息。 |
| clusterMode | String | 集群模式:sharding(分片集群)。 |
| task | ClusterTask object | 任务信息。 |
| created | String | 集群创建时间,格式为ISO8601:YYYY-MM-DDThh:mm:ssZ。 |
| statusDetail | String | 集群状态描述:Normal(正常)。 |
| config_status | String | 集群配置状态:
|
| actionProgress | ActionProgress object | 集群操作进度,任务信息,由key、value组成。key值为正在进行的任务,value值为正在进行任务的进度。示例如 "action_progress":{"SNAPSHOTTING":"16%"}。 |
| name | String | 集群名称。 |
| id | String | 集群ID。 |
| isFrozen | String | 集群是否冻结:0:否,1:是。 |
| actions | Array of strings | 集群配置状态:In-Sync:配置已同步。Applying:配置中。Sync-Failure:配置失败。 |
| updated | String | 集群更新时间,格式为 ISO8601:YYYY-MM-DDThh:mm:ssZ。 |
| status | String | 集群状态:
|
| 参数 | 参数类型 | 描述 |
|---|---|---|
| flavor | flavor object | 节点的虚拟机规格,请参见flavor参数说明(查询集群列表时返回值为null)。 |
| volume | volume object | 节点的磁盘信息,请参见volume参数说明(查询集群列表时返回值为null)。 |
| status | String | 节点状态:
|
| actions | Array of strings | 节点操作状态列表:
|
| type | String | 节点类型,只支持一种类型“cdm”。 |
| id | String | 节点的虚拟机ID。 |
| name | String | 节点的虚拟机名称。 |
| isFrozen | String | 节点是否冻结:0:否。1:是。 |
| components | String | 组件。 |
| config_status | String | 节点配置状态(查询集群列表时为null):
|
| role | String | 实例角色。 |
| group | String | 分组。 |
| links | Array of ClusterLinks objects | 链接信息(查询集群列表时返回值为null)。 |
| paramsGroupId | String | 组件分组id。 |
| publicIp | String | 公网ip。 |
| manageIp | String | 管理ip。 |
| trafficIp | String | 流量ip。 |
| shard_id | String | 分片id。 |
| manage_fix_ip | String | 管理修复ip。 |
| private_ip | String | 私有ip。 |
| internal_ip | String | 内部ip。 |
| resource | Array of Resource objects | 资源信息(查询集群列表时返回值为null)。 |
请求示例
GET /v1.1/1551c7f6c808414d8e9f3c514a170f2e/clusters/bae65496-643e-47ca-84af-948672de7eeb
响应示例
状态码:200
OK。
{
"publicEndpoint" : "49.xx.xx.10",
"instances" : [ {
"flavor" : {
"id" : "fb8fe666-6734-4b11-bc6c-43d11db3c745"
},
"volume" : {
"size" : "100",
"type" : "LOCAL_DISK"
},
"name" : "cdm-c018",
"id" : "635dce67-3df8-4756-b4c7-90e45e687367",
"isFrozen" : "0",
"type" : "cdm",
"actions" : "REBOOTING",
"config_status" : "In-Sync",
"status" : "200"
} ],
"created" : "2018-09-05T08:38:25",
"statusDetail" : "Normal",
"actionProgress" : { },
"name" : "cdm-c018",
"id" : "bae65496-643e-47ca-84af-948672de7eeb",
"isFrozen" : "0",
"actions" : "REBOOTING",
"updated" : "2018-09-05T08:38:25",
"status" : "200"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK。 |
| 400 | 请求错误。 |
| 401 | 鉴权失败。 |
| 403 | 没有操作权限。 |
| 404 | 找不到资源。 |
| 500 | 服务内部错误,具体返回错误码请参考错误码。 |
| 503 | 服务不可用。 |
错误码
请参见错误码。