GetBucketDataRedundancyTransition

调用GetBucketDataRedundancyTransition接口获取存储冗余转换任务。

注意事项

请求语法

GET /?redundancyTransition&x-oss-redundancy-transition-taskid=xxx HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)

请求参数

名称

类型

是否必选

示例值

描述

x-oss-redundancy-transition-taskid

字符串

751f5243f8ac4ae89f34726534d1****

存储转换任务的ID。

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)

响应元素

名称

类型

示例值

描述

BucketDataRedundancyTransition

容器

不涉及

存储冗余转换任务的容器。

父节点:无

子节点:TaskId、CreateTime、StartTime、EndTime、Status、EstimatedRemainingTime、ProcessPercentage

TaskId

字符串

909c6c818dd041d1a44e0fdc66aa****

存储冗余转换任务的ID。

父节点:BucketDataRedundancyTransition

子节点:无

CreateTime

字符串

2023-11-17T09:14:39.000Z

存储冗余转换任务的创建时间。

父节点:BucketDataRedundancyTransition

子节点:无

StartTime

字符串

2023-11-17T09:14:39.000Z

存储冗余转换任务的开始时间。任务处于Processing、Finished状态时,有该字段。

父节点:BucketDataRedundancyTransition

子节点:无

EndTime

字符串

不涉及

存储冗余转换任务的结束时间。任务处于Finished状态时,有该字段。

父节点:BucketDataRedundancyTransition

子节点:无

Status

字符串

Processing

存储冗余转换任务的状态。取值如下:

  • Queueing:队列中。

  • Processing:进行中。

  • Finished:完成。

父节点:BucketDataRedundancyTransition

子节点:无

EstimatedRemainingTime

整型

100

存储冗余转换任务的预计剩余耗时。单位为小时。任务处于Processing、Finished状态时,有该字段。

父节点:BucketDataRedundancyTransition

子节点:无

ProcessPercentage

整型

0

存储冗余转换任务的进度百分比。取值范围:0-100。任务处于Processing、Finished状态时,有该字段。

父节点:BucketDataRedundancyTransition

子节点:无

示例

  • 请求示例

    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 qn6q**************:77Dv****************
  • 返回示例

    • 任务处于Queueing状态

      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>
    • 任务处于Processing状态

      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>
    • 任务处于Finished状态。

      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>

错误码

错误码

HTTP状态码

描述

NoSuchBucket

404

获取存储冗余转换任务时,请求的Bucket不存在。

BucketDataRedundancyTransitionTaskNotExist

404

存储冗余转换任务不存在。