update-job-priority

Updated at:

The update-job-priority command updates the priority of a specified batch job.

Usage notes

By default, an Alibaba Cloud account has the permissions to update the priority of a batch job. To perform this operation by using a RAM user or Security Token Service (STS), you must have the oss:UpdateJobPriority permission. For more information, see Grant a custom policy.

Command syntax

ossutil api update-job-priority --batch-job-id value --target-priority value

Parameter

Type

Description

--batch-job-id

string

The ID of the batch job. The value must be 44 characters in length and can contain lowercase letters (a-z), uppercase letters (A-Z), and digits (0-9). It cannot contain hyphens (-) or underscores (_). You can obtain the ID by using the create-job or list-jobs command.

--target-priority

int

The target priority of the batch job, which dynamically adjusts the execution order of jobs. Valid values: 0 to 2147483647. A larger value indicates a higher priority.

Note
  • This command requires ossutil 2.4.1 or later.

  • For more information about the supported global command-line options, see Global command-line options.

Usage examples

Update the priority of the batch job whose ID is MzRjZGU2 to 20.

ossutil api update-job-priority --batch-job-id MzRjZGU2 --target-priority 20

Update the priority of the batch job whose ID is MzRjZGU2 to 20 and display the output in JSON format.

ossutil api update-job-priority --batch-job-id MzRjZGU2 --target-priority 20 --output-format json