ListUserDataRedundancyTransition - Object Storage Service

Lists all redundancy type conversion tasks of a requester.

Usage notes

To list all redundancy type conversion 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 conversion 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 conversion tasks are stored. Parent nodes: none Child nodes: BucketDataRedundancyTransition, IsTruncated, and NextContinuationToken
BucketDataRedundancyTransition	Container	N/A	The container in which the redundancy type conversion 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 conversion task. Parent nodes: BucketDataRedundancyTransition Child nodes: none
CreateTime	String	2023-11-17T08:40:17.000Z	The time when the redundancy type conversion task was created. Parent nodes: BucketDataRedundancyTransition Child nodes: none
StartTime	String	2023-11-17T10:40:17.000Z	The time when the redundancy type conversion 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 conversion 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 conversion 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 conversion 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 conversion task in percentage. Unit: hours. This element is available 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: 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 qn6qrrqxo2oawuk53otfjbyc:77Dvh5wQgIjWjwO/KyRt8dOP****

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>