ListUserDataRedundancyTransition - Object Storage Service

Lists all redundancy type change tasks of a requester.

Usage notes

To list all redundancy type change tasks of a requester, you must have the oss:ListUserDataRedundancyTransition 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&continuation-token=xxx&max-keys=10 HTTP.1
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request headers

All headers in a ListUserDataRedundancyTransition request are 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 list operation must start.
max-keys	Integer	No	10	The maximum number of redundancy type change tasks that can be returned. Valid values: 1 to 100.

Response headers

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

Response elements

Element	Type	Example	Description
ListBucketDataRedundancyTransition	Container	N/A	The container in which the listed redundancy type change tasks are stored. Parent nodes: none Child nodes: BucketDataRedundancyTransition, IsTruncated, and NextContinuationToken
BucketDataRedundancyTransition	Container	N/A	The container in which the redundancy type change task is stored. Parent nodes: ListBucketDataRedundancyTransition Child nodes: TaskId, CreateTime, StartTime, EndTime, Status, EstimatedRemainingTime, and ProcessPercentage
TaskId	String	4be5beb0f74f490186311b268bf6j****	The ID of the redundancy type 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	2023-11-17T10:40:17.000Z	The time when the redundancy type change task was performed. This element is available when 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 finished. This element is available when the task is in the Finished state. Parent nodes: BucketDataRedundancyTransition Child nodes: none
Status	String	Processing	The state of the redundancy type change task. Valid values: Queueing Processing Finished Parent nodes: BucketDataRedundancyTransition Child nodes: none
EstimatedRemainingTime	Integer	16	The estimated period of time that is required for the redundancy type change task. Unit: hours. This element is available when the task is in the Processing or Finished state. Parent nodes: BucketDataRedundancyTransition Child nodes: none
ProcessPercentage	Integer	50	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
IsTruncated	Boolean	false	Indicates whether the returned results are truncated. Valid values: true: indicates that not all results are returned for the request. false: indicates that all results are returned for the request. Parent nodes: ListBucketDataRedundancyTransition Child nodes: none
NextContinuationToken	String	N/A	Indicates that this ListUserDataRedundancyTransition request contains subsequent results. You must set NextContinuationToken to continuation-token to continue obtaining the 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: 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: 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>