Ransomware attackers specifically target and attempt to destroy backup systems to increase the probability of payment. Hardening your system is critical. Please ensure you have reviewed your platform security using the Security Hardening Checklist
Cohesity

COHESITY Documentation

Explore our documentation to get started, discover products & new features, access troubleshooting guides, register sources, platforms support.

Products
Data Security Alliance
Visit Cohesity.com
Demos
Support
Blogs
Developers
Partner Portals
Cohesity Community
© 2026 Cohesity, Inc. All Rights Reserved.
Terms of Use|
Privacy Policy|
Legal|
  1. Home
  2. NetBackup™ Deduplication Guide
  3. S3 Interface for MSDP
  4. S3 APIs for S3 interface for MSDP
  5. S3 APIs on Buckets
  6. ListMultipartUploads
NetBackup™ Deduplication Guide

ListMultipartUploads

Lists in-progress multipart uploads. An in-progress multipart upload is a multipart upload that is initiated using the Create Multipart Upload request but is not complete yet or aborted. This operation returns a maximum of 1,000 multipart uploads in the response.

Request Syntax

GET /bucket?uploads&keymarker=KeyMarker&maxuploads
=MaxUploads&prefix=Prefix&upload-id-marker=UploadIdMarker
Host: msdps3.server:8443

Request Parameters

  • Bucket

    Name of the bucket on which the multipart upload was initiated.

    Required: Yes

    Type: String

  • key-marker

    The marker is the point where Object should begin listing objects. MSDP S3 expects the key-marker that was returned by server in last request. The value of NextMarker of response should be used in request as marker.

    Type: String

  • max-uploads

    Limits the number of multipart uploads that are returned in the response. By default, the action returns up to 1,000 uploads.

    Type: Integer

  • prefix

    Limits the response to uploads that begin with the specified prefix.

    Type: String

  • upload-id-marker

    With key-marker, you can specify an upload-id-marker after which listing should begin. If key-marker is not specified, upload-id-marker is ignored.

    Type: String

Response Syntax

HTTP/1.1 200 
<?xml version="1.0" encoding="UTF-8"?>
<ListMultipartUploadsResult>
    <Bucket>string</Bucket>
    <KeyMarker>string</KeyMarker>
    <UploadIdMarker>string</UploadIdMarker>
    <NextKeyMarker>string</NextKeyMarker>
    <Prefix>string</Prefix>
    <NextUploadIdMarker>string</NextUploadIdMarker>
    <MaxUploads>integer</MaxUploads>
    <IsTruncated>boolean</IsTruncated>
    <Upload>
        <Initiated>timestamp</Initiated>
        <Key>string</Key>
        <StorageClass>string</StorageClass>
        <UploadId>string</UploadId>
    </Upload>
    ...
</ListMultipartUploadsResult>

Response Body

  • ListMultipartUploadsResult

    Root level tag for the ListMultipartUploadsResult parameters.

    Required: Yes

    • Bucket

      Name of the bucket on which the multipart upload was initiated.

    • IsTruncated

      A flag indicating whether all the results satisfying the search criteria were returned by MSDP S3.

    • KeyMarker

      S3 interface for MSDP expects the key-marker which was returned by server in last request. The value of "NextKeyMarker" of response should be used in request as key-marker.

    • MaxUploads

      Limits the number of multipart uploads that are returned in the response. By default, the action returns up to 1,000 uploads.

    • NextKeyMarke

      When the response is truncated, you can use this value as marker in subsequent request to get next set of objects.

    • NextUploadIdMarker

      When the response is truncated, you can use this value as marker in subsequent request to get next set of objects.

    • UploadIdMarker

      The value of UploadIdMarker passed in the request.

    • Prefix

      Limits the response to keys that begin with the specified prefix.

    • Upload

      Information that is related to a particular multipart upload. Response can contain zero or multiple uploads.

      • Initiated

        The time and date when the multipart upload was initiated.

        Type: Timestamp

      • Key

        Object name for which multipart upload was initiated.

      • StorageClass

        Storage class of the uploaded part.

      • UploadId

        Upload ID that identifies the multipart upload.

Possible Error Response

  • Success

    HTTP status code 200.

  • InvalidArgument

    Invalid Argument. HTTP status code 400.

  • AccessDenied

    Request was rejected because user authentication failed.

    HTTP status code 403.

  • NoSuchBucket

    The specified bucket does not exist.

    HTTP status code 404.

  • InternalError

    Request failed because of an internal server error.

    HTTP status code 500.

Feedback

Was this page helpful?
Previous

ListBuckets

Next

ListObjects

Feedback

Was this page helpful?