ListObjectsV2

Prev Next

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

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

リクエスト

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

メソッド URI
GET -

リクエストヘッダ

Ncloud Storage APIで共通して使用されるヘッダの詳細は、Ncloud Storageのリクエストヘッダをご参照ください。

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

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

フィールド タイプ 必須の有無 説明
list-type Integer Required バージョン区分
  • 2 (有効値)
  • 入力しない場合、ListObjectsで動作
continuation-token String Optional 次のページ照会の識別子
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のレスポンスヘッダをご参照ください。

レスポンスボディ

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

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

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のレスポンスステータスコードをご参照ください。

レスポンス例

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

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>&#34;2ecf9f32d97***********39aed87829&#34;</ETag>
        <Size>464</Size>
        <StorageClass>STANDARD</StorageClass>
    </Contents>
</ListBucketResult>