All Products
Search

This Product

    Object Storage Service:GetBucketDataRedundancyTransition

    Document Center

    Object Storage Service:GetBucketDataRedundancyTransition

    Last Updated:Jun 08, 2026

    Queries a redundancy type change task for a bucket.

    Usage notes

    • This operation requires the oss:GetBucketDataRedundancyTransition permission. For more information, see Grant a custom policy.

    • Each region has a corresponding OSS endpoint. 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

    This operation uses only 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****

    ID of the redundancy type change task.

    Response headers

    This operation returns only common response headers. For more information, see Common response headers.

    Response elements

    Element

    Type

    Example

    Description

    BucketDataRedundancyTransition

    Container

    N/A

    Container that stores the redundancy type change task.

    Parent nodes: none

    Child nodes: TaskId, CreateTime, StartTime, EndTime, Status, EstimatedRemainingTime, and ProcessPercentage

    TaskId

    String

    909c6c818dd041d1a44e0fdc66aa****

    ID of the task.

    Parent nodes: BucketDataRedundancyTransition

    Child nodes: none

    CreateTime

    String

    2023-11-17T09:14:39.000Z

    Time when the task was created.

    Parent nodes: BucketDataRedundancyTransition

    Child nodes: none

    StartTime

    String

    2023-11-17T09:14:39.000Z

    Time when the task was performed. Available when the task is in the Processing or Finished state.

    Parent nodes: BucketDataRedundancyTransition

    Child nodes: none

    EndTime

    String

    N/A

    Time when the task finished. Available when the task is in the Finished state.

    Parent nodes: BucketDataRedundancyTransition

    Child nodes: none

    Status

    String

    Processing

    State of the task. Valid values:

    • Queueing

    • Processing

    • Finished

    Parent nodes: BucketDataRedundancyTransition

    Child nodes: none

    EstimatedRemainingTime

    Integer

    100

    Estimated remaining time for the task, in hours. Available when the task is in the Processing or Finished state.

    Parent nodes: BucketDataRedundancyTransition

    Child nodes: none

    ProcessPercentage

    Integer

    0

    Task progress as a percentage. Valid values: 0 to 100. 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: Thu, 17 Apr 2025 08:40:17 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

    • 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>

    ossutil

    For information about the ossutil command that corresponds to the GetBucketDataRedundancyTransition operation, see get-bucket-data-redundancy-transition.

    Error codes

    Error code

    HTTP status code

    Description

    NoSuchBucket

    404

    The specified bucket does not exist.

    BucketDataRedundancyTransitionTaskNotExist

    404

    No redundancy type change task exists for the bucket.