本文へジャンプします。

ニフクラ ユーザーガイド

本ページは2023/9/5をもって、新ページhttps://docs.nifcloud.com/object-storage-service/api/ListMultipartUploads.htmへ移行しました。 今後は新ページをご参照ください。

ListMultipartUploads

処理概要

進行中のマルチパートアップロードが表示されます。
CompleteMultipartUploadで完了したパートは表示されません。

リクエストURL

GET /{Bucket}?uploads

指定するパラメーター

ヘッダーパラメーター
パラメーター 説明 必須
x-amz-content-sha256 string ペイロード全体の計算されたSHA256チェックサム
x-amz-date string リクエスト側で生成した現在日時
Authorization string リクエスト認証に用いる文字列
encoding-type string レスポンスのエンコード方式を指定します。
max-uploads integer レスポンス本文で返すマルチパートアップロードの最大数を1〜1000の範囲で設定します。
Default: 1000
key-marker string

リスト作成時の検索開始位置を指定するオブジェクトキーのマーカー文字列
指定した文字列より辞書的に大きいキーだけがリストに含まれます。


prefix string アップロードが進行中の一覧を、指定したプレフィックスで始まるキーで表示します。
upload-id-marker string key-markerと一緒に、リスト作成を開始するマルチパートアップロードを指定します。
パスパラメーター
パラメーター 説明 必須
Bucket string バケット名

応答フィールド

レスポンスヘッダー
フィールド (項目) 説明
Date string トランザクションが実行された日時
Content-Type string オブジェクトのMIME Typeの種類
Content-Length string レスポンスボディのバイト数
Connection string 持続接続の状態を表示します。
x-amz-request-id string

このリクエストに付与されるID
トラブルについて問い合わせる際に利用されます。


x-amz-id-2 string

このリクエストに対する処理ID
トラブルについて問い合わせる際に利用されます。


x-ntap-sg-trace-id string

このリクエストに対する処理ID
トラブルについて問い合わせる際に利用されます。


X-Fcx-Endpoint-Request string APIエンドポイントとしてリクエストを受け付けたことを示す番号
レスポンスボディ
フィールド (項目) 説明
ListMultipartUploadsResult structure 応答のためのコンテナ
Bucket string マルチパートアップロードが開始されたバケットの名前
KeyMarker string リスティングが開始された時点以降のキー
UploadIdMarker string リスティングの開始後のアップロードID
NextKeyMarker string リストが切り捨てられるとき、この要素は後続のリクエストでkey-markerリクエストパラメーターに使われるべき値を指定します。
NextUploadIdMarker string リストが切り捨てられるとき、この要素は後続のリクエストでupload-id-markerリクエストパラメーターに使われるべき値を指定します。
MaxUploads integer レスポンスに含まれる可能性があるマルチパートアップロードの最大数
IsTruncated boolean

返却されたリストが切り捨てられているかどうかを示します。
値がtrueの場合、リストは切り捨てられていることを表します。
マルチパートアップロードの数が、MaxUploadsで指定されている数を超えた場合、リストは切り捨てられます。


Upload list

特定のマルチパートアップロードに関連する要素のためのコンテナ
応答には、0個以上のUpload要素を含めることができます。


Key string マルチパートアップロードが開始されたオブジェクトのキー
UploadId string マルチパートアップロードを識別するアップロードID
Initiator structure

誰がマルチパートアップロードを開始したかを識別するコンテナ要素
イニシエータがAWSアカウントの場合、この要素はOwner要素と同じ情報を表示します。
イニシエータがIAMユーザーの場合、この要素はユーザーのARNと表示名を表示します。


ID string

プリンシパルがAWSアカウントの場合は、Canonical User IDが表示されます。
プリンシパルがIAMユーザーの場合、ユーザーARN値を表示します。


DisplayName string プリンシパル名
Owner structure

オブジェクトが作成された後に、そのオブジェクトの所有者を識別するコンテナ要素
マルチパートアップロードがIAMユーザーによって開始された場合、この要素は親アカウントIDと表示名を表示します。


ID string Initiator.IDと同じ内容が表示されます。
DisplayName string Initiator.DisplayNameと同じ内容が表示されます。
StorageClass string マルチパートアップロードが完了したときにオブジェクトを格納するために使用されるストレージのクラス(STANDARDまたはREDUCED_REDUDANCY)
Initiated timestamp マルチパートアップロードが開始された日時

リクエストサンプル

    GET /general-bucket?uploads HTTP/1.1
User-Agent: curl/7.29.0
Host: jp-east-1.storage.api.nifcloud.com
Accept: */*
x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
x-amz-date:20190604T095505Z
Authorization:AWS4-HMAC-SHA256 Credential=XK8Z3830NBL1BT9WD3HD/20190604/jp-east-1/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=4092c21dddac5952e3c547d3a36c43b41116da927d85bf1e621bbb0d1eeffb0b

  

応答サンプル

    HTTP/1.1 200 OK
Date: Tue, 04 Jun 2019 09:55:05 GMT
Content-Type: application/xml
Content-Length: 825
Connection: keep-alive
x-amz-request-id: 3196226532
x-amz-id-2: 12174498
x-ntap-sg-trace-id: 140c8e04d4e77984
X-Fcx-Endpoint-Request: EXECUTED_api2-rmp1.management.jp-east-1.local-28163-1016056-1_200

<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
  <Bucket>general-bucket</Bucket>
  <KeyMarker/>
  <UploadIdMarker/>
  <NextKeyMarker>Mpart-Object</NextKeyMarker>
  <NextUploadIdMarker>JuDv6b4MVFX6H-jY7ycpmigQ-OXOnim8YlI7FunK8FkCw9Jbu6fkv3DNTQ</NextUploadIdMarker>
  <MaxUploads>1000</MaxUploads>
  <IsTruncated>false</IsTruncated>
  <Upload>
    <Key>Mpart-Object</Key>
    <UploadId>JuDv6b4MVFX6H-jY7ycpmigQ-OXOnim8YlI7FunK8FkCw9Jbu6fkv3DNTQ</UploadId>
    <Initiator>
      <ID>42242073901014718119</ID>
      <DisplayName>fj-k5objt-tenant-99</DisplayName>
    </Initiator>
    <Owner>
      <ID>42242073901014718119</ID>
      <DisplayName>fj-k5objt-tenant-99</DisplayName>
    </Owner>
    <StorageClass>STANDARD</StorageClass>
    <Initiated>2019-06-04T07:27:50.120Z</Initiated>
  </Upload>
</ListMultipartUploadsResult>

  
  • ※本ページ記載の金額は、すべて税抜表示です。
  • ※本ページ記載の他社製品名および会社名などは、各社の商標または登録商標です。
  • ※本ページの内容は、2023年9月05日時点の情報です。

推奨画面サイズ 1024×768 以上