Skip to content

作业

查询队列作业统计信息

1.接口说明

接口路径:/hpc/openapi/v2/view/queue/jobs

请求方式:GET

请求数据类型:

接口描述:查询用户队列统计信息

备注:若队列均无作业,则返回null

2.请求消息

请求参数:

Headers:

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

参数:

名称类型必填描述示例
userNamestring用户名test

3.请求示例

cURL请求示例

shell
curl --location 'https://scnet-demo.accloud.cn/hpc/openapi/v2/view/queue/jobs?userName=test' \
--header 'Content-Type: application/json' \
--header 'token: <Token>'

Java请求示例

java
import okhttp3.*;

public class QueryQueueJobStatisticsDemo {

    public static final String TOKEN = "<Token>";

    public static void main(String[] args) throws Exception {
        OkHttpClient client = new OkHttpClient().newBuilder()
                .build();
        Request request = new Request.Builder()
                .url("https://scnet-demo.accloud.cn/hpc/openapi/v2/view/queue/jobs?userName=test")
                .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请求示例

python
import requests
import json

url = "https://scnet-demo.accloud.cn/hpc/openapi/v2/view/queue/jobs?userName=test"
payload = {}
headers = {
  "Content-Type": "application/json",
  "token": "<Token>"
}

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

4.响应消息

返回参数:

名称类型描述示例
codestring返回码,0为正常0
msgstring信息success
dataarray队列作业统计信息
namestring队列名称debug
valuesobject队列作业状态统计数组
metricNamestring队列作业状态'R(运行)','Q(排队)','H(保留)',S(挂起)','O(其他)'
metricValueint队列作业该状态下的个数1

返回示例:

json
{
  "code":"0",
  "msg":"success",
  "data":[
    {
      "name":"debug",
      "values":[
        {
          "metricName":"R",
          "metricValue":2
        },
        {
          "metricName":"Q",
          "metricValue":0
        },
        {
          "metricName":"H",
          "metricValue":0
        },
        {
          "metricName":"S",
          "metricValue":0
        },
        {
          "metricName":"O",
          "metricValue":0
        }
      ]
    }
  ]
}

5.错误码

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