ListMultipartUploads
    • PDF

    ListMultipartUploads

    • PDF

    Article Summary

    Classic/VPC環境で利用できます。

    キャンセルされたか、完了していないマルチパートアップロード情報を照会します。オペレーションに使用されるリクエストボディはありません。

    リクエスト

    リクエスト形式を説明します。リクエスト形式は次の通りです。

    メソッドURI
    GET/{bucket-name}

    リクエスト構文

    リクエスト構文は次の通りです。

    GET https://{endpoint}/{bucket-name}?uploads= # path style
    GET https://{bucket-name}.{endpoint}?uploads= # virtual host style
    

    リクエストヘッダ

    Object Storage APIリクエストで共通して使用されるヘッダの詳細は、Object Storage共通リクエストヘッダをご参照ください。

    リクエストパスパラメータ

    パラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    bucket-nameStringRequiredマルチパートアップロード情報を照会するバケットの名前

    リクエストクエリパラメータ

    パラメータの説明は次の通りです。

    フィールドタイプ必須の有無説明
    uploadsStringRequiredマルチパートアップロード情報の照会を宣言
    • 値なしでキーだけ入力
    prefixStringOptionalレスポンスを制限する Prefix
    • Prefixで始まるオブジェクト名にのみレスポンスするように制限
    delimiterStringOptionalオブジェクトを結合するための基準
    • Prefixと Delimiterの間にあるオブジェクトを1つに結合する
    encoding-typeStringOptionalエンコードタイプ
    • XMLでサポートしていない Unicode文字がオブジェクト名に使用された場合、パラメータを URLに設定してエンコード問題を解決
    max-uploadsIntegerOptionalレスポンスに表示するオブジェクト数
    • 0~1,000 (デフォルト: 1,000)
    key-markerStringOptionalリストの先頭
    • key-markerの位置からオブジェクトを指定
    upload-id-markerStringConditionalリストの先頭
    • key-markerが指定された場合、必須

    リクエスト例

    リクエストのサンプルコードは次の通りです。

    GET /apiary?uploads= HTTP/1.1
    Authorization: {authorization-string}
    x-amz-date: 20161011T190354Z
    Host: kr.object.ncloudstorage.com
    

    レスポンス

    レスポンス形式を説明します。

    レスポンスヘッダ

    Object Storage APIで共通して使用されるレスポンスヘッダの詳細は、Object Storageの共通レスポンスヘッダをご参照ください。

    レスポンスステータスコード

    Object Storage APIで共通して使用されるレスポンスステータスコードの詳細は、Object Storageのレスポンスステータスコードをご参照ください。

    レスポンス例

    レスポンスのサンプルコードは次の通りです。

    HTTP/1.1 200 OK
    Date: Wed, 5 Oct 2016 15:22:27 GMT
    Accept-Ranges: bytes
    x-amz-request-id: 9fa96daa-9f37-42ee-ab79-0bcda049c671
    Content-Type: application/xml
    Content-Length: 374
    
    <ListMultipartUploadsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
      <Bucket>apiary</Bucket>
      <KeyMarker/>
      <UploadIdMarker/>
      <NextKeyMarker>multipart-object-123</NextKeyMarker>
      <NextUploadIdMarker>0000015a-df89-51d0-2790-dee1ac994053</NextUploadIdMarker>
      <MaxUploads>1000</MaxUploads>
      <IsTruncated>false</IsTruncated>
      <Upload>
        <Key>file</Key>
        <UploadId>0000015a-d92a-bc4a-c312-8c1c2a0e89db</UploadId>
        <Initiator>
          <ID>d4d11b981e6e489486a945d640d41c4d</ID>
          <DisplayName>d4d11b981e6e489486a945d640d41c4d</DisplayName>
        </Initiator>
        <Owner>
          <ID>d4d11b981e6e489486a945d640d41c4d</ID>
          <DisplayName>d4d11b981e6e489486a945d640d41c4d</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
        <Initiated>2017-03-16T22:09:01.002Z</Initiated>
      </Upload>
      <Upload>
        <Key>multipart-object-123</Key>
        <UploadId>0000015a-df89-51d0-2790-dee1ac994053</UploadId>
        <Initiator>
          <ID>d4d11b981e6e489486a945d640d41c4d</ID>
          <DisplayName>d4d11b981e6e489486a945d640d41c4d</DisplayName>
        </Initiator>
        <Owner>
          <ID>d4d11b981e6e489486a945d640d41c4d</ID>
          <DisplayName>d4d11b981e6e489486a945d640d41c4d</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
        <Initiated>2017-03-18T03:50:02.960Z</Initiated>
      </Upload>
    </ListMultipartUploadsResult>
    

    この記事は役に立ちましたか?

    What's Next
    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.