All Products
Search
Document Center

Object Storage Service:ListUserDataRedundancyTransition

Last Updated:Jun 23, 2026

Lists all storage redundancy type conversion tasks for the requester.

Usage notes

  • To call this operation, you must have the oss:ListUserDataRedundancyTransition permission. For more information, see Grant a custom policy.

  • Each region has its own Object Storage Service (OSS) endpoints. For more information about the mappings between regions and endpoints, see Regions and Endpoints.

Request syntax

GET /?redundancyTransition&continuation-token=xxx&max-keys=10 HTTP.1
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request headers

This operation uses only common request headers. For more information, see Common request headers.

Request parameters

Parameter

Type

Required

Example

Description

continuation-token

String

No

abc

The token from which the listing starts.

max-keys

Integer

No

10

The maximum number of tasks to return. Valid values: 1 to 100.

Response headers

This operation returns only common response headers. For more information, see Common response headers.

Response elements

Element

Type

Example

Description

ListBucketDataRedundancyTransition

Container

N/A

The container that stores the listed redundancy type change tasks.

Parent nodes: none

Child nodes: BucketDataRedundancyTransition, IsTruncated, and NextContinuationToken

BucketDataRedundancyTransition

Container

N/A

The container that stores a redundancy type change task.

Parent nodes: ListBucketDataRedundancyTransition

Child nodes: TaskId, CreateTime, StartTime, EndTime, Status, EstimatedRemainingTime, and ProcessPercentage

TaskId

String

4be5beb0f74f490186311b268bf6j****

The ID of the task.

Parent nodes: BucketDataRedundancyTransition

Child nodes: none

CreateTime

String

2023-11-17T08:40:17.000Z

The time when the task was created.

Parent nodes: BucketDataRedundancyTransition

Child nodes: none

StartTime

String

2023-11-17T10:40:17.000Z

The time when the task started. Available only when the task is in the Processing or Finished state.

Parent nodes: BucketDataRedundancyTransition

Child nodes: none

EndTime

String

N/A

The time when the task finished. Available only when the task is in the Finished state.

Parent nodes: BucketDataRedundancyTransition

Child nodes: none

Status

String

Processing

The status of the task. Valid values:

  • Queueing

  • Processing

  • Finished

Parent nodes: BucketDataRedundancyTransition

Child nodes: none

EstimatedRemainingTime

Integer

16

The estimated time remaining for the task, in hours. Available only when the task is in the Processing or Finished state.

Parent nodes: BucketDataRedundancyTransition

Child nodes: none

ProcessPercentage

Integer

50

The progress of the task, in percentage. Available only when the task is in the Processing or Finished state.

Parent nodes: BucketDataRedundancyTransition

Child nodes: none

IsTruncated

Boolean

false

Indicates whether the returned results are truncated. Valid values:

  • true: Not all results are returned.

  • false: All results are returned.

Parent nodes: ListBucketDataRedundancyTransition

Child nodes: none

NextContinuationToken

String

N/A

The token to use for retrieving the next page of results. Set this value as the continuation-token parameter to obtain the remaining results.

Parent nodes: ListBucketDataRedundancyTransition

Child nodes: none

Examples

  • Sample request

    GET /?dataRedundancyTransition&continuation-token=abc&max-keys=10 HTTP/1.1
    Host: examplebucket1.oss-cn-hangzhou.aliyuncs.com
    Date: Thu, 17 Apr 2025 08:40:17 GMT
    Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e
  • Sample response

    HTTP/1.1 200 OK
    Date: Fri, 17 Nov 2023 08:40:17 GMT
    Content-Type: application/xml
    Content-Length: 437
    Server: AliyunOSS
    x-oss-request-id: 655726F18EAD9B710C00****
    
    <?xml version="1.0" encoding="UTF-8"?>
    <ListBucketDataRedundancyTransition>
      <IsTruncated>false</IsTruncated>
      <NextContinuationToken></NextContinuationToken>
      <BucketDataRedundancyTransition>
        <Bucket>examplebucket1</Bucket>
        <TaskId>4be5beb0f74f490186311b268bf6****</TaskId>
        <Status>Queueing</Status>
        <CreateTime>2023-11-17T08:40:17.000Z</CreateTime>
      </BucketDataRedundancyTransition>
      <BucketDataRedundancyTransition>
        <Bucket>examplebucket2</Bucket>
        <TaskId>4be5beb0f74f490186311b268bf6j****</TaskId>
        <Status>Processing</Status>
        <CreateTime>2023-11-17T08:40:17.000Z</CreateTime>
        <StartTime>2023-11-17T10:40:17.000Z</StartTime>
        <ProcessPercentage>50</ProcessPercentage>
        <EstimatedRemainingTime>16</EstimatedRemainingTime>
      </BucketDataRedundancyTransition>
      <BucketDataRedundancyTransition>
        <Bucket>examplebucket3</Bucket>
        <TaskId>4be5beb0er4f490186311b268bf6j****</TaskId>
        <Status>Finished</Status>
        <CreateTime>2023-11-17T08:40:17.000Z</CreateTime>
        <StartTime>2023-11-17T11:40:17.000Z</StartTime>
        <ProcessPercentage>100</ProcessPercentage>
        <EstimatedRemainingTime>0</EstimatedRemainingTime>
        <EndTime>2023-11-18T09:40:17.000Z</EndTime>
      </BucketDataRedundancyTransition>
      ...
    </ListBucketDataRedundancyTransition>