CDNetworks ドキュメントに戻る
Object Storage
CDNetworks ドキュメントセンター Object Storage API ListParts

ListParts

最終更新日：2025-08-18 15:54:07

ユーザーはこのインターフェースを呼び出すことで、マルチパートアップロードタスクのパート一覧を取得できます。

1回のレスポンスでリストできるパート数は最大1000件までであり、この数値はパラメータ max-parts（デフォルト1000）で設定できます。マルチパートアップロードタスクのパート数が1000件を超える場合、レスポンスには IsTruncated と NextPartNumberMarker が返されます（この場合 IsTruncated はTrue）。次回のListPartsリクエストで、part-number-marker パラメータに NextPartNumberMarker の値を指定することで、続きのパート一覧を取得できます。

リクエスト構文

GET /ObjectName?uploadId=uploadid&max-parts=max&part-number-marker=marker HTTP/1
Host: Bucket.Endpoint
Date: date
Authorization: authorization

URIリクエストパラメータ

名前 説明 必須
uploadId アップロードタスクを識別するID。
型: String
デフォルト値: なし		 Yes
max-parts 1回のリクエストでリストできるパートの最大数。
型: String
デフォルト値: 1000		 No
part-number-marker リスト開始位置を指定。指定した値より大きいパート番号だけがリストされます。
型: String
例: 250を指定すると251番目からリスト開始。		 No

リクエストヘッダー

Common request headers をご使用ください。

リクエストボディ

なし

レスポンス構文

HTTP/1.1 status_code

x-wos-request-id: request id
Date: date
Content-Length: length
Connection: state
Server:WS-web-server
<?xml version="1.0" encoding="UTF-8" standalone="yes"?
<ListPartsResult xmlns=" https://www.wangsu.com/document">
  <Bucket>BucketName</Bucket>
  <Key>object</Key>
  <UploadId>uploadid</UploadId>
  <Initiator>
    <ID>initiatorid</ID>
    <DisplayName>displayname</DisplayName>
  </Initiator>
  <Owner>
    <ID>ownerid</ID>
    <DisplayName>ownername</DisplayName>
  </Owner>
  <PartNumberMarker>partNmebermarker</PartNumberMarker>
  <NextPartNumberMarker>nextpartnumbermarker</NextPartNumberMarker>
  <MaxParts>2</MaxParts>
  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>partnumber1</PartNumber>
    <LastModified>modifieddate</LastModified>
    <ETag>etag</ETag>
    <Size>size</Size>
  </Part>
  <Part>
    <PartNumber>partnumber2</PartNumber>
    <LastModified>modifieddate</LastModified>
    <ETag>etag</ETag>
    <Size>size</Size>
  </Part>
  ...
</ListPartsResult>

レスポンスヘッダー

Common response headers をご使用ください。

レスポンスボディ

名前 説明
ListPartsResult List Partリクエスト結果コンテナ。
型: XML namespace
子ノード: Bucket, Key, UploadId, PartNumberMarker, NextPartNumberMarker, MaxParts, IsTruncated, Part.
親ノード: なし
Bucket バケット名。
型: String
親ノード: ListPartsResult
Key オブジェクト名。
型: String
親ノード: ListPartsResult
UploadId アップロードタスクのID。
型: String
親ノード: ListPartsResult
Initiator アップロードタスクの作成者。
型: XML namespace
子ノード: ID, DisplayName
親ノード: ListPartsResult
ID 作成者のDomainID。
型: String
親ノード: Initiator, Owner
DisplayName 作成者名。
型: String
親ノード: Initiator , Owner
PartNumberMarker 今回のリクエストにおけるリスト開始位置。
型: Integer
親ノード: ListPartsResult
NextPartNumberMarker レスポンスですべての結果が返却されない場合、次回リクエストのリスト開始位置を示します。
型: Integer
親ノード: ListPartsResult
MaxParts 1回でリスト可能なパート数の最大値。範囲は[1,1000]。
型: Integer
親ノード: ListPartsResult
IsTruncated パートリストが切り捨てられているかを示します。true: 一部のみリスト返却、false: 全件返却。
型: Boolean
親ノード: ListPartsResult
Part パート情報のコンテナ。
型: XML namespace
子ノード: PartNumber, LastModified, ETag, Size.
親ノード: ListPartsResult
PartNumber アップロード済みパートの番号。
型: Integer
親ノード: ListPartsResult
LastModified パートのアップロード日時。
型: Date
親ノード: ListPartsResult
ETag アップロード済みパートのETag。
型: String.
親ノード: ListPartsResult
Size アップロード済みパートのサイズ。
型: Integer.
親ノード: ListPartsResult

特殊エラー

状況 HTTPステータス エラーコード メッセージ
指定したuploadIdが存在しません。IDが無効、または対応するマルチパートアップロードが既に完了または中止されています。 404 Not Found NoSuchUpload The specified upload does not exist. The upload ID may be invalid, or the upload may have been aborted or completed.
指定したuploadIdが指定オブジェクトと一致しません。 404 Not Found NoSuchUpload The specified upload does not exist. The upload ID may be invalid, or the upload may have been aborted or completed.
max-partsの値が負または1000より大きい場合。 400 Bad Request InvalidArgument Argument maxParts must be an integer between 0 and 1000.
max-partsの値が数値でない場合。 400 Bad Request InvalidArgument Provided maxParts is not an integer or is out of the integer range.
part-number-markerの値が数値でない場合。 400 Bad Request InvalidArgument Provided part-number-marker is not an integer.

例

GET /example-object?uploadId=XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA&max-parts=2&part-number-marker=1 HTTP/1.1
Host: bucket.s3-cn-east-1.wcsapi.com
Date: Mon, 1 Nov 2010 20:34:56 GMT
Authorization: WOS AKIAIOSFODNN7EXAMPLE:0RQf4/cRonhpaBX5sCYVf1bNRuU=


HTTP/1.1 200 OK
x-wos-request-id: 656c76696e6727732072657175657374
Date: Mon, 1 Nov 2010 20:34:56 GMT
Content-Length: 985
Connection: keep-alive

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ListPartsResult xmlns=" https://www.wangsu.com/document">
  <Bucket>example-bucket</Bucket>
  <Key>example-object</Key>
  <UploadId>XXBsb2FkIElEIGZvciBlbHZpbmcncyVcdS1tb3ZpZS5tMnRzEEEwbG9hZA</UploadId>
  <Initiator>
    <ID> 11116a31-17b5-4fb7-9df5-b288870f11xx</ID>
    <DisplayName>umat-user-11116a31-17b5-4fb7-9df5-b288870f11xx</DisplayName>
  </Initiator>
  <PartNumberMarker>1</PartNumberMarker>
  <NextPartNumberMarker>3</NextPartNumberMarker>
  <MaxParts>2</MaxParts>

  <IsTruncated>true</IsTruncated>
  <Part>
    <PartNumber>1</PartNumber>
    <LastModified>2020-11-10T20:48:000Z</LastModified>
    <ETag>"5678aef83f66abc1fa1e8477fsfsda6d394"</ETag>
    <Size>10485760</Size>
  </Part>
  <Part>
    <PartNumber>2</PartNumber>
    <LastModified>2020-11-10T20:49:000Z</LastModified>
    <ETag>"7778aef83f66abc1fa1e8477f296d394"</ETag>
    <Size>10485760</Size>
  </Part>
  <Part>
    <PartNumber>3</PartNumber>
    <LastModified>2020-11-10T20:50:000Z</LastModified>
    <ETag>"aaaa18db4cc2f85cedef654fccc4a4x8"</ETag>
    <Size>10485760</Size>
  </Part>
</ListPartsResult>

CDNetworks Inc., © 2025. 1840 Enterprise Way, Monrovia, CA 91016 – All rights reserved.