GetJob - 查询作业详情

获取指定作业的详细信息。

调试

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

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
ClusterIdstring

集群 ID。

ehpc-hz-FYUr32****
JobIdstring

作业 ID。通过 ListJobs 接口返回。

1.manager

返回参数

名称类型描述示例值
object

返回参数集合。

RequestIdstring

请求 ID。

04F0****-1335-****-A1D7-6C044FE7****
JobInfoobject

作业详细信息。

JobIdstring

作业 ID。

1.manager
JobNamestring

作业名称。

testJob
RunasUserstring

作业所属的用户,即提交作业时使用的用户。该用户为集群侧的用户。

testuser
Statestring

作业状态。

Running
JobQueuestring

作业所属队列。

workq
CreateTimestring

作业提交时间。

2024-08-16T10:52:48
LastModifyTimestring

作业状态最后修改时间。

2024-08-16T10:52:48
ErrorLogstring

作业错误日志文件。

/home/xxx/STDIN.e1
StartTimestring

作业启动时间。

2024-08-16T10:52:48
Prioritystring

作业优先级。

0
CommandLinestring

作业执行命令。

/home/huangsf/ehpc/job_meta.pbs
OutputLogstring

作业标准输出日志文件。

/home/xxx/STDIN.o1
NodeListstring

作业执行节点列表。

compute000
ArrayRequeststring

作业队列参数。如果不是队列作业,输出为空。

格式为 X-Y:Z, 最小值 X 是第一个索引,最大值 Y 是最后一个索引,Z 表示步长,例如 2-7:2,表示作业队列包含编号为 2、4、6 的 3 个子作业。

1-5:2
Resourcesobject

作业提交时申请的资源数量。

Nodesstring

作业使用的节点数。

1
Coresstring

作业在每个节点上使用的 CPU 核数。

2
Memorystring

作业在每个节点上使用的内存大小。

1gb
Gpusstring

作业在每个节点上使用的 GPU 数量。

1
Variablesarray<object>

作业的变量列表。

Variablesobject

作业的环境变量。

Namestring

环境变量名称。

ProxyIP
Valuestring

环境变量值。

10.x.x.x
ExtraInfostring

其它信息。

{}
ResourcesUsedobject

作业实际使用的资源数量。

Nodesstring

作业使用的总节点数。

2
Coresstring

作业在每个节点上使用的 CPU 核数。

2
Memorystring

作业在每个节点上使用的内存大小。

512mb
ArrayJobIdstring

数组父作业 ID,该返回值为非空字符串时,表示该作业是数组作业。

1
ArrayJobSubIdstring

数组子作业 ID,ArrayJobId 为非空字符串时有效。

3
Successstring

请求结果,可能值:

  • true:请求成功。

  • false:请求失败。

true

示例

正常返回示例

JSON格式

{
  "RequestId": "04F0****-1335-****-A1D7-6C044FE7****",
  "JobInfo": {
    "JobId": "1.manager",
    "JobName": "testJob\n",
    "RunasUser": "testuser",
    "State": "Running",
    "JobQueue": "workq",
    "CreateTime": "2024-08-16T10:52:48",
    "LastModifyTime": "2024-08-16T10:52:48",
    "ErrorLog": "/home/xxx/STDIN.e1",
    "StartTime": "2024-08-16T10:52:48",
    "Priority": 0,
    "CommandLine": "/home/huangsf/ehpc/job_meta.pbs",
    "OutputLog": "/home/xxx/STDIN.o1",
    "NodeList": "compute000",
    "ArrayRequest": "1-5:2",
    "Resources": {
      "Nodes": 1,
      "Cores": 2,
      "Memory": "1gb",
      "Gpus": 1
    },
    "Variables": [
      {
        "Name": "ProxyIP",
        "Value": "10.x.x.x"
      }
    ],
    "ExtraInfo": {},
    "ResourcesUsed": {
      "Nodes": 2,
      "Cores": 2,
      "Memory": "512mb"
    },
    "ArrayJobId": 1,
    "ArrayJobSubId": 3
  },
  "Success": true
}

错误码

HTTP status code错误码错误信息描述
400InvalidParamsThe specified parameter %s is invalid.指定的参数 %s 无效。
403InvalidClusterStatusThe operation failed due to invalid cluster status.集群状态不允许执行本次操作。
404ClusterNotFoundThe specified cluster does not exist.指定的集群不存在,请您检查该参数是否正确。
406DbErrorA database service error occurred.数据库请求失败
406EcsErrorAn error occurred while calling the ECS API operation.ECS API调用出错. %s
406AgentErrorThe agent service request failed: %s操作未成功:%s
503ServiceUnavailableThe request has failed due to a temporary failure of the server请求失败,服务暂时不可用

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

变更历史

变更时间变更内容概要操作
暂无变更历史