ListParts コマンドを使用すると、正常にアップロードされた特定のアップロード ID のすべてのパートをリストできます。
リクエスト構文
Get /ObjectName?uploadId=UploadId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: Signature
リクエストパラメーター
名前 | 型 | 説明 |
---|---|---|
uploadId | String | マルチパートアップロードイベントの ID。 デフォルト値: なし |
max-parts | Integer | OSS の応答に表示されるパートの最大数。 デフォルト値: 1,000 |
part-number-marker | Integer | 特定のリストの開始位置。パートは、そのパート番号がこのパラメーターの値より大きい場合にのみリストされます。 デフォルト値: なし |
encoding-type | String | 返されるコンテンツのエンコーディングとエンコーディングのタイプを指定します。オブジェクトキーでは UTF-8 文字が使用されますが、XML 1.0 標準では、0 ~ 10 の ASCII 値を含む文字などの特定の制御文字の解析はサポートされていません。XML 1.0 標準でサポートされていない制御文字がオブジェクトキーに含まれている場合は、encoding-type を指定して返されるオブジェクトキーをエンコードできます。 デフォルト値: なし |
レスポンスの要素
名前 | 型 | 説明 | |
---|---|---|---|
ListPartsResult | Container | List Parts リクエストの結果の格納に使用されるコンテナー。 サブノード: Bucket、Key、UploadId、PartNumberMarker、NextPartNumberMarker、MaxParts、IsTruncated、Part 親ノード: なし |
|
Bucket | String |
バケット名を指定します。 親ノード: ListPartsResult |
|
EncodingType | String |
返される結果におけるエンコーディングのタイプを指定します。リクエストで encoding-type を指定した場合は、返される結果において Key がエンコードされます。 親ノード: ListPartsResult |
|
Key | String |
オブジェクト名。 親ノード: ListPartsResult |
|
UploadId | String |
アップロードイベントの ID。 親ノード: ListPartsResult |
|
PartNumberMarker | Integer |
リスト結果内のパート番号の開始位置。 親ノード: ListPartsResult |
|
NextPartNumberMarker | Integer |
今回返されなかった結果がある場合、応答リクエストには、次のリクエストにおける PartNumberMarker の値を示す NextPartNumberMarker 要素が含まれます。 親ノード: ListPartsResult |
|
MaxParts | Integer |
返されたリクエストに表示されるパートの最大数。 親ノード: ListPartsResult |
|
IsTruncated | Enumerating strings | List Parts に対して返された結果リストが切り捨てられているかどうか。”true” は返されなかった結果があることを示し、”false” はすべての結果が返されたことを示します。 有効な値: true と false 親ノード: ListPartsResult |
|
Part | String |
パート情報の格納に使用されるコンテナー。 サブノード: PartNumber、LastModified、ETag、Size 親ノード: ListPartsResult |
|
PartNumber | Integer |
パート番号。 親ノード: ListPartsResult.Part |
|
LastModified | Date |
パートのアップロード日時。 親ノード: ListPartsResult.part |
|
ETag | String |
アップロードされたパートのコンテンツ内の ETag 値。 親ノード: ListPartsResult.Part |
|
Size | Integer |
アップロードされたパートのサイズ。 親ノード: ListPartsResult.Part |
詳細分析
- ListParts では、max-parts と part-number-marker の 2 つのリクエストパラメーターがサポートされています。
- max-parts パラメーターの最大値は 1,000 で、デフォルト値も 1,000 です。
- OSS から返される結果は、パート番号に基づいて昇順でリストされます。
- ネットワーク伝送でエラーが発生する可能性があるため、List Parts の結果 (パート番号と ETag 値) を使用して Complete Multipart の最終パートリストを生成しないことをお勧めします。
例
リクエストの例:
Get /multipart.data?uploadId=0004B999EF5A239BB9138C6227D69F95 HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Thu, 23 Feb 2012 07:13:28 GMT
Authorization: OSS qn6qrrqxo2oawuk53otfjbyc:4qOnUMc9UQWqkz8wDqD3lIsa9P8=
レスポンスの例:
HTTP/1.1 200
Server: AliyunOSS
Connection: keep-alive
Content-length: 1221
Content-type: application/xml
x-oss-request-id: 106452c8-10ff-812d-736e-c865294afc1c
Date: Thu, 23 Feb 2012 07:13:28 GMT
<?xml version="1.0" encoding="UTF-8"?>
<ListPartsResult xmlns="http://doc.oss-cn-hangzhou.aliyuncs.com">
<Bucket>multipart_upload</Bucket>
<Key>multipart.data</Key>
<UploadId>0004B999EF5A239BB9138C6227D69F95</UploadId>
<NextPartNumberMarker>5</NextPartNumberMarker>
<MaxParts>1000</MaxParts>
<IsTruncated>false</IsTruncated>
<Part>
<PartNumber>1</PartNumber>
<LastModified>2012-02-23T07:01:34.000Z</LastModified>
<ETag>"3349DC700140D7F86A078484278075A9"</ETag>
<Size>6291456</Size>
</Part>
<Part>
<PartNumber>2</PartNumber>
<LastModified>2012-02-23T07:01:12.000Z</LastModified>
<ETag>"3349DC700140D7F86A078484278075A9"</ETag>
<Size>6291456</Size>
</Part>
<Part>
<PartNumber>5</PartNumber>
<LastModified>2012-02-23T07:02:03.000Z</LastModified>
<ETag>"7265F4D211B56873A381D321F586E4A9"</ETag>
<Size>1024</Size>
</Part>
</ListPartsResult>