閱讀926 返回首頁    go 網易 go 網易蜂巢


大對象分塊接口

大對象可以調用分塊上傳接口來提高上傳成功率,該接口支持斷點續傳和並發上傳。上傳數 據分塊最小16k,最大100M(最後一塊除外)

目錄

Initiate Multipart Upload

描述

使用 Multipart Upload 模式傳輸數據前,必須先調用該接口來通知 NOS 初始化一個 Multipart Upload 事件。該接口會返回一個 NOS 服務器創建的全局唯一的 Upload ID,用於標識本次 Multipart Upload 事件。用戶可以根據這個 ID 來發起相關的操作,如中止 Multipart Upload 、 查詢 Multipart Upload 等。

語法

POST /${ObjectKey}?uploads HTTP/1.1
HOST: ${BucketName}.${endpoint}
Content-Length: ${length}
Date: ${date}
Authorization: ${signature}

請求頭定義

參數 描述 是否必須
x-nos-meta- 以該前綴開頭的header都將被認為是用戶自定義的元數據,比如:x-nos-meta-title: TITLE 這個header會把title:TITLE作為用戶自定義元數據key-value對。
類型:字符串
默認:無
No

響應元素

元素 描述
InitiateMultipartUploadResult 響應容器元素
類型:容器
子節點:Key,Bucket
Key 對象的Key
類型:字符串
父節點:InitiateMultipartUploadResult
Bucket 對象的桶
類型:字符串
父節點:InitiateMultipartUploadResult
UploadId 分塊上傳的ID,用這個ID來作為各塊屬於這個文件的標識
類型:字符串
父節點:InitiateMultipartUploadResult

示例

Request

POST /movie.avi?uploads HTTP/1.1
HOST: filestation.nos-eastchina1.126.net
Content-Length: 401
Date: Fri, 10 Feb 2012 21:34:55 GMT
Authorization: NOS I_AM_ACCESS_ID:I_AM_SIGNATURE

Response


HTTP/1.1 200 OK
x-nos-request-id: 17b21e42ac11000001390ab891440240
Date: Wed, 01 Mar 2012 21:34:55 GMT
Content-Length: 197
Connection: close
Server: NOS

<?xml version="1.0" encoding="UTF-8"?>
<InitiateMultipartUploadResult>
    <Bucket>filestation</Bucket>
    <Key>movie.avi</Key>
    <UploadId>VXBsb2FkIElEIGZvciA2aWWpbmcncyBteS1tb3S5tMnRzIHVwbG9hZA</UploadId>
</InitiateMultipartUploadResult>

細節描述

1.如果 Bucket 不存在,返回 404 no content 錯誤。錯誤碼:NoSuchBucket。

2.隻有 Bucket 的擁有者才能操作大對象分塊接口。非 Bucket 擁有者執行此類操作將返回 403 Forbidden 錯誤。錯誤碼:AccessDenied。

3.Object 名最大長度為 1000,如果超出,返回 400 Bad Request。錯誤碼:KeyTooLong。

4.相同 Object 能進行多次初始化,得到多個 UploadId,後完成的多塊上傳將覆蓋先完成的 Object(如果開啟版本號,先完成的多塊上傳將入曆史版本)。

5.HTTP 請求頭 Content-Length 必須,否則返回 411 Length Required 消息。錯誤碼:MissingContentLength。

Upload part

描述

傳輸一個數據塊之前需要先調用初始化操作( Initiate Multipart Upload )。在初始化一個 Multipart Upload 之後,可以根據指定的 Object 名和 Upload ID 來分塊(Part)上傳數據。 每一個上傳的 Part 都有一個標識它的號碼(part number,範圍是 1~10,000)。對於同一個 Upload ID, 該號碼不但唯一標識這一塊數據,也標識了這塊數據在整個文件內的相對位置。 如果你用同一個 part 號碼,上傳了新的數據,那麼 NOS 上已有的這個號碼的Part數據將被覆 蓋,單塊限製為最小為 16k ,最大為 100M,最後一塊則沒有最大小限製。

語法

PUT /${ObjectKey}?partNumber=${partNumber}&uploadId=${uploadId} HTTP/1.1
HOST: ${BucketName}.${endpoint}
Date: ${date}
Content-Length: ${size}
Authorization: ${signature}

請求頭

Header 描述 是否必須
Content-Length Entity Body 的長度 類型:整型 默認:無 Yes
Content-MD5 Entity Body 的 MD5 摘要 類型:字符串 默認:無 No

特殊錯誤碼

錯誤碼 Http狀態碼 描述
NoSuchUpload 404 Not Found 對應的分塊上傳不存在,可能原因:uploadId 非法、已經執行了 abort、已經執行了 complete 等

示例

Request

PUT /movie.avi?partNumber=1&uploadId=23r54i252358235-32523f23 HTTP/1.1
HOST: filestation.nos-eastchina1.126.net
Date: Fri, 10 Feb 2012 21:34:55 GMT
Content-Length: 1046203
Content-MD5: bb69583fd4da5970a86aa47c0da561ad
Authorization: NOS I_AM_ACCESS_ID:I_AM_SIGNATURE

[1046203 bytes of part data]

Response

HTTP/1.1 200 OK
x-nos-request-id: 17b21e42ac11000001390ab891440240
Date: Wed, 01 Mar 2012 21:34:55 GMT
ETag: bb69583fd4da5970a86aa47c0da561ad
Connection: close
Server: NOS

細節描述

1. 如果 Bucket 不存在,返回 404 no content 錯誤。錯誤碼:NoSuchBucket。

2. 隻有 Bucket 的擁有者才能操作大對象分塊接口。非 Bucket 擁有者執行此類操作將返回 403 Forbidden 錯誤。錯誤碼:AccessDenied。

3.調用該接口上傳 Part 數據前,必須調用 Initiate Multipart Upload 接口,獲取一個 NOS 服務器頒發的 Upload ID 。

4. 如果執行 Upload Part 時,UploadId 對應的 Object 名和 Bucket 名不匹配,返回:400 Bad Request 錯誤。 錯誤碼:InvalidArgument。

5. 如果執行 Upload Part 時,UploadId 已經被Abort,或者 UploadId 本就不存在,返回:404 Not Found 錯誤。錯誤碼:NoSuchUpload。

6.Multipart Upload 要求除最後一個 Part 以外,其他的 Part 大小都要大於16k。但是 Upload Part 接口並不會立即校驗上傳 Part 的大小(因為不知道是否為最後一塊);隻有當 Complete Multipart Upload 的時候才會校驗。

7. 與 PUT Object<6.6_PUT_Object> 類似,NOS 根據 Content-MD5 判斷上傳的文件塊的正確性,如果不匹配,返回 404 Bad Request 錯誤,錯誤碼:BadDigest;如果不帶 Content-MD5,返回 Etag,由用戶來確保數據正確性。

8. Part 號碼的範圍是 1~10000 。如果超出這個範圍,NOS 將返回 InvalidArgument 的錯誤碼。

9.Upload Part 請求頭中的 Content-Length 必須和 HTTP BODY 的長度一致,否則返回 400 Bad Request 。錯誤碼:IncompleteBody。

10. 如果 Head 中沒有加入 Content length 參數,會返回 411 Length Required 錯誤。錯誤碼:MissingContentLength。

11. 如果添加文件長度超過 100M,返回錯誤消息 400 Bad Request。錯誤碼:EntityTooLarge。 HTTP請求頭 Content-Length 必須,否則返回 411 Length Required 消息。錯誤碼:MissingContentLength。

Complete Multipart Upload

描述

在將所有數據 Part 都上傳完成後,必須調用 Complete Multipart Upload API 來完成整個文件 的 Multipart Upload 。在執行該操作時,用戶必須提供所有有效的數據 Part 的列表 (包括 part 號碼和 ETAG);NOS 收到用戶提交的 Part 列表後,會逐一驗證每個數據 Part 的有效性。 當所有的數據 Part 驗證通過後,NOS 將把這些數據part組合成一個完整的 Object。

語法

POST /${ObjectKey}?uploadId=${uploadId} HTTP/1.1
HOST: ${BucketName}.${endpoint}
Content-MD5:  ${entityMD5}
Content-Length:  ${length}
x-nos-Object-md5: ${ObjectMD5}
Authorization:  ${signature}

<CompleteMultipartUpload>
    <Part>
            <PartNumber>${PartNumber}</PartNumber>
            <ETag>${ETag}</ETag>
    </Part>
    ...
</CompleteMultipartUpload>

請求頭定義

Header 描述 是否必須
x-nos-meta- 以該前綴開頭的header都將被認為是用戶自定義的元數據,比如:x-nos-meta-title: TITLE 這個header會把title:TITLE作為用戶自定義元數據key-value對。
類型:字符串
默認:無
No

請求元素

元素 描述 是否必須
CompleteMultipartUpload 完成塊傳輸的請求容器
類型:容器
子節點:一個或多個Part節點
Yes
ETag 一塊數據上傳完畢後,服務器端返回的Entity tag
類型:字符串
父節點:Part
Yes
Part 每一塊的描述信息的容器
類型:容器
子節點:PartNumber,ETag
Yes
PartNumber 分塊序號。
類型:整型
父節點:Part
Yes

響應元素

元素 描述
Bucket 新創建對象所在的桶
類型:字符串
父節點:CompleteMultipartUploadResult
CompleteMultipartUploadResult 響應容器元素
類型:容器
子節點:Location,Bucket,Key,ETag
ETag 新創建的對象的Entity Tag
類型:字符串
父節點:CompleteMultipartUploadResult
Key
新創建對象的Key
Key 新創建的對象的Entity Tag
類型:字符串
父節點:CompleteMultipartUploadResult
Location 新創建的這個對象的資源定位URL
類型:字符串
父節點:CompleteMultipartUploadResult

特殊錯誤碼

錯誤碼 Http狀態碼 描述
InvalidPart 400 Bad Request 請求所指定的上傳塊中,有一個或多個塊不存在,可能的原因:該塊缺失未上傳,該塊的 EntityTag 不匹配等
InvalidPartOrder 400 Bad Request 上傳塊列表,不是按照塊序號升序排列
NoSuchUpload 404 Not Found 對應的分塊上傳不存在,可能原因:uploadId 非法、已經執行了 abort、已經執行了 complete 等

示例

Reqeust

POST /movie.avi?uploadId=23r54i252358235-32523f23 HTTP/1.1
HOST: filestation.nos-eastchina1.126.net
Content-MD5: bb69583fd4da5970a86aa47c0da561ad
Content-Length: 325
x-nos-Object-md5: fd4da5970a86aa47c0da56bb69363
Authorization: NOS I_AM_ACCESS_ID:I_AM_SIGNATURE

<CompleteMultipartUpload>
    <Part>
            <PartNumber>1</PartNumber>
            <ETag>"a54357aff0632cce46d942af68356b38"</ETag>
    </Part>
    <Part>
            <PartNumber>2</PartNumber>
            <ETag>"0c78aef83f66abc1fa1e8477f296d394"</ETag>
    </Part>
    <Part>
            <PartNumber>3</PartNumber>
            <ETag>"acbd18db4cc2f85cedef654fccc4a4d8"</ETag>
    </Part>
</CompleteMultipartUpload>

Response

HTTP/1.1 200 OK
x-nos-request-id: 17b21e42ac11000001390ab891440240
Date: Wed, 01 Mar 2012 21:34:55 GMT
ETag: VXBsb2FkIElEIGZvciA2aWWpbmcncyBtZpZS5tMnRzIHVwbG9hZA
Connection: close
Server: NOS

<?xml version="1.0" encoding="UTF-8"?>
<CompleteMultipartUploadResult xmlns="">
    <Location> filestation.nos-eastchina1.126.net/movie.avi</Location>
    <Bucket>filestation </Bucket>
    <Key>movie.avi </Key>
    <ETag>"3858f62230ac3c915f300c664312c11f"</ETag>
</CompleteMultipartUploadResult>

細節描述

1. 如果 Bucket 不存在,返回 404 no content 錯誤。錯誤碼:NoSuchBucket。

2. 隻有 Bucket 的擁有者才能操作大對象分塊接口。非 Bucket 擁有者執行此類操作將返回 403 Forbidden 錯誤。錯誤碼: AccessDenied 。

3. 調用該接口完成大對象分開接口前,必須調用 Initiate Multipart Upload 接口,獲取一個 NOS 服務器頒發的Upload ID,並調用 Upload Part 上傳至少一塊數據。

4. 如果執行 Complete Multipart Upload 時,UploadId 對應的 Object 名和 Bucket 名不匹配,返回:400 Bad Request 錯誤。 錯誤碼:InvalidArgument。

5. 如果執行 Complete Multipart Upload 時,UploadId 已經被 Abort,或者 UploadId 本就不存在,返回:404 Not Found 錯誤。錯誤碼:NoSuchUpload。

6. Complete Multipart Upload 時,會確認除最後一塊以外所有塊的大小都大於 16k,並檢查用戶提交的 Partlist 中的每一個 Part 號碼和 Etag 。所以在上傳 Part 時,客戶端除了需要記錄 Part 號碼外,還需要記錄每次上傳 Part 成功後,服務器返回的 ETag 值。

7. 如果非最後一塊小於 16k,返回:400 Bad Request。錯誤碼:EntityTooSmall。

8. 用戶提交的 Part List 中,Part 號碼可以是不連續的。例如第一塊的 Part 號碼是1,第二塊的 Part 號碼是5。完成 Complete Multipart Upload 後,所有沒有被提交的已上傳 Part 將被刪除。

9.用戶提交的 Part List 中,Part 號碼必須是升序排列的,否則返回:400 Bad Request。錯誤碼:InvalidPartOrder。

10. 如果用戶提交的 Part List 中存在還為上傳完成的Part號碼,返回:400 Bad Request。錯誤碼:InvalidPart。

11.NOS 處理 Complete Multipart Upload 請求成功後,該 Upload ID 就會變成無效。

12.同一個 Object 可以同時擁有不同的 Upload Id,當 Complete 一個 Upload ID 後,該 Object 的其他 Upload ID 不受影響。

13.如果 HTTP 請求的 BODY XML 格式有誤,返回 400 Bad Request 消息。錯誤碼:MalformedXML。

14.HTTP 請求頭 Content-Length 必須,否則返回 411 Length Required 消息。錯誤碼:MissingContentLength。

15. etag 的計算方法是,每個分塊的 etag 加上‘-’,包括最後一個分塊,然後求 md5,轉換為字符串就得到整個大對象的 etag 了。

16. 分塊上傳的元數據是在調用這個接口後才有效的

Abort Multipart Upload

描述

該接口可以根據用戶提供的 Upload ID 中止其對應的 Multipart Upload 事件。當一個 Multipart Upload 事件被中止後,就不能再使用這個 Upload ID 做任何操作,已經上傳的 Part 數據也會被刪除。

語法

 
DELETE /${ObjectKey}?uploadId=${uploadId} HTTP/1.1
Host: ${BucketName}.${endpoint}
Date: ${Date}
Authorization:  ${signature}

特殊錯誤碼

錯誤碼 Http狀態碼 描述
NoSuchUpload 404 Not Found 對應的分塊上傳不存在,可能原因:uploadId非法、已經執行了abort、已經執行了complete等

示例

Request

DELETE /movie.avi?uploadId=23r54i252358235332523f23 HTTP/1.1
Host: filestation.nos-eastchina1.126.net
Date: Mon, 1 May 2012 20:34:56 GMT
Authorization: NOS I_AM_ACCESS_ID:I_AM_SIGNATURE

Response

HTTP/1.1 204 OK
x-nos-request-id: 17b21e42ac11000001390ab891440240
Date: Mon, 1 May 2012 20:34:59 GMT
ETag: VXBsb2FkIElEIGZvciA2aWWpbmcncyBtZpZS5tMnRzIHVwbG9hZA
Connection: close
Server: NOS

細節描述

1. 如果 Bucket 不存在,返回 404 no content 錯誤。錯誤碼:NoSuchBucket。

2. 隻有 Bucket 的擁有者才能操作大對象分塊接口。非 Bucket 擁有者執行此類操作將返回 403 Forbidden 錯誤。錯誤碼: AccessDenied。

3. 如果輸入的 Upload Id 不存在,NOS 會返回 NoSuchUpload 的錯誤碼。

4.調用該接口完成大對象分開接口前,必須調用 Initiate Multipart Upload 接口,獲取一個 NOS 服務器分配的Upload ID,並調用 Upload Part 上傳至少一塊數據。

List Parts

描述

List Parts 命令可以羅列出指定 Upload ID 所屬的所有已經上傳成功 Part。

語法

GET /${ObjectKey}?uploadId=${id}&max-parts=${limit}&part-number-marker=${start} HTTP/1.1
HOST: ${BucketName}.${endpoint}
Date: ${date}
Authorization: ${signature}

請求參數

參數 描述 是否必須
max-parts 響應中的limit個數 類型:整型 默認值:1000 取值:[0-1000] No
part-number-marker 分塊號的界限,隻有更大的分塊號會被列出來。 類型:字符串 默認:無 No
uploadId 分塊上傳操作的ID 類型:字符串 默認:無 Yes

響應元素

元素 描述
ListPartsResult 列出已上傳塊信息
類型:容器
子節點:Bucket、Key、UploadId、Owner、StorageClass、PartNumberMarker、NextPartNumberMarker、MaxParts, IsTruncated、Part
Bucket 桶的名稱
類型: String
父節點: ListPartsResult
Key 對象的Key
類型: String
父節點: ListPartsResult
UploadId 分塊上傳操作的ID
類型: String
父節點: ListPartsResult
ID 對象擁有者的ID
類型: String
父節點: Owner
DisplayName 對象的擁有者.
類型: String
父節點: Owner
Owner 桶擁有者的信息
子節點:ID, DisplayName
類型: 容器
父節點: ListPartsResult
StorageClass 存儲級別.
類型: String
父節點: ListPartsResult
PartNumberMarker 上次List操作後的Part number
類型: Integer
父節點: ListPartsResult
NextPartNumberMarker 作為後續List操作的part-number-marker
類型: Integer
父節點: ListPartsResult
MaxParts 響應允許返回的的最大part數目
類型: Integer
父節點: ListPartsResult
IsTruncated 是否截斷,如果因為設置了limit導致不是所有的數據集都返回了,則該值設置為true
類型: Boolean
父節點: ListPartsResult
Part 列出相關part信息
子節點:PartNumber, LastModified, ETag, Size
類型: String
父節點: ListPartsResult
PartNumber 識別特定part的一串數字
類型: Integer
父節點: Part
LastModified 該part上傳的時間
類型: Date
父節點: Part
ETag 當該part被上傳時返回
類型: String
父節點: Part
Size 已上傳的 part數據的大小.
類型: Integer
父節點: Part

特殊錯誤碼

錯誤碼 Http狀態碼 描述
NoSuchUpload 404 Not Found 對應的分塊上傳不存在,可能原因:uploadId非法、已經執行了abort、已經執行了complete等

示例

Request

GET /movie.avi?uploadId=23r54i252358235-32523f23 HTTP/1.1
HOST: filestation.nos-eastchina1.126.net
Date: Mon, 1 May 2012 20:34:56 GMT
Authorization: NOS I_AM_ACCESS_ID:I_AM_SIGNATURE

Response

HTTP/1.1 200 OK
x-nos-request-id: 17b21e42ac11000001390ab891440240
Date: Mon, 1 Feb 2012 20:34:56 GMT
Content-Length: 985
Connection: close
Server: NOS

<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult>
    <Bucket>example-Bucket</Bucket>
    <Key>example-Object</Key>
<UploadId>23r54i252358235332523f23 </UploadId>
    <Owner>
            <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
            <DisplayName>someName</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <PartNumberMarker>1</PartNumberMarker>
    <NextPartNumberMarker>3</NextPartNumberMarker>
    <MaxParts>2</MaxParts>
    <IsTruncated>true</IsTruncated>
    <Part>
            <PartNumber>2</PartNumber>
            <LastModified>2010-11-10T20:48:34.000Z</LastModified>
            <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>
            <Size>10485760</Size>
    </Part>
    <Part>
            <PartNumber>3</PartNumber>
            <LastModified>2010-11-10T20:48:33.000Z</LastModified>
            <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>
            <Size>10485760</Size>
    </Part>
</ListPartsResult>

細節描述

1.如果 Bucket 不存在,返回 404 no content 錯誤。錯誤碼:NoSuchBucket。

2.隻有 Bucket 的擁有者才能操作大對象分塊接口。非 Bucket 擁有者執行此類操作將返回 403 Forbidden 錯誤。錯誤碼:AccessDenied。

3. 如果執行 List Parts 時,UploadId 對應的 Object 名和 Bucket 名不匹配,返回:400 Bad Request錯誤。 錯誤碼:InvalidArgument。

4. 如果執行 List Parts 時,UploadId 已經被 Abort,或者 UploadId 本就不存在,返回:404 Not Found錯誤。錯誤碼:NoSuchUpload。 5. 通過 max-parts 和 part-number-marker 能夠遍曆 UploadId 對應的所有上傳塊。 6. 返回結果按照 part 值從小到大排列。

List Multipart Uploads

描述

List Multipart Uploads 可以羅列出所有執行中的 Multipart Upload 事件,即已經被初始化 的 Multipart Upload 但是未被 Complete 或者 Abort 的 Multipart Upload 事件。NOS 返回的羅列 結果中最多會包含 1000 個 Multipart Upload 信息。如果想指定 NOS 返回羅列結果內Multipart Upload信息的數目,可以在請求中添加max-uploads參數。另外,NOS 返回羅列結果中的 IsTruncated元素標明是否還有其他的 Multipart Upload。

語法

GET /?uploads HTTP/1.1
HOST: ${BucketName}.${endpoint}
Date: ${date}
Authorization: ${signature}

請求頭定義

參數 描述 是否必須
key-marker 指定某一uploads key,隻有大於該key-marker的才會被列出
類型: String
No
max-uploads 最多返回max-uploads條記錄
類型: 數字
默認:1000
取值:[0-1000]
No

響應元素

元素 描述
ListMultipartUploadsResult 響應容器元素
類型:容器
子節點:Bucket,KeyMarker,Upload,NextKeyMarker, owner
Bucket 對象的桶
類型:字符串
父節點:ListMultipartUploadsResult
NextKeyMarker 作為後續查詢的key-marker
類型:String
父節點:ListMultipartUploadsResult
IsTruncated 是否截斷,如果因為設置了limit導致不是所有的數據集都返回了,則該值設置為true
類型:Boolean
父節點: ListMultipartUploadsResult
Upload 類型:容器
子節點:Key,UploadId
父節點:ListMultipartUploadsResult
Key 對象的Key
類型:字符串
父節點:Upload
UploadId 分塊上傳操作的ID
類型String
父節點:Upload
ID 對象擁有者的ID
類型: String
父節點: Owner
DisplayName 對象的擁有者
類型: String
父節點: Owner
Owner ID
父節點:Upload
StorageClass 存儲級別
類型: String
父節點: Upload
Initiated 該分塊上傳操作被初始化的時間
類型:Date
父節點: Upload
ListMultipartUploadsResult.Prefix 當請求中包含了prefix參數時,響應中會填充這一prefix
類型:String
父節點: ListMultipartUploadsResult

示例

Request

GET /?uploads&HTTP/1.1
HOST: ${BucketName}.${endpoint}
Date: Mon,1 Nov 2010 20:34:56 GTM
Authorization: ${signature}

Response

HTTP/1.1 200 OK
x-nos-request-id: 17b21e42ac11000001390ab891440240
Date: Mon, 1 Feb 2012 20:34:56 GMT
Content-Length: 197
Connection: close
Server: NOS

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult>
  <Bucket>Bucket</Bucket>
  <NextKeyMarker>my-movie.m2ts</NextKeyMarker>
  <Upload>
    <Key>my-divisor</Key>
    <UploadId>XMgbGlrZSBlbHZpbmcncyBub3QgaGF2aW5nIG11Y2ggbHVjaw</UploadId>
    <Owner>
      <ID>75aa57f09aa0c8caeab4f8c24e99d10f8e7faeebf76c078efc7c6caea54ba06a</ID>
      <DisplayName>OwnerDisplayName</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
  </Upload>
  <Upload>
    <Key>my-movie.m2ts</Key>
        <UploadId>VXBsb2FkIElEIGZvciBlbHZpbcyBteS1tb3ZpZS5tMnRzIHVwbG9hZA</UploadId>
        <Owner>
        <ID>b1d16700c70b0b05597d7acd6a3f92be</ID>
        <DisplayName>OwnerDisplayName</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
  </Upload>
</ListMultipartUploadsResult>

細節描述

1.如果Bucket不存在,返回404 no content錯誤。錯誤碼:NoSuchBucket。

2.隻有Bucket的擁有者才能操作大對象分塊接口。非Bucket擁有者執行此類操作將返回403 Forbidden錯誤。錯誤碼:AccessDenied。

3.通過key-marker和max-uploads參數,能夠遍曆到Bucket內有多少未完成的多塊上傳。

4. 返回未完成多塊上傳按照Key字典序排列。

最後更新:2017-01-03 10:48:53

  上一篇:go 甘肅地區管局規則
  下一篇:go 鏡像API