• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. API Reference (OBS)
  4. Operations on Buckets
  5. GET Bucket Object versions
  6. Requests

Requests

Syntax

GET /?versions HTTP/1.1 
User-Agent: agent
Host: bucketname.obs.example.com
Accept: */*
Date: date 
Authorization: authorization

Request Parameters

You can specify parameters in this request to list desired objects (including objects with different version IDs) in a bucket. Table 1 describes the parameters.

Table 1 Request parameters

Parameter

Description

Remarks

prefix

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

Type: String

Optional

key-marker

Indicates the object key to start with when listing objects in a bucket. All objects are listed in the dictionary order.

Type: String

Optional

max-keys

Sets the maximum number of object keys returned in the response body. All objects are listed in the dictionary order. The value ranges from 1 to 1000. If the value is not in this range, 1000 is returned by default.

Type: Integer

Optional

delimiter

Indicates a character used to group object keys. All object keys that contain the same string between the prefix and the first occurrence of the delimiter after the prefix are grouped under a single result element CommonPrefixes.

Type: String

Optional

version-id-marker

Indicates the version ID to start with when listing objects in a bucket. All objects are listed in the dictionary order. This parameter is used together with key-marker.

If the value of version-id-marker is not a version ID specified by key-markerversion-id-marker is invalid.

Type: String

Valid Value: object version ID|None

Constraint: This parameter cannot be an empty string.

Optional

Request Headers

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

If you want to obtain CORS configuration information, you must use the headers in Table 2.

Table 2 Request headers of CORS configuration

Header

Description

Remarks

Origin

Indicates an origin specified by a pre-request. Generally, it is a domain name.

Type: String

Mandatory

Access-Control-Request-Headers

Indicates the HTTP headers of a request. The request can use multiple HTTP headers.

Type: String

Optional

x-amz-security-token

Header field used to identify the request of a federated user. When the federal authentication function is enabled, users sending such requests are identified as federated users.

Type: string

Optional. This parameter must be carried in the request sent by federated users.

Request Elements

This request involves no elements.