• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. API Reference (OBS)
  4. Operations on Buckets
  5. List Multipart Uploads
  6. Requests

Requests

Syntax

GET /?uploads&max-uploads=max HTTP/1.1 
 User-Agent: agent
 Host: bucketname.obs.example.com
 Accept: */* 
 Date: Mon, 1 Nov 2010 20:34:56 GMT 
 Authorization: auth

Request Parameters

This request uses parameters to specify the query range for multipart uploads. Table 1 describes the parameters.

Table 1 Request parameters

Parameter

Description

Remarks

delimiter

Character used to group object keys.

All keys that contain the same string between prefix, if specified, and the first occurrence of the delimiter after prefix are grouped under a single result element CommonPrefixesCommonPrefix contains no information about any multipart upload. It is only used for informing users of the following: multipart uploads are contained in this group.

Type: String

Optional

prefix

Lists in-progress uploads only for those object keys that begin with the specified prefix.

Type: String

Optional

max-uploads

Sets the maximum number (ranging from 1 to 1000) of multipart uploads to be returned in the response body. If the value is not in this range, 1000 is returned by default.

Type: Integer

Optional

key-marker

Indicates the multipart upload after which the listing begins.

Type: String

Optional

upload-id-marker

Indicates the multipart upload after which the listing begins. This parameter is used together with key-marker.

Type: String

Optional

Request Headers

This request uses common headers. For details about common request headers, see section Common Request Headers.

Request Elements

This request involves no elements.