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时,该选项为可选项。 |
说明
-
本命令需要ossutil 2.4.1及以上版本。
-
关于支持的全局命令行选项,请参见支持的全局命令行选项。
使用示例
取消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
该文章对您有帮助吗?