---
title: "GetObject"
slug: "storage-archivestorage-getobject"
updated: 2026-09-17T09:58:32Z
published: 2026-09-17T09:58:32Z
canonical: "api.ncloud-docs.com/storage-archivestorage-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 | /v1/AUTH_{project_id}/{container}/{object} |

### リクエストヘッダ

ヘッダの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `X-Auth-Token` | String | Optional | 発行したトークンの値 |
| `X-Newest` | Boolean | Optional | 最新のコピー情報でレスポンスするかどうかを設定 - `true` \| `false` - `true`: すべてのコピーに対してクエリを行い、最新のコピー情報でレスポンス - ヘッダが省略された場合、レスポンスが最も早い情報でレスポンス |
| `Range` | String | Optional | 対象オブジェクトの範囲を指定 - `Bytes=-5`: 最後の5バイト - `Bytes=10-15`: 10バイトから15 バイトまでの6バイト - `Bytes=10-15,-5`: 10バイトから15バイトまでの6バイトと最後の5バイトを一緒に返す、`Content-Type`ヘッダを`multipart/byteranges`にして返す - `Bytes=6-`: 6バイトから最後まで - `Bytes=1-3,2-5`: 1バイトから3バイトまでの3バイトと、2バイトから5バイトまでの3バイトを一緒に返す、`Content-Type`ヘッダを`multipart/byteranges`にして返す |
| `If-Match` | String | Optional | ETag条件ヘッダ - 詳細は、[RFC2616](https://www.ietf.org/rfc/rfc2616.txt)で確認 |
| `If-None-Match` | String | Optional | ETag条件ヘッダ - 詳細は、[RFC2616](https://www.ietf.org/rfc/rfc2616.txt)で確認 |
| `If-Modified-Since` | String | Optional | Last-Modified条件ヘッダ - 詳細は、[RFC2616](https://www.ietf.org/rfc/rfc2616.txt)で確認 |
| `If-Unmodified-Since` | String | Optional | Last-Modified条件ヘッダ - 詳細は、[RFC2616](https://www.ietf.org/rfc/rfc2616.txt)で確認 |

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

リクエストパスパラメータの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `project_id` | String | Required | プロジェクト ID - プロジェクト IDの確認方法は、[Archive Storageの概要](/docs/ja/storage-archivestorage#%EC%9D%B8%EC%A6%9D)を参照 |
| `container` | String | Required | コンテナ(バケット)の名前 |
| `object` | String | Required | オブジェクト名 |

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

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `temp_url_sig` | String | Required | 保存するリソースにアクセス可能な仮 URLの署名 - 承認されたリクエストであることを検証 |
| `temp_url_expires` | Integer | Required | 保存するリソースにアクセス可能な仮 URLの有効期限(Unix Timestamp) |
| `filename` | String | Conditional | オブジェクトの保存場所とファイル名 |
| `multipart-manifest` | String | Conditional | 大容量オブジェクトのマルチパートアップロードを宣言 - Static大容量オブジェクトのマニフェストを取得する際に使用 - 値として`put`を入力するとマルチパートアップロードとして認識され、パートを１つのファイルに結合するようにサーバに指示 - リクエストボディにパートを結合するためのマニフェストを必ず作成 |

### リクエスト例

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

```
curl -X GET "https://kr.archive.ncloudstorage.com/v1/AUTH_{project_id}/{container}/{object}" 
-H "X-Auth-Token: $token"
```

## レスポンス

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

### レスポンスヘッダ

ヘッダの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `Content-Type` | String | - | レスポンス結果の MIMEタイプ |
| `ETag` | String | - | ETagヘッダの値 |
| `Last-Modified` | String | - | オブジェクトの最終更新時間(UTC) |
| `X-Timestamp` | Integer | - | オブジェクトが作成された時刻(Unix Timestamp) |
| `Accept-Ranges` | String | - | オブジェクトが対応する範囲タイプ |
| `Content-Length` | String | - | レスポンス結果の長さ(Byte) |
| `X-Trans-Id` | String | - | リクエストのトランザクション ID |
| `X-Openstack-Request-Id` | String | - | リクエストのトランザクション ID - `X-Trans-Id`と同じ |
| `X-Object-Meta-{name}` | String | - | 設定するメタデータ - `{name}`部分にメタデータのキーを入力 - ヘッダの値にメタデータの値を入力 |
| `Content-Disposition` | String | - | ブラウザのレスポンス処理方式 |
| `Content-Encoding` | String | - | オブジェクトのエンコード方式 |
| `X-Delete-At` | Integer | - | オブジェクトの自動削除予定時刻(Unix Timestamp) - データを一時的に保存する場合に使用 - 入力された日時にオブジェクトを削除 |
| `X-Object-Manifest` | String | - | 大容量オブジェクトをアップロードする場合、オブジェクト(SLO)のマニフェスト - 形式: `{container}/{prefix}` |
| `Date` | String | - | リクエストのレスポンスタイム(UTC) |
| `X-Static-Large-Object` | Boolean | - | 大容量オブジェクト(SLO)かどうか - `true` \| `false` |

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

レスポンスステータスコードの説明は次の通りです。

| HTTPステータスコード | コード | メッセージ | 説明 |
| --- | --- | --- | --- |
| 200 | - | OK | リクエスト成功 |
| 206 | - | Partial Content | Rangeパラメータを通じて、オブジェクト内容一部のリクエストが成功 |
| 403 | - | Not Found | コンテナ(バケット)は存在しない |

### レスポンス例

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

```
HTTP/1.1 200 OK
Content-Length: 210012
Accept-Ranges: bytes
Last-Modified: Tue, 11 Sep 2018 02:12:30 GMT
Etag: 9bd5b4f25faf491080654a34d57c3636
X-Timestamp: 1536631949.99141
Content-Type: text/plain
X-Trans-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
X-Openstack-Request-Id: tx9b5c78b06d0f41c5bd4bf-005b989fb7
Date: Wed, 12 Sep 2018 05:10:15 GMT
```