update-job-status

更新时间:
复制 MD 格式

update-job-status命令用于更新指定批量操作任务的状态。

注意事项

阿里云账号默认拥有更新批量操作任务状态的权限。如果您需要通过RAM用户或者STS的方式进行操作,您必须拥有oss:UpdateJobStatus权限。具体操作,请参见为RAM用户授予自定义的权限策略。

  • 状态更新会影响任务的执行流程,请谨慎操作。

命令格式

ossutil api update-job-status --batch-job-id value --requested-job-status value [flags]

参数

类型

说明

--batch-job-id

string

批量操作任务的ID。长度为44个字符,可以包含小写字母(a-z)、大写字母(A-Z)和数字(0-9),不包含短划线(-)和下划线(_)。您可以通过create-job命令或list-jobs命令获取该ID。

--requested-job-status

string

请求更新的任务状态。取值:Cancelled、Ready。任务当前状态处于Cancelled、Cancelling、Complete、Completing、Failed、Failing时,不能再设置为Cancelled;只有处于Suspended、Preparing状态的任务才能设置为Ready。

--status-update-reason

string

状态更新的原因,长度必须为1~256个字符。当--requested-job-status取值为Ready时,该选项为可选项。

说明

使用示例

取消ID为MzRjZGU2的批量操作任务。

ossutil api update-job-status --batch-job-id MzRjZGU2 --requested-job-status Cancelled --status-update-reason "User requested cancellation"

将ID为MzRjZGU2的批量操作任务的状态更新为Ready,使处于Suspended状态的任务继续执行。

ossutil api update-job-status --batch-job-id MzRjZGU2 --requested-job-status Ready

取消ID为MzRjZGU2的批量操作任务,并以JSON格式输出。

ossutil api update-job-status --batch-job-id MzRjZGU2 --requested-job-status Cancelled --status-update-reason "User requested cancellation" --output-format json