• Object Storage Service

obs
  1. Help Center
  2. Object Storage Service
  3. API Reference (Swift)
  4. Operations on Objects
  5. Get Object Content and Metadata
  6. Request

Request

Method

Table 1 Method description

Method

URI

Description

GET

/v1/{account}/{container}/{object}{?temp_url_sig,temp_url_expires,multipart-manifest}

Downloads the object content and gets the object metadata.

{account} indicates the name of an account. {container} indicates the name of a container. {object} indicates the name of an object.

This operation does not involve a request body.

Example Request

Show the content and metadata of the goodbye object in the marktwain container:

curl -i $publicURL/marktwain/goodbye -X GET -H "X-Auth-Token:$token"

Request Query Parameters

Table 2 describes the query parameters for getting the object content:

Table 2 Request query parameters

Parameter

Type

Description

temp_url_sig

String

(Optional)

Used with TempURL to sign the request.

temp_url_expires

String

(Optional)

Used with TempURL to specify the expiry time of the signature.

multipart-manifest

String

(Optional)

If the value is get and the object is a large object, the content of the manifest file for the static or dynamic large object, instead of the content of the large object, is returned.

filename

String

(Optional)

If objects are accessed based on TempURL, use the value of filename to replace that of filename in the Content-Disposition header.

inline

NA

(Optional)

If objects are accessed based on TempURL, replace the content of the Content-Disposition response header with inline.

Request Headers

Request URI parameters

Parameter

Type

Description

{account}

String

(Required)

Unique name of the account. In the current version, it indicates the unique ID of the account.

{container}

String

(Required)

Unique name of the container.

For details about container naming rules, see Naming Rules.

{object}

String

(Required)

Name of the object.

For details about object naming rules, see Object Naming Rules.

Table 3 Request header parameters

Header

Type

Description

X-Auth-Token

String

(Required)

Authentication token.

Range

String

(Optional)

Range of the content to get.

For example:

  • Range: bytes=-5. The last five bytes.
  • Range: bytes=10-15. The five bytes of data after a 10-byte offset.
  • Range: bytes=6-. Byte 6 and after.
  • Range: bytes=1-3,2-5. A multi-part response that contains bytes 1 to 3 inclusive, and bytes 2 to 5 inclusive.

If-Match

String

(Optional)

If the MD5 value of the queried object is equal to the specified value, the object is returned.

If-None-Match

String

(Optional)

If the MD5 value of the queried object is not equal to the specified value, the object is returned.

If-Modified-Since

String

(Optional)

If the queried object was modified before the specified time, the object is returned.

If-Unmodified-Since

String

(Optional)

If the queried object was not modified before the specified time, the object is returned.