---
title: "ListObjectsV2"
slug: "ncloudstorage-listobjectsv2"
updated: 2026-09-17T09:58:30Z
published: 2026-09-17T09:58:30Z
canonical: "api.ncloud-docs.com/ncloudstorage-listobjectsv2"
---

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

# ListObjectsV2

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

Ncloud Storageバケットに保存されているオブジェクトリストを照会します。

## リクエスト

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

| メソッド | URI |
| --- | --- |
| GET | - |

### リクエストヘッダ

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

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

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `list-type` | Integer | Required | バージョン区分 - `2` (有効値) - 入力しない場合、[ListObjects](/docs/ja/ncloudstorage-listobjects)で動作 |
| `continuation-token` | String | Optional | 次のページ照会の識別子 - 以前のレスポンス結果の`NextContinuationToken` - [レスポンスボディ](/docs/ja/ncloudstorage-listobjectsv2#%EC%9D%91%EB%8B%B5%EB%B0%94%EB%94%94)を参照 |
| `max-keys` | String | Optional | ページごとの項目数 - 1~1,000 |
| `prefix` | String | Optional | オブジェクト名の接頭辞 |
| `start-after` | String | Optional | 照会開始の基準 |

### リクエスト例

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

```
GET /?list-type=2&max-keys=1&start-after=object.csv HTTP/1.1
Host: bucket.kr.ncloudstorage.com
```

## レスポンス

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

### レスポンスヘッダ

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

### レスポンスボディ

レスポンスボディの説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `ListBucketResult` | Object | - | オブジェクトリスト照会の結果 |
| `ListBucketResult.Name` | String | - | バケット名 |
| `ListBucketResult.Prefix` | String | - | オブジェクト名の接頭辞 |
| `ListBucketResult.StartAfter` | String | - | 照会開始の基準 |
| `ListBucketResult.ContinuationToken` | String | - | ページ照会識別子 |
| `ListBucketResult.NextContinuationToken` | String | - | 次のページ照会の識別子 - `IsTruncated`が`true`の場合に表示 - 長さ: 0~1,024 (Byte) |
| `ListBucketResult.KeyCount` | Integer | - | レスポンス結果数 |
| `ListBucketResult.MaxKeys` | Integer | - | ページごとの項目数 |
| `ListBucketResult.IsTruncated` | Boolean | - | 以降のページは存在するかどうか - `true` \| `false` - `true`: 存在する - `false`: 存在しない |
| `ListBucketResult.Contents` | Array | - | [オブジェクトリスト](/docs/ja/ncloudstorage-listobjectsv2#contents) |

#### `Contents`

`Contents`の説明は次の通りです。

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `Key` | String | - | オブジェクト名 |
| `LastModified` | String | - | 最終更新日時 - ISO 8601形式 |
| `ETag` | String | - | オブジェクトの固有 ID(Entity Tag) |
| `Size` | Integer | - | オブジェクトのサイズ(Byte) |
| `StorageClass` | String | - | ストレージクラス - `STANDARD` \| `DEEP_ARCHIVE` - `STANDARD`: Standard Class - `DEEP_ARCHIVE`: Archive Class |

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

Ncloud Storage APIで共通して使用されるレスポンスステータスコードの詳細は、[Ncloud Storageのレスポンスステータスコード](/docs/ja/storage-ncloudstorage#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

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

```
HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult>
    <Name>bucket</Name>
    <Prefix></Prefix>
    <StartAfter>object.csv</StartAfter>
    <NextContinuationToken>bGlicmFyeV**********b3B5LmNzdg==</NextContinuationToken>
    <KeyCount>1</KeyCount>
    <MaxKeys>1</MaxKeys>
    <IsTruncated>true</IsTruncated>
    <Contents>
        <Key>object.csv</Key>
        <LastModified>2025-04-23T01:55:37Z</LastModified>
        <ETag>"2ecf9f32d97***********39aed87829"</ETag>
        <Size>464</Size>
        <StorageClass>STANDARD</StorageClass>
    </Contents>
</ListBucketResult>
```