deleteJobArtifacts

首发版本：3.00.6

语法

deleteJobArtifacts(jobId)

详情

删除定时作业或批处理作业在当前节点磁盘上持久化的文件，以释放磁盘空间。

该函数会删除配置参数 batchJobDir 指定目录下与指定作业对应的以下文件：

  • jobId.msg：作业执行过程中的消息文件。

  • jobId.obj：作业返回对象文件。

删除文件后，不能再通过 getJobReturn 获取该作业的返回对象，也不能通过 getJobMessage 获取作业的中间消息，但但仍可通过 getAllJobs 查询作业信息。

Note:

  • 普通用户只能删除自己提交的作业；admin 用户可以删除任意用户提交的作业；guest 用户无权调用该函数。

  • 处于排队中或运行中的作业不能删除，必须等待作业执行完成后，才能调用该函数删除其结果文件。

参数

jobId 字符串标量，表示作业的 ID。jobId 不得为空、不得包含路径分隔符 / 或 \，且不能为 . 或 ..。

返回值

无。

例子

例1. 删除已完成作业的持久化结果。

submitJob("job1", "", now)
getJobReturn("job1")
// output: 2026.06.11 17:11:35.060

deleteJobArtifacts("job1")

getJobReturn("job1")
// output: The object file for job [job1] doesn't exist on disk.

例2. 删除不存在的作业。

deleteJobArtifacts("job3")
// output: The specified job [job3] does not exist.

相关函数：getAllJobs、scheduleJob、submitJob、submitJobEx、submitJobEx2