Documentation Index

Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

GetObject

Prev Next

Available in Classic and VPC

Get an object stored in a Ncloud Storage bucket.

Request

This section describes the request format. The method and URI are as follows:

Method URI
GET /{Key}

Request headers

The following describes the request headers.

Note

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage request headers.

Field Required Description
Range Optional Query range (byte)
x-amz-server-side-encryption-customer-algorithm Optional User encryption algorithm (AES256)
x-amz-server-side-encryption-customer-key Optional User-provided encryption key
x-amz-server-side-encryption-customer-key-MD5 Optional User-provided encryption key's MD5 value

Request path parameters

You can use the following path parameters with your request:

Field Type Required Description
Key String Required Object name

Request query parameters

You can use the following query parameters with your request:

Field Type Required Description
partNumber String Optional Object part number
  • See ListParts.
  • Enter when querying a part of an object.
versionId String Optional Object version ID
  • See ListObjectVersions.
  • Enter when querying a specific version of an object from a bucket with version control enabled.

Request example

The request example is as follows:

GET /object.csv HTTP/1.1
Host: bucket.kr.ncloudstorage.com

Response

This section describes the response format.

Response headers

The following describes the response headers.

Note

For information about the headers common to all Ncloud Storage APIs, see Ncloud Storage response headers.

Field Required Description
x-amz-object-lock-mode - Object retention mode
  • GOVERNANCE | COMPLIANCE
  • Displayed if retention is set to the object
x-amz-object-lock-retain-until-date - Object retention expiration date
  • ISO 8601 format
  • Displayed if retention is set to the object
x-amz-object-lock-legal-hold - Legal hold status
  • ON | OFF
  • Displayed if legal hold is set to the object

Response status codes

For information about the HTTP status codes common to all Ncloud Storage APIs, see Common Ncloud Storage response status codes.

Response example

The response example is as follows:

HTTP/1.1 200 OK

<object data>