Lists all storage redundancy type conversion tasks for the requester.
Usage notes
-
To call this operation, you must have the
oss:ListUserDataRedundancyTransitionpermission. 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:
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:
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>