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.

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.

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"
  }
}