zhangyue 894279c39a Object Storage Service API Reference Swift V1

Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com>
Co-authored-by: zhangyue <zhangyue164@huawei.com>
Co-committed-by: zhangyue <zhangyue164@huawei.com>

2023-02-02 08:50:48 +00:00

15 KiB

Raw Permalink Blame History

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)	A unique account name. In the current version, it indicates a unique ID for the account.
{container}	String (Required)	A unique container name. For details about container naming rules, see Naming Rules.
{object}	String (Required)	An object name. For details about object naming rules, see Object Naming Rules.

Parameter

Type

Description

{account}

String

(Required)

A unique account name. In the current version, it indicates a unique ID for the account.

{container}

String

(Required)

A unique container name.

For details about container naming rules, see Naming Rules.

{object}

String

(Required)

An object name.

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.

Parent topic: Get Object Content and Metadata

15 KiB Raw Permalink Blame History

Request

Method

Example Request

Request Query Parameters

Request Headers

15 KiB

Raw Permalink Blame History