All Products
Search
Document Center

Object Storage Service:GetBucketDataRedundancyTransition

Last Updated:Jan 02, 2024

Queries redundancy type change tasks of a bucket.

Usage notes

  • To query redundancy type change tasks 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 change 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 change 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 change task.

Parent nodes: BucketDataRedundancyTransition

Child nodes: none

CreateTime

String

2023-11-17T09:14:39.000Z

The time when the redundancy type change task was created.

Parent nodes: BucketDataRedundancyTransition

Child nodes: none

StartTime

String

2023-11-17T09:14:39.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

100

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

0

The progress of the redundancy type change 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 change 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 change 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 change 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 change tasks you want to query does not exist.

BucketDataRedundancyTransitionTaskNotExist

404

No redundancy type change tasks exist.