全部产品
Search
文档中心

对象存储 OSS:ListUserDataRedundancyTransition

更新时间:Apr 28, 2024

调用ListUserDataRedundancyTransition列举请求者所有的存储冗余转换任务。

注意事项

请求语法

GET /?redundancyTransition&continuation-token=xxx&max-keys=10 HTTP.1
Host: oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

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

请求参数

名称

类型

是否必选

示例值

描述

continuation-token

字符串

abc

指定List操作需要从此token开始。

max-keys

整型数

10

限定此次返回任务的最大个数。取值范围:1-100。

响应头

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

响应元素

名称

类型

示例值

描述

ListBucketDataRedundancyTransition

容器

不涉及

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

父节点:无

子节点:BucketDataRedundancyTransition、IsTruncated、NextContinuationToken

BucketDataRedundancyTransition

容器

不涉及

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

父节点:ListBucketDataRedundancyTransition

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

TaskId

字符串

4be5beb0f74f490186311b268bf6j****

存储冗余转换任务的ID。

父节点:BucketDataRedundancyTransition

子节点:无

CreateTime

字符串

2023-11-17T08:40:17.000Z

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

父节点:BucketDataRedundancyTransition

子节点:无

StartTime

字符串

2023-11-17T10:40:17.000Z

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

父节点:BucketDataRedundancyTransition

子节点:无

EndTime

字符串

不涉及

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

父节点:BucketDataRedundancyTransition

子节点:无

Status

字符串

Processing

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

  • Queueing:队列中。

  • Processing:进行中。

  • Finished:完成。

父节点:BucketDataRedundancyTransition

子节点:无

EstimatedRemainingTime

整型

16

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

父节点:BucketDataRedundancyTransition

子节点:无

ProcessPercentage

整型

50

存储冗余转换任务的进度百分比。单位为小时。任务处于Processing、Finished状态时,有该字段。

父节点:BucketDataRedundancyTransition

子节点:无

IsTruncated

布尔值

false

请求中返回的结果是否被截断。取值如下:

  • true:表示本次未返回全部结果。

  • false:表示本次已返回全部结果。

父节点:ListBucketDataRedundancyTransition

子节点:无

NextContinuationToken

字符串

不涉及

表明本次ListUserDataRedundancyTransition请求包含后续结果,需要将NextContinuationToken指定为continuation-token继续获取结果。

父节点:ListBucketDataRedundancyTransition

子节点:无

示例

  • 请求示例

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

    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>