调用ListUserDataRedundancyTransition列举请求者所有的存储冗余转换任务。
注意事项
要列举请求者所有的存储冗余转换任务,您必须具有
oss:ListUserDataRedundancyTransition
权限。具体操作,请参见为RAM用户授权自定义的权限策略。每个地域都有对应的访问域名(Endpoint)。关于地域与访问域名对应关系的更多信息,请参见访问域名和数据中心。
请求语法
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 | 存储冗余转换任务的状态。取值如下:
父节点:BucketDataRedundancyTransition 子节点:无 |
EstimatedRemainingTime | 整型 | 16 | 存储冗余转换任务的预计剩余耗时。单位为小时。任务处于Processing、Finished状态时,有该字段。 父节点:BucketDataRedundancyTransition 子节点:无 |
ProcessPercentage | 整型 | 50 | 存储冗余转换任务的进度百分比。单位为小时。任务处于Processing、Finished状态时,有该字段。 父节点:BucketDataRedundancyTransition 子节点:无 |
IsTruncated | 布尔值 | 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>