全部產品
Search
文件中心

Object Storage Service:GetBucketDataRedundancyTransition

更新時間:Jun 19, 2024

調用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

儲存冗餘轉換任務不存在。