調用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 | 儲存冗餘轉換任務不存在。 |