GetBucketDataRedundancyTransition - Object Storage Service

Queries redundancy type conversion tasks of a bucket.

Usage notes

To query a redundancy type conversion task of a bucket, you must have the oss:GetBucketDataRedundancyTransition 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&x-oss-redundancy-transition-taskid=xxx HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

Request headers

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

Request parameters

Parameter	Type	Required	Example	Description
x-oss-redundancy-transition-taskid	String	Yes	751f5243f8ac4ae89f34726534d1****	The ID of the redundancy type conversion task.

Response headers

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

Response elements

Element	Type	Example	Description
BucketDataRedundancyTransition	Container	N/A	The container in which the redundancy type conversion task is stored. Parent nodes: none Child nodes: TaskId, CreateTime, StartTime, EndTime, Status, EstimatedRemainingTime, and ProcessPercentage
TaskId	String	909c6c818dd041d1a44e0fdc66aa****	The ID of the redundancy type conversion task. Parent nodes: BucketDataRedundancyTransition Child nodes: none
CreateTime	String	2023-11-17T09:14:39.000Z	The time when the redundancy type conversion task was created. Parent nodes: BucketDataRedundancyTransition Child nodes: none
StartTime	String	2023-11-17T09:14:39.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	100	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	0	The progress of the redundancy type conversion task in percentage. Valid values: 0 to 100. This element is available when the task is in the Processing or Finished state. Parent nodes: BucketDataRedundancyTransition Child nodes: none

Examples

Sample request

GET /?redundancyTransition&x-oss-redundancy-transition-taskid=909c6c818dd041d1a44e0fdc66aa**** HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Fri, Nov 17 2023 09:14:39 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:77Dvh5wQgIjWjwO/KyRt8dOP****

Sample responses

Sample response for a redundancy type conversion task in the Queueing state

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

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

Sample response for a redundancy type conversion task in the Processing state

HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 655726F18EAD9B710C00****
Date: Fri, 17 Nov 2023 08:40:17 GMT
Content-type: application/xml
Content-length: 397

<?xml version="1.0" encoding="UTF-8"?>
<BucketDataRedundancyTransition>
  <Bucket>examplebucket</Bucket>
  <TaskId>909c6c818dd041d1a44e0fdc66aa****</TaskId>
  <Status>Processing</Status>
  <CreateTime>2023-11-17T09:14:39.000Z</CreateTime>
  <StartTime>2023-11-17T09:14:39.000Z</StartTime>
  <ProcessPercentage>0</ProcessPercentage>
  <EstimatedRemainingTime>100</EstimatedRemainingTime>
</BucketDataRedundancyTransition>

Sample response for a redundancy type conversion task in the Finished state

HTTP/1.1 200 OK
Server: AliyunOSS
x-oss-request-id: 655726F18EAD9B710C00****
Date: Fri, 17 Nov 2023 08:40:17 GMT
Content-type: application/xml
Content-length: 420

<?xml version="1.0" encoding="UTF-8"?>
<BucketDataRedundancyTransition>
  <Bucket>examplebucket</Bucket>
  <TaskId>909c6c818dd041d1a44e0fdc66aa****</TaskId>
  <Status>Finished</Status>
  <CreateTime>2023-11-17T09:14:39.000Z</CreateTime>
  <StartTime>2023-11-17T09:14:39.000Z</StartTime>
  <ProcessPercentage>100</ProcessPercentage>
  <EstimatedRemainingTime>0</EstimatedRemainingTime>
  <EndTime>2023-11-18T09:14:39.000Z</EndTime>
</BucketDataRedundancyTransition>

Error codes

Error code	HTTP status code	Description
NoSuchBucket	404	The bucket whose redundancy type conversion tasks you want to query does not exist.
BucketDataRedundancyTransitionTaskNotExist	404	No redundancy type conversion tasks exist.