---
title: "getCloudHadoopObjectList"
slug: "cli-vhadoop-getcloudhadoopobjectlist"
tags: ["Cloud Hadoop", "VPC", "Object Storage"]
updated: 2026-10-08T05:10:55Z
published: 2026-10-08T05:10:55Z
canonical: "cli.ncloud-docs.com/cli-vhadoop-getcloudhadoopobjectlist"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# getCloudHadoopObjectList

Available in VPC

Get the list of objects in an Object Storage bucket integrated with a Cloud Hadoop cluster.

## Syntax

The `getCloudHadoopObjectList` syntax is as follows:

```
./ncloud vhadoop getCloudHadoopObjectList \
    --bucketName <bucket-name> \
    [--prefix <prefix>] \
    [--delimiter <delimiter>] \
    [--maxKeys <max-keys>] \
    [--marker <marker>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

## Options

This section describes the options available when running `getCloudHadoopObjectList`.

### Required options

The following options are required for `getCloudHadoopObjectList`.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--bucketName` | String | Required | Bucket name - See [getCloudHadoopBucketList](/docs/en/cli-vhadoop-getcloudhadoopbucketlist). |

### Optional options

These are the optional options for `getCloudHadoopObjectList`. Options that are not specified will use their default values.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--prefix` | String | Optional | Object name prefix - Filters only objects that start with a prefix. |
| `--delimiter` | String | Optional | Delimiter character - Objects containing delimiter characters are displayed only as prefixes in the response's `commonPrefixList` and are excluded from the list of individual objects. |
| `--maxKeys` | String | Optional | Maximum number of files to display in the response |
| `--marker` | String | Optional | Response start point - Displays objects after the starting point in UTF-8 binary order. |

### Common options

For information about the options common to all `vhadoop` subcommands, see [Cloud Hadoop (VPC) options](/docs/en/cli-vhadoop#%EC%98%B5%EC%85%98).

## Examples

If the request to retrieve the list of objects in a Cloud Hadoop bucket is successful, the identification information and metadata for each object are returned.

### Command

The command example is as follows:

```
./ncloud vhadoop getCloudHadoopObjectList \
    --bucketName my-test-bucket \
    --delimiter / \
    --maxKeys 100 \
    --regionCode KR \
    --output json
```

### Output

The output example is as follows:

```
{
  "getCloudHadoopObjectListResponse": {
    "commonPrefixList": [
      "cloud-db-for-mysql/",
      "mssql-export-test/"
    ],
    "cloudHadoopObjectList": [
      {
        "key": "20260609-190130F.tar",
        "lastModified": "2026-06-09T19:18:11+0900",
        "size": 8734720
      },
      {
        "key": "202606101507.1781071827",
        "lastModified": "2026-06-10T15:10:28+0900",
        "size": 174
      },
      {
        "key": "202606101507.1781071829",
        "lastModified": "2026-06-10T15:10:29+0900",
        "size": 174
      },
      {
        "key": "202606101507.1781071830",
        "lastModified": "2026-06-10T15:10:30+0900",
        "size": 174
      },
      {
        "key": "202607011320.1782879765",
        "lastModified": "2026-07-01T13:22:46+0900",
        "size": 112
      },
      {
        "key": "postgresql-2026-06-09_182710.log",
        "lastModified": "2026-06-09T18:55:14+0900",
        "size": 2712
      }
    ],
    "requestId": "f6071829-daeb-c345-f012-6789abc34567",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```