---
title: "GetObject"
slug: "storage-objectstorage-getobject"
tags: ["Object Storage"]
updated: 2026-09-17T10:12:27Z
published: 2026-09-17T10:12:27Z
canonical: "api.ncloud-docs.com/storage-objectstorage-getobject"
---

> ## 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

Available in Classic and VPC

View objects based on the specified headers. No request query parameter or request body is used in the operation.

## Requests

The following describes the request format for the endpoint. The request format is as follows.

| Method | URI |
| --- | --- |
| GET | /{bucket-name}/{object-name} |

### Request syntax

The request syntax is as follows.

```
GET https://{endpoint}/{bucket-name}/{object-name} # path style
GET https://{bucket-name}.{endpoint}/{object-name} # virtual host style
```

### Request headers

The following describes the GetObject header. For headers common to all Object Storage APIs, see [Object Storage common request headers](/docs/en/storage-objectstorage#%EA%B3%B5%ED%86%B5%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94).

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `range` | String | Optional | Return the size of the object in bytes within a specified range |
| `if-match` | String | Optional | Return the object if the specified ETag string matches the source object |
| `if-none-match` | String | Optional | Return the object if the specified ETag string is different from the source object |
| `if-unmodified-since` | String | Optional | Return the object if the source object hasn't been edited since the specified date - Must be in a valid date format - <Example> Wed, 30 Nov 2016 20:21:38 GMT |
| `if-modified-since` | String | Optional | Return the object if the source object was edited after the specified date - Must be in a valid date format - <Example> Wed, 30 Nov 2016 20:21:38 GMT |

### Request path parameters

The following describes the parameters.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `bucket-name` | String | Required | Name of the bucket to view the object in |
| `object-name` | String | Required | Name of the object to view |

### Request example

The following is a sample request.

```
GET /example-bucket/worker-bee HTTP/1.1
Authorization: {authorization-string}
x-amz-date: 20160825T183244Z
Host: kr.object.ncloudstorage.com
```

## Responses

The following describes the response format.

### Response headers

For response headers common to all Object Storage APIs, see [Object Storage common response headers](/docs/en/storage-objectstorage#%EA%B3%B5%ED%86%B5%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94).

### Response status codes

For response status codes common to all Object Storage APIs, see [Object Storage response status codes](/docs/en/storage-objectstorage#%EC%98%A4%EB%A5%98%EC%BD%94%EB%93%9C).

### Response example

The following is a sample response.

```
HTTP/1.1 200 OK
Date: Thu, 25 Aug 2016 18:34:25 GMT
x-amz-request-id: 116dcd6b-215d-4a81-bd30-30291fa38f93
Accept-Ranges: bytes
ETag: "d34d8aada2996fc42e6948b926513907"
Content-Type: text/plain; charset=UTF-8
Last-Modified: Thu, 25 Aug 2016 17:46:53 GMT
Content-Length: 467

 Female bees that are not fortunate enough to be selected to be the 'queen'
 while they were still larvae become known as 'worker' bees. These bees lack
 the ability to reproduce and instead ensure that the hive functions smoothly,
 acting almost as a single organism in fulfilling their purpose.
```