调用ListJobs查询作业列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListJobs

系统规定参数。取值：ListJobs
ClusterId String 是 ehpc-hz-FYUr32****

集群ID。
Owner String 否 user1

执行作业的用户。
State String 否 FINISHED

作业状态。取值范围：

  • FINISHED：已完成
  • NOTFINISHED：未完成
Rerunable String 否 false

作业是否支持重新运行。
PageNumber Integer 否 1

当前页码。

起始值：1

默认值：1
PageSize Integer 否 10

分页查询时设置的每页行数。最大值：50

默认值：10

返回数据

名称 类型 示例值 描述
Jobs Array of JobInfo

作业信息数组。
JobInfo
ArrayRequest String 1-10:2

作业队列格式。如果不是队列作业，输出为空。
Comment String jobDescription

作业描述信息。
Id String 2

作业ID。
LastModifyTime String 2018-07-18T17:46:48

作业最后修改时间。
Name String job1

作业名称。
NodeList String ['compute2', 'compute3']

节点列表。
Owner String root

执行作业的用户名。
Priority String 0

处理作业的优先级。数值越小，优先级越高。可能值：0~9
Resources Struct

作业运行所需资源。
Cores Integer 2

作业运行的cpu核数。
Nodes Integer 0

作业运行的节点数量。
ShellPath String ./Temp

运行程序路径。
StartTime String 2018-07-18T17:46:48

作业开始时间。
State String FINISHED

作业状态。可能值：

  • FINISHED：已完成
  • NOTFINISHED：未完成
Stderr String ./Temp

错误输出位置。
Stdout String ./Temp

标准输出位置。
SubmitTime String 2018-07-18T17:46:47

作业提交时间。
PageNumber Integer 1

当前页码。
PageSize Integer 10

分页查询时设置的本页条数。
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

请求ID。
TotalCount Integer 1

列表条目总数。

示例

请求示例

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=ListJobs
&ClusterId=ehpc-hz-FYUr32****
&<公共请求参数>

正常返回示例

XML格式 

<ListJobsResponse>
      <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
      <TotalCount>1</TotalCount>
      <PageNumber>1</PageNumber>
      <PageSize>10</PageSize>
      <Jobs>
            <JobInfo>
                  <Owner>root</Owner>
                  <SubmitTime>2018-07-18T17:46:47</SubmitTime>
                  <Stderr></Stderr>
                  <Comment></Comment>
                  <ArrayRequest></ArrayRequest>
                  <Priority>0</Priority>
                  <Name>job1</Name>
                  <State>FINISHED</State>
                  <LastModifyTime>2018-07-18T17:46:58</LastModifyTime>
                  <Stdout></Stdout>
                  <Id>2</Id>
                  <StartTime>2018-07-18T17:46:48</StartTime>
                  <NodeList>['compute1', 'compute3']</NodeList>
                  <Resources>
                        <Nodes>2</Nodes>
                        <Cores>0</Cores>
                  </Resources>
            </JobInfo>
      </Jobs>
</ListJobsResponse>

JSON格式 

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 10,
    "Jobs": {
        "JobInfo": [
            {
                "Owner": "root",
                "SubmitTime": "2018-07-18T17:46:47",
                "Stderr": "",
                "Comment": "",
                "ArrayRequest": "",
                "Priority": "0",
                "Name": "job1",
                "State": "FINISHED",
                "LastModifyTime": "2018-07-18T17:46:58",
                "Stdout":"",
                "Id": "2",
                "StartTime": "2018-07-18T17:46:48",
                "NodeList":"['compute1', 'compute3']",
                "Resources": {
                    "Nodes": 2,
                    "Cores": 0
                }
            }
        ]
    }
}

错误码

HttpCode 错误码 错误信息 描述
406 AgentError.Job.ListFailure Failed to list jobs: %s 获取作业列表失败: {}
503 ServiceUnavailable The request has failed due to a temporary failure of the server 请求失败，服务暂时不可用

访问错误中心查看更多错误码。