ListBucketDataRedundancyTransition - Object Storage Service

Lists all redundancy type change tasks in an Object Storage Service (OSS) bucket.

Usage notes

To list all redundancy type change tasks in a bucket, you must have the oss:ListBucketDataRedundancyTransition permission. For more information, see Attach a custom policy to a RAM user.
Each region has its own Object Storage Service (OSS) endpoints. For more information about regions and their endpoints, see Regions and endpoints.

Request syntax

GET /?redundancyTransition HTTP/1.1
Host: bucketname.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request headers

All headers in a ListBucketDataRedundancyTransition request are common request headers. For more information, see Common request headers.

Response headers

All headers in the response to a ListBucketDataRedundancyTransition request are common response headers. For more information, see Common response headers.

Response elements

Element	Type	Example	Description
ListBucketDataRedundancyTransition	Container	N/A	The container for listed redundancy type change tasks. Parent nodes: none Child nodes: BucketDataRedundancyTransition
BucketDataRedundancyTransition	Container	N/A	The container for a specific redundancy type change task. Parent nodes: ListBucketDataRedundancyTransition Child nodes: TaskId, CreateTime, StartTime, EndTime, Status, EstimatedRemainingTime, and ProcessPercentage
TaskId	String	4be5beb0f74f490186311b268bf6****	The ID of the redundancy change task. Parent nodes: BucketDataRedundancyTransition Child nodes: none
CreateTime	String	2023-11-17T08:40:17.000Z	The time when the redundancy type change task was created. Parent nodes: BucketDataRedundancyTransition Child nodes: none
StartTime	String	N/A	The time when the redundancy type change task started. This element is included in the response if the task is in the Processing or Finished state. Parent nodes: BucketDataRedundancyTransition Child nodes: none
EndTime	String	N/A	The time when the redundancy type change task was complete. This element is included in the response if the task is in the Finished state. Parent nodes: BucketDataRedundancyTransition Child nodes: none
Status	String	Queueing	The status of the redundancy type change task. Valid values: Queueing Processing Finished Parent nodes: BucketDataRedundancyTransition Child nodes: none
EstimatedRemainingTime	Integer	N/A	The estimated remaining time of the redundancy type change task. This element is included in the response if the task is in the Processing or Finished state. Parent nodes: BucketDataRedundancyTransition Child nodes: none
ProcessPercentage	Integer	N/A	The progress of the redundancy type change task in percentage. This element is included in the response if the task is in the Processing or Finished state. Parent nodes: BucketDataRedundancyTransition Child nodes: none

Examples

Sample request

GET /?redundancyTransition HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 17 Nov 2023 08:40:17 GMT
Authorization: OSS qn6q**************:77Dv****************

Sample response

HTTP/1.1 200 OK
Date: Fri, 17 Nov 2023 08:40:17 GMT
Content-Type: application/xml
Content-Length: 346
Server: AliyunOSS
x-oss-request-id: 5374A2880232A65C2300****

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketDataRedundancyTransition>
  <BucketDataRedundancyTransition>
    <Bucket>examplebucket</Bucket>
    <TaskId>4be5beb0f74f490186311b268bf6****</TaskId>
    <Status>Queueing</Status>
    <CreateTime>2023-11-17T08:40:17.000Z</CreateTime>
  </BucketDataRedundancyTransition>
  ...
</ListBucketDataRedundancyTransition>