---
title: "GetObject"
slug: "storage-objectstorage-getobject"
updated: 2026-09-17T09:58:30Z
published: 2026-09-17T09:58:30Z
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

Classic/VPC環境で利用できます。

指定したヘッダを利用してオブジェクトを照会します。オペレーションに使用されるリクエストクエリパラメータ、リクエストボディはありません。

## リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

| メソッド | URI |
| --- | --- |
| GET | /{bucket-name}/{object-name} |

### リクエスト構文

リクエスト構文は次の通りです。

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

### リクエストヘッダ

GetObjectヘッダを紹介します。Object Storage APIリクエストで共通して使用されるヘッダの詳細は、[Object Storage共通リクエストヘッダ](/docs/ja/storage-objectstorage#%EA%B3%B5%ED%86%B5%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `range` | String | Optional | 指定の範囲内でオブジェクトの容量をバイト(Byte)単位で返す |
| `if-match` | String | Optional | 指定した ETag文字列がソースオブジェクトと一致する場合、オブジェクトを返す |
| `if-none-match` | String | Optional | 指定した ETag文字列がソースオブジェクトと一致しない場合、オブジェクトを返す |
| `if-unmodified-since` | String | Optional | 指定した日付以降にソースオブジェクトを変更しなかった場合、オブジェクトを返す - 有効な日付形式であることが必要 - <例> Wed, 30 Nov 2016 20:21:38 GMT |
| `if-modified-since` | String | Optional | 指定した日付以降にソースオブジェクトを変更した場合、オブジェクトを返す - 有効な日付形式であることが必要 - <例> Wed, 30 Nov 2016 20:21:38 GMT |

### リクエストパスパラメータ

パラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `bucket-name` | String | Required | オブジェクトを照会するバケットの名前 |
| `object-name` | String | Required | 照会するオブジェクトの名前 |

### リクエスト例

リクエストのサンプルコードは次の通りです。

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

## レスポンス

レスポンス形式を説明します。

### レスポンスヘッダ

Object Storage APIで共通して使用されるレスポンスヘッダの詳細は、[Object Storageの共通レスポンスヘッダ](/docs/ja/storage-objectstorage#%EA%B3%B5%ED%86%B5%EC%9D%91%EB%8B%B5%ED%97%A4%EB%8D%94)をご参照ください。

### レスポンスステータスコード

Object Storage APIで共通して使用されるレスポンスステータスコードの詳細は、[Object Storageのレスポンスステータスコード](/docs/ja/storage-objectstorage#%EC%98%A4%EB%A5%98%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

レスポンスのサンプルコードは次の通りです。

```
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.
```