可通过 cluster_type 参数区分获取 EHPC 集群列表。

Action

/cluster/list

请求方式

GET

请求参数

参数 类型 是否必要 描述

timestamp

date-time

true

时间戳

zone

string

true

所属区域 id

owner

string

true

owner

cluster_id

string

false

hpc 集群的集群 id,若加上此参数则会精确查找集群。

cluster_type

string

false

hpc 集群的类型,若请求时不增加此参数,则会获取当前用户下的活跃、关机、暂停、创建中的集群,请求时加上此参数,则会根据集群类型区分请求。hpc 或者 ehpc。

run_user

string

false

运行作业用户

search_word

string

false

模糊查询,支持 keys:[name]

shared_status

string

false

集群的共享状态

sort_key

string

false

排序键 默认为集群创建时间

status

string

false

查询集群的状态["pending"、"active"、"stopped"、`"suspended"]

limit

int

false

页面显示记录的个数,默认 10,最大 100

offset

int

false

集合偏移量

reverse

int

false

排序操作。
0:ASC
1:DESC

verbose

int

false

是否获取 appcent 相关的集群信息。
0:flase
1:true

响应消息

response elements

参数 类型 取值样例 描述

action

string

响应动作名称

HpcClusterListClusterResponse

total_count

int

统计集群的总数
进行集群查询操作所获取到的集群个数。
HPC 集群可能为0、1
EHPC 集群可能为0、1+

1

ret_code

int

0

执行成功与否,成功为0,其他值则为错误代码

response item

参数 类型 描述 取值样例

cluster_set

list

所获取到的集群详细信息,以列表形式显示。

-

app_cluster

list

集群的 appcent 相关信息,包含集群应用程序动作、信息、应用版本信息、自动缩放步骤、备份信息、 cpu 内存使用情况、客户服务、健康检查、节点、价格、角色总数、虚拟网络角色、不受支持操作、虚拟网络等相关信息

-

app_cluster_id

string

集群 appcent_id

cl-zog7clgi

cluster_id

string

获取到的集群id

ehpc-ut2ua3b0

cluster_name

string

集群名称

test-hpc-kk

cluster_type

string

集群类型可能值:ehpc 或 hpc

hpc

create_time

string

集群创建时间

2021-8-18T13:11:45Z

description

string

  • 集群描述。

  • 可能值创建集群时增加过描述,就会显示描述。

  • " " 这种情况说明在创建集群时未增加描述。

-

nas_id

string

nas id

nas_mout_point

string

获取该集群文件存储的挂载点路径
根据每个集群挂点点不同,获取到的挂载点也不同

/pubilc/shanhe/0704

nas_path

string

nas 路径。根据每个集群所选择的 nas 路径不同,获取到的 nas 路径不同

10.0.0.8@03ib:/lustrefs/shane/0704

nas_shared_path

string

nas 共享路径与 nas 路径一致

/0704

paid_type

string

集群费用支付类可能值:PayForUsed 或 Reserved

PayForUsed

schedule_type

string

调度程序类型:slurm

slurm

toatl_node_count

int

集群所拥有的节点数。
根据集群所拥有的节点数不同,获取到的值也不同。
节点包括登录节点、管控节点、计算节点。

1

cluster_sw

list

集群所拥有的软件列表

-

description

string

  • 对应集群软件描述

  • 集群软件不同对应描述也不同,可能值:vasp、lammp

  • 更多软件信息请点击软件中心。

lammps 20200721 with mpich

hpcsw_id

string

hpc 软件 id
软件不同 id 也不相同

hpcsw_lammps

sw_name

string

软件名称

lammps-mpich

sw_ver

string

软件版本

2020

project_info

list

集群项目信息

-

projet_role

string

项目角色

none

shared_status

string

* 项目共享状态,可能值 * shared:共享状态 * not_shared:未共享

not_shared

示例

请求示例

https://hpc.api.qingcloud.com/api/cluster/list
&owner=usr-vceaHsJu
&verbose=1
&cluster_type=hpc
&COMMON_PARAMS

响应示例

{action: "HpcClusterListClusterResponse"
cluster_set: [
	{app_cluster: {
	app_cluster_id: "cl-jfj8y9zy"
	cluster_id: "hpc-qig9xu97"
	cluster_name: "hpc-test"
	cluster_status: "active"
	cluster_sw: []
	cluster_type: "hpc"
	cpu_hours: 446.200560295289
	create_time: "2021-08-17T09:11:16Z"
	deleted_job_count: 0
	description: " "
	finished_job_count: 2
	mem_hours: 1.76339637934081
	nas_id: "2cgki7pe"
	nas_mount_point: "/public/shanhe/s0723"
	nas_path: "10.0.0.7@o2ib:/lustrefs/shanhe/s0723"
	nas_shared_path: "/s0723"
	paid_type: "PayForUsed"
	pending_job_count: 1
	project_info: {shared_status: "not_shared", project_role: "none"}
	running_job_count: 2
	scheduler_type: "默认调度器"
	stopped_job_count: 1
	total_node_count: 1}
}]
ret_code: 0
total_count: 1}