ListParts
    • PDF

    ListParts

    • PDF

    記事の要約

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

    マルチパートアップロードによりバケットにアップロードされたオブジェクトパートを照会できます。

    リクエスト

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

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

    リクエスト構文

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

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

    リクエストヘッダ

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

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

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

    フィールドタイプ必須の有無説明
    bucket-nameStringRequiredオブジェクトが保存されているバケットの名前
    object-nameStringRequiredマルチパートアップロードを実行したオブジェクトの名前

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

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

    フィールドタイプ必須の有無説明
    uploadIdStringRequiredInitiateMultipartUpload APIを実行して取得したアップロード ID
    max-partsStringOptional照会されるパートの最大数
    • 1,000以下
    part-number-markerIntegerOptional照会されるパートの先頭
    • 入力した値より大きい番号のパートを照会
    • 0~1,000 (デフォルト: 1,000)
    参考

    パートの総数が1,000個またはmax-partsの指定値を超過する場合、IsTruncated項目はtrueと表示されます。その後のリクエストでpart-number-markerパラメータにNextPartNumberMarkerを指定すると、以前のリクエストで照会されたリクエストの次のパートリストを照会できます。

    リクエスト例

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

    GET /some-bucket/multipart-object-123?uploadId=01000180-3f73-ad2d-2ed4-8bf4b9e5f6b5&max-parts=2 HTTP/1.1
    Authorization: {authorization-string}
    x-amz-date: 20220419T014350Z
    Host: kr.object.ncloudstorage.com
    

    レスポンス

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

    レスポンスヘッダ

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

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

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

    レスポンス例

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

    HTTP/1.1 200 OK
    Date: Tue, 19 Apr 2022 01:43:50 GMT
    Accept-Ranges: bytes
    x-amz-request-id: e5767394-0d66-4ce0-b53f-d0d449db0a24
    Content-Type: application/xml
    Content-Length: 668
    
    <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
    <ListPartsResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
        <Bucket>some-bucket</Bucket>
        <Key>mutipart-object-123</Key>
        <UploadId>01000180-3f73-ad2d-2ed4-8bf4b9e5f6b5</UploadId>
        <Initiator>
            <ID>{owner-user-id}</ID>
            <DisplayName>{owner-user-id}</DisplayName>
        </Initiator>
        <Owner>
            <ID>{owner-user-id}</ID>
            <DisplayName>{owner-user-id}</DisplayName>
        </Owner>
        <StorageClass>STANDARD</StorageClass>
        <NextPartNumberMarker>2</NextPartNumberMarker>
        <MaxParts>2</MaxParts>
        <IsTruncated>true</IsTruncated>
        <Part>
            <PartNumber>1</PartNumber>
            <LastModified>2022-04-19T01:33:30.285Z</LastModified>
            <ETag>"1c5169091bb3ca7440f67c603a1f60b5"</ETag>
            <Size>143693806</Size>
        </Part>
        <Part>
            <PartNumber>2</PartNumber>
            <LastModified>2022-04-19T02:14:11.202Z</LastModified>
            <ETag>"842169123bb3gr7440f67c546b1a85b7"</ETag>
            <Size>158964528</Size>
        </Part>
    </ListPartsResult>
    

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

    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.