调用GetBucketDataRedundancyTransition接口获取存储冗余转换任务。
注意事项
要获取存储冗余转换任务,您必须具有
oss:GetBucketDataRedundancyTransition
权限。具体操作,请参见为RAM用户授权自定义的权限策略。每个地域都有对应的访问域名(Endpoint)。关于地域与访问域名对应关系的更多信息,请参见访问域名和数据中心。
请求语法
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 | 存储冗余转换任务的状态。取值如下:
父节点: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 | 存储冗余转换任务不存在。 |