作业

查询实时作业详情

1.接口说明

接口路径:/hpc/openapi/v2/jobs/{jobId}

请求方式:GET

请求数据类型:

接口描述:查询实时作业的详细信息

2.请求消息

请求参数:

Headers:

名称 类型 必填 描述 示例
tokenstring接口凭证eyJhbGciOiJIUzI1N...

参数:

名称 类型 必填 描述 示例
jobIdstring作业ID5_1

3.请求示例

cURL请求示例

curl --location 'https://api01.xxx.com:65106/hpc/openapi/v2/jobs/35919' \
--header 'Content-Type: application/json' \
--header 'token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjb21wdXRlVXNlciI6InNsdXJtdGVzdCIsImFjY291bnRTdGF0dXMiOiJUcmlhbCIsImNyZWF0b3IiOiJhYyIsInJvbGUiOiIxIiwiZXhwaXJlVGltZSI6IjE2ODU2MDAyMjU2MTUiLCJjbHVzdGVySWQiOiIxMTExMiIsImludm9rZXIiOiI2MDQ4Y2U3YmExNWMyYWYyZThjZWMxMjk5MWVjMTNjZiIsInVzZXIiOiJzbHVybXRlc3QiLCJ1c2VySWQiOiIxMTY1NTA0ODU0MSJ9.iLCKJ8PnDDK0_SA2NPYm1WozUG8D5ojwFqFhwaJCDc8'

Java请求示例

import okhttp3.*;

public class QueryJobDetailByIdDemo {

    public static final String TOKEN = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjb21wdXRlVXNlciI6InNsdXJtdGVzdCIsImFjY291bnRTdGF0dXMiOiJUcmlhbCIsImNyZWF0b3IiOiJhYyIsInJvbGUiOiIxIiwiZXhwaXJlVGltZSI6IjE2ODY5MDg1MDkyMzEiLCJjbHVzdGVySWQiOiIxMTExMiIsImludm9rZXIiOiI2MDQ4Y2U3YmExNWMyYWYyZThjZWMxMjk5MWVjMTNjZiIsInVzZXIiOiJzbHVybXRlc3QiLCJ1c2VySWQiOiIxMTY1NTA0ODU0MSJ9.U7pZKgO_K6NuRwOWPxblDfgRpGeVxS-BYieOdLhGDK4";

    public static void main(String[] args) throws Exception {
        OkHttpClient client = new OkHttpClient().newBuilder()
                .build();
        Request request = new Request.Builder()
                .url("https://api01.xxx.com:65106/hpc/openapi/v2/jobs/35946")
                .method("GET", null)
                .addHeader("Content-Type", "application/json")
                .addHeader("token", TOKEN)
                .build();
        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}

Python请求示例

import requests
import json

url = "https://api01.xxx.com:65106/hpc/openapi/v2/jobs/35919"

payload = {}
headers = {
  'Content-Type': 'application/json',
  'token': 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjb21wdXRlVXNlciI6InNsdXJtdGVzdCIsImFjY291bnRTdGF0dXMiOiJUcmlhbCIsImNyZWF0b3IiOiJhYyIsInJvbGUiOiIxIiwiZXhwaXJlVGltZSI6IjE2ODU2MDAyMjU2MTUiLCJjbHVzdGVySWQiOiIxMTExMiIsImludm9rZXIiOiI2MDQ4Y2U3YmExNWMyYWYyZThjZWMxMjk5MWVjMTNjZiIsInVzZXIiOiJzbHVybXRlc3QiLCJ1c2VySWQiOiIxMTY1NTA0ODU0MSJ9.iLCKJ8PnDDK0_SA2NPYm1WozUG8D5ojwFqFhwaJCDc8'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

4.响应消息

返回参数:

名称 类型 描述 示例
msgstring信息success
codestring状态码0
dataobject作业对象0
appTypestring应用类型FLUENT
aveRSSstring作业运行状态占用的物理内存217404K
aveVMSizestring作业运行状态占用的虚拟内存1150244K
cpuTimeUsedstring占用CPU时间
dcuNumReqlong请求的DCU数量
dcuNumUsedlong使用的DCU数量
errorPathstring错误输出路径/public/home/demo/00-HPC-CASE/FLUENT_1027_105403/std.err.111
exitCodestring作业退出码
gpuNumReqlong请求的GPU数量0
gpuNumUsedlong使用的GPU数量0
jobEndTimestring作业结束时间
jobIdstring作业ID111
jobInitAttrmap作业的原始信息
Accountstringdemo
AccrueTimestring2021-11-04T20:47:16
AllocNode:Sidmapnode248:23026
BatchFlagstring1
CPUs/Taskstring1
Commandstring/public/home/demo/00-HPC-CASE/FLUENT_1027_105403/job_FLUENT.slurm
CommandExiststringtrue
CommentstringFLUENT
Contiguousstring0
CoreSpecstring*
DeadlinestringN/A
DelayBootstring00:00:00
Dependencystring
EligibleTimestring2021-11-04T20:47:16
EndTimestring2021-11-05T20:47:17
ExcNodeListstring
ExitCodestring0:0
Featuresstring
GroupIdstringdemo(1001)
JobIdstring111
JobNamestringFLUENT_1104_210037
JobStatestringRUNNING
Licensesstring
MCS_labelstringN/A
MinCPUsNodestring
MinTmpDiskNodestring0
Networkstring
Nicestring0
NodeListstringnode248
NtasksPerN:B:S:Cstring2:0:*:*
NumCPUsstring2
NumNodesstring1
NumTasksstring2
OverSubscribestringOK
Partitionstringdebug
Powerstring
Prioritystring1000
QOSstringuser_demo
ReasonstringNone
Rebootstring0
ReqB:S:C:Tint0:0:*:*
ReqNodeListstring
Requeuestring1
Restartsstring0
RunTimestring00:00:15
BatchHoststringnode248
SecsPreSuspendstring0 LastSchedEval=2021-11-04T20:47:17
Socks/Nodestring*
StartTimestring2021-11-04T20:47:17
StdErrstring/public/home/demo/00-HPC-CASE/FLUENT_1027_105403/std.err.111
StdInstring/dev/null
StdOutstring/public/home/demo/00-HPC-CASE/FLUENT_1027_105403/std.out.111
SubmitTimestring2021-11-04T20:47:16
SuspendTimestringNone
TRESintcpu=2,mem=4306M,node=1,billing=2
TimeLimitstring1-00:00:00
TimeMinstringN/A
UserIdstringtest(1001)
WorkDirstring/public/home/test/00-HPC-CASE/FLUENT_1027_105403
jobNamestring作业名称FLUENT_1104_210037
jobRunTimestring作业运行时间00:00:15
jobStartTimestring作业开始时间2021-11-04 20:47:17
jobStatusstring作业状态statR
jobSubmitTimestring作业提交时间2021-11-04 20:47:16
jobVncSessionInfoobject作业的VNC信息(作业未用到vnc则为空)
archivestringVncViewer.jar文件VncViewer.jar
iClientNumberint连接该会话的客户端数0
iPixelDepthstring0
listClientsarray会话客户端地址列表
localestring编码方式zh_CN.UTF-8
loginPasswdstring会话登录密码0449d1b0
mapSessionExtraAttrsmap其它会话属性
strAuthTypestring认证方式
strGeometrystring宽和高1280x1088
strJobManagerAddrstring会话所属区域的地址10.0.35.248
strJobManagerIDstring调度器ID1634819344
strJobManagerNamestring会话所属区域的名称Cluster_node248
strRelateJobIDstring相关作业号111
strServerAddrstring会话所在主机的地址10.0.35.248
strServerNamestring会话所在主机的主机名node248
strSessionCTimestring会话创建时间2021-11-04 20:47:23
strSessionHeightstring会话高度1088
strSessionIDstring会话ID号1
strSessionOwnerstring会话所有者test
strSessionTypestring会话类型
strSessionWidthstring会话宽度1280
vncCodestringVncViewer.class 文件com.tigervnc.vncviewer.VncViewer.class
jobmanagerIdstring调度器ID1634819344
jobmanagerNamestring调度器名称Cluster_node248
jobmanagerTypestring调度器类型slrum/pbs
memUsedstring占用物理内存,格式为字符串(字符串中带有单位),单位为M4306M
nodeNumReqstring请求的节点数1
nodeUsedstring使用的节点(节点名称字符串,包含使用CPU的节点和使用GPU的节点),多个节点用加号连接node248
outputPathstring标准输出路径/public/home/test/00-HPC-CASE/FLUENT_1027_105403/std.out.111
prioritystring作业优先级1000
procNumReqstring请求的CPU数2
procNumUsedstring使用的CPU个数2
queuestring队列debug
restartsstring作业的重启次数0
scalestring作业规模
userstring用户test
walltimeReqstring请求的Walltime时间1-00:00:00
workDirstring工作路径/public/home/test/00-HPC-CASE/FLUENT_1027_105403

返回示例:

{
    "code": "0",
    "msg": "success",
    "data": {
        "jobId": "23",
        "jobName": "STDIN_0910_094758",
        "jobStatus": "statR",
        "queue": "debug",
        "user": "test",
        "jobSubmitTime": "2021-12-10 15:10:17",
        "jobStartTime": "2021-12-10 15:10:17",
        "jobEndTime": null,
        "exitCode": null,
        "nodeUsed": "h04r3n07",
        "procNumUsed": 1,
        "gpuNumUsed": 0,
        "dcuNumUsed": null,
        "memUsed": "3826M",
        "cpuTimeUsed": null,
        "jobRunTime": "01:10:59",
        "walltimeReq": "1-00:00:00",
        "nodeNumReq": 1,
        "procNumReq": 1,
        "gpuNumReq": 0,
        "dcuNumReq": null,
        "workDir": "/public/home/test/BASE/STDIN_1210_114429",
        "errorPath": "/public/home/test/BASE/STDIN_1210_114429/std.err.23",
        "outputPath": "/public/home/test/BASE/STDIN_1210_114429/std.out.23",
        "priority": "1000",
        "account": null,
        "appType": "BASE",
        "scale": null,
        "jobVncSessionInfo": null,
        "jobInitAttr": {
            "Account": "test",
            "DelayBoot": "00:00:00",
            "ExitCode": "0:0",
            "MinCPUsNode": "1 MinMemoryCPU=3826M",
            "Licenses": "",
            "TRES": "cpu=1,mem=3826M,node=1,billing=1",
            "NtasksPerN:B:S:C": "0:0:*:*",
            "Network": "",
            "JobState": "RUNNING",
            "Requeue": "1",
            "CoreSpec": "*",
            "ExcNodeList": "",
            "Contiguous": "0",
            "SuspendTime": "None",
            "Priority": "1000",
            "Restarts": "0",
            "Deadline": "N/A",
            "NodeList": "h04r3n07",
            "StartTime": "2021-12-10T15:10:17",
            "Dependency": "",
            "ReqB:S:C:T": "0:0:*:*",
            "SubmitTime": "2021-12-10T15:10:17",
            "BatchFlag": "1",
            "SecsPreSuspend": "0 LastSchedEval=2021-12-10T15:10:17",
            "WorkDir": "/public/home/test/BASE/STDIN_1210_114429",
            "NumCPUs": "1",
            "NumNodes": "1",
            "TimeMin": "N/A",
            "RunTime": "01:10:59",
            "EndTime": "2021-12-11T15:10:17",
            "JobName": "STDIN_0910_094758",
            "Reason": "None",
            "StdIn": "/dev/null",
            "StdErr": "/public/home/test/BASE/STDIN_1210_114429/std.err.23",
            "AllocNode:Sid": "h04r3n07:14034",
            "OverSubscribe": "OK",
            "MCS_label": "N/A",
            "Nice": "0",
            "Features": "",
            "JobId": "23",
            "TimeLimit": "1-00:00:00",
            "EligibleTime": "2021-12-10T15:10:17",
            "Partition": "debug",
            "Socks/Node": "*",
            "Comment": "BASE",
            "ReqNodeList": "",
            "MinTmpDiskNode": "0",
            "NumTasks": "1",
            "GroupId": "test(10005)",
            "Reboot": "0",
            "QOS": "test_qos",
            "CommandExist": "true",
            "Command": "/public/home/test/BASE/STDIN_1210_114429/job_BASE.slurm",
            "UserId": "test(2002)",
            "BatchHost": "h04r3n07",
            "StdOut": "/public/home/test/BASE/STDIN_1210_114429/std.out.23",
            "AccrueTime": "2021-12-10T15:10:17",
            "CPUs/Task": "1",
            "Power": ""
        },
        "jobmanagerId": "1638523853",
        "jobmanagerName": "Cluster",
        "jobmanagerType": "SLURM",
        "restarts": "0",
        "aveVMSize": "221140K",
        "aveRSS": "1800K|"
    }
}

5.错误码

错误码 说明
0 成功
10001 内部错误
10003 参数不全
10004 参数无效
10007 用户已被冻结
10008 权限不足
10009 没有权限访问接口
10010 文件校验失败
10011 文件过大
10012 连接中断
10013 操作超时
815005 作业提交失败(调度系统没返回)
815007 作业提交失败(调度系统sbatch失败)

results matching ""

    No results matching ""