调用SubmitJob在指定集群提交作业。

接口说明

在集群提交作业前，请确认已通过控制台上传作业文件（如job.sh）到集群。具体操作，请参见导入作业数据。

调试

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

请求参数

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

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

集群ID。
CommandLine String 是 ./LammpsTest/lammps.pbs

作业执行命令。
RunasUser String 是 root

执行作业的用户名。
RunasUserPassword String 是 12****

用户密码。
Name String 否 job1

作业名称。
Priority Integer 否 0

处理作业的优先级。数值越小，优先级越高。取值范围：

0~9

默认值：0
PackagePath String 否 ./Tem

作业命令所在目录。
StdoutRedirectPath String 否 ./LammpsTest

标准输出路径。
StderrRedirectPath String 否 ./LammpsTest

错误输出路径。
ReRunable Boolean 否 false

作业是否支持重新运行。
ArrayRequest String 否 1-10:2

队列作业。 格式为：1-10:2
Variables String 否 [{Name:,Value:},{Name:,Value:}]

作业的环境变量。
InputFileUrl String 否 https://ehpc-tianshui.oss-cn-beijing.aliyuncs.com/test-u4****/testlist_ehpc.sh

上传到OSS的作业文件的URL地址。
UnzipCmd String 否 tar xzf

解压命令。解压OSS下载的文件。
PostCmdLine String 否 example.sh

提交作业后执行的命令。
ContainerId String 否 ehpc-container-uerfrfffff****

容器应用ID。如果选择使用容器，必须提供容器应用ID。
JobQueue String 否 workq

作业队列。
Node Integer 否 2

提交作业所需计算节点数。

说明 若不填该参数，则Task、Thread、Mem、Gpu失效。
Task Integer 否 2

单个计算节点所需任务数。
Thread Integer 否 1

单个任务所需线程数。
Mem String 否 1GB

单个计算节点最大使用内存数，支持GB、MB、KB，单位不区分大小写。
Gpu Integer 否 1

单个计算节点使用GPU的数量，仅支持使用pbs调度器的集群，且集群内计算节点含GPU时该参数生效。

ClockTime String 否 12:00:00

作业最大运行时间，支持三种格式：

  • hh:mm:ss
  • mm:ss
  • ss

推荐使用第一种格式。若最大运行时间为12小时，示例：12:00:00。

返回数据

名称 类型 示例值 描述
JobId String 1.manager

作业ID。
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

请求ID。

示例

请求示例

https://ehpc.cn-hangzhou.aliyuncs.com/?Action=SubmitJob
&ClusterId=ehpc-hz-FYUr32****
&CommandLine=./LammpsTest/lammps.pbs
&RunasUser=root
&RunasUserPassword=12****
&<公共请求参数>

正常返回示例

XML格式 

<SubmitJobResponse>
      <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
      <JobId>1.manager</JobId>
</SubmitJobResponse>

JSON格式 

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
    "JobId": "1.manager"
}

错误码

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

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