弹性高性能计算E-HPC SubmitJob

By | 2021年4月22日

调用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 请求失败,服务暂时不可用

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

请关注公众号获取更多资料

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注

Iconic One Theme | Powered by Wordpress