list-user-data-redundancy-transition

Permissions

To grant this permission to a RAM user, see Grant custom policy to a RAM user.

Syntax

ossutil api list-user-data-redundancy-transition [--continuation-token <value>] [--max-keys <value>]

Options

--continuation-token (string)

The token that marks where the list operation starts. Use the NextContinuationToken value from a previous response to retrieve the next page of results.

--max-keys (int)

The maximum number of redundancy transition tasks to return per request.

For global command-line options, see Global command-line options.

Examples

List all redundancy type conversion tasks:

ossutil api list-user-data-redundancy-transition

List tasks and display the output in JSON format:

ossutil api list-user-data-redundancy-transition --output-format json

Example output:

{
  "IsTruncated": false,
  "NextContinuationToken": "",
  "BucketDataRedundancyTransition": [
    {
      "Bucket": "examplebucket",
      "TaskId": "4be5beb0-e7cb-463f-9381-16b4832a****",
      "Status": "Processing",
      "CreateTime": "2023-11-10T02:00:00.000Z",
      "StartTime": "2023-11-10T02:01:00.000Z",
      "ProcessPercentage": 20,
      "EstimatedRemainingTime": 100
    }
  ]
}

List tasks and display the output in YAML format:

ossutil api list-user-data-redundancy-transition --output-format yaml

Retrieve only the first 10 tasks:

ossutil api list-user-data-redundancy-transition --max-keys 10

Resume listing from a continuation token:

ossutil api list-user-data-redundancy-transition --continuation-token CgJiYw123

Output

IsTruncated (boolean)

Indicates whether the returned results are truncated. If true, more tasks are available and NextContinuationToken contains the token to retrieve the next page.

NextContinuationToken (string)

The token to retrieve the next page of results. Pass this value to --continuation-token in a subsequent request. This field is empty when IsTruncated is false.

BucketDataRedundancyTransition (array)

The list of redundancy type conversion tasks. Each task includes:

What's next

• ListUserDataRedundancyTransition — the underlying API operation and its full response schema

• Global command-line options — flags supported by all ossutil commands