全部产品
云市场

ListJobs

更新时间:2018-08-08 13:55:52

查询作业列表。

描述

查询单个集群中作业列表。

请求参数

字段 类型 是否必须 默认值 描述
Action String - 操作接口名,系统规定参数,取值:ListJobs
RegionId String - 地域ID
ClusterId String - 集群ID
Owner String - 作业owner
State String - 作业状态, finished / notfinish
PageNumber Integer 1 显示的页码,起始值为 1
PageSize Integer 10 每页显示的条数,1-50

返回参数

公共返回参数外返回如下结果:

字段 类型 描述
Jobs Array<JobInfo> 作业信息数组,JobInfo结构见下面的对象描述
TotalCount Integer 列表条目总数
PageNumber Integer 当前页码
PageSize Integer 本页条数

其中,每个JobInfo结构包含以下字段:

字段 类型 描述
Id String 作业ID
Name String 作业名称
Owner String 作业owner
Priority Integer 优先级
State String 作业状态
SubmitTime String 作业提交时间
StartTime String 作业开始时间
LastModifyTime String 作业最后修改时间
Stdout String 标准输出位置
Stderr String 错误输出位置
Comment String 作业当前描述
ArrayRequest String 队列作业的队列输入,例如 1-10:2, 如果不是作队列,可以为空
Resources ResourceType 作业运行所需资源
ShellPath String 运行程序路径
Rerunable String 作业是否可重运行(只有pbs支持)

其中,ResourceType结构包含以下字段:

字段 类型 描述
Nodes String 作业运行的节点数量
Cores String 作业运行的cpu核数

示例

请求示例

  1. https://ehpc.cn-hangzhou.aliyuncs.com/?Action=ListJobs&RegionId=cn-hangzhou&ClusterId=<集群ID>&<公共请求参数>

返回示例

XML格式

  1. <ListJobsResponse>
  2. <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
  3. <TotalCount>1</TotalCount>
  4. <PageNumber>1</PageNumber>
  5. <PageSize>1</PageSize>
  6. <Jobs>
  7. <JobInfo>
  8. <Owner>root</Owner>
  9. <SubmitTime>2018-07-18T17:46:47</SubmitTime>
  10. <Stderr></Stderr>
  11. <Comment></Comment>
  12. <ArrayRequest></ArrayRequest>
  13. <Priority>4294901759</Priority>
  14. <Name>sleepjob.sh</Name>
  15. <State>COMPLETED</State>
  16. <LastModifyTime>2018-07-18T17:46:58</LastModifyTime>
  17. <Stdout></Stdout>
  18. <Id>2</Id>
  19. <StartTime>2018-07-18T17:46:48</StartTime>
  20. <NodeList>['compute1', 'compute3']</NodeList>
  21. <Resources>
  22. <Nodes>2</Nodes>
  23. <Cores>0</Cores>
  24. </Resources>
  25. </JobInfo>
  26. </Jobs>
  27. </ListJobsResponse>

JSON格式

  1. {
  2. "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
  3. "TotalCount": 1,
  4. "PageNumber": 1,
  5. "PageSize": 1,
  6. "Jobs": {
  7. "JobInfo": [
  8. {
  9. "Owner": "root",
  10. "SubmitTime": "2018-07-18T17:46:47",
  11. "Stderr": "",
  12. "Comment": "",
  13. "ArrayRequest": "",
  14. "Priority": "4294901759",
  15. "Name": "sleepjob.sh",
  16. "State": "COMPLETED",
  17. "LastModifyTime": "2018-07-18T17:46:58",
  18. "Stdout":"",
  19. "Id": "2",
  20. "StartTime": "2018-07-18T17:46:48",
  21. "NodeList":"['compute1', 'compute3']",
  22. "Resources": {
  23. "Nodes": 2,
  24. "Cores": 0
  25. }
  26. }
  27. ]
  28. }
  29. }

错误码

查询E-HPC接口错误码请访问 错误码。更多错误码,请访问 API 错误中心