Help Center> OBS GO SDK> API Reference> Data Types> Request Parameter of GET Object
Updated on 2022-02-10 GMT+08:00

Request Parameter of GET Object

Type Definition

type GetObjectInput struct

Parameter Description

Field

Type

Optional or Mandatory

Description

Bucket

string

Mandatory

Bucket name

Key

string

Mandatory

Object name

ResponseCacheControl

string

Optional

Rewrites the Cache-Control header when obtaining the object.

ResponseContentDisposition

string

Optional

Rewrites the Content-Disposition header when obtaining the object.

ResponseContentEncoding

string

Optional

Rewrites the Content-Encoding header when obtaining the object.

ResponseContentLanguage

string

Optional

Rewrites the Content-Language header when obtaining the object.

ResponseContentType

string

Optional

Rewrites the Content-Type header when obtaining the object.

ResponseExpires

string

Optional

Rewrites the Expires header when obtaining the object.

VersionId

string

Optional

Object version ID

RangeStart

int64

Optional

Start position for object download. The value is a non-negative integer.

RangeEnd

int64

Optional

Endpoint for object download. If the value is larger than the object length minus 1, the actual object length = Object length - 1.

IfMatch

string

Optional

Returns the source object if its ETag is the same as the one specified by this parameter; otherwise, an error is returned.

IfNoneMatch

string

Optional

Returns the source object if its ETag is different from the one specified by this parameter; otherwise, an error is returned.

IfModifiedSince

time.Time

Optional

Returns the object if it is modified after the time specified by this parameter; otherwise, an error is returned.

IfUnmodifiedSince

time.Time

Optional

Returns the object if it remains unchanged since the time specified by this parameter; otherwise, an error is returned.

Origin

string

Optional

Origin specified in the preflight request. Generally, it is a domain name.

RequestHeader

string

Optional

HTTP headers in a cross-origin request

SseHeader

SseCHeader

Optional

Header for server-side decryption

  • If a request includes IfUnmodifiedSince or IfMatch and the specified condition is not met, the object download will fail with error information 412 Precondition Failed returned.
  • If a request includes IfModifiedSince or IfNoneMatch and the specified condition is not met, the object download will fail with error information 304 Not Modified returned.