---
title: "getCloudHadoopObjectList"
slug: "cli-vhadoop-getcloudhadoopobjectlist"
updated: 2026-09-17T09:15:56Z
published: 2026-09-17T09:15:56Z
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

VPC 환경에서 이용 가능합니다.

Cloud Hadoop 클러스터에 연동된 Object Storage 버킷의 객체 목록을 조회합니다.

## 구문

`getCloudHadoopObjectList` 구문은 다음과 같습니다.

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

## 옵션

`getCloudHadoopObjectList` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`getCloudHadoopObjectList`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--bucketName` | String | Required | 버킷 이름 - [getCloudHadoopBucketList](/docs/cli-vhadoop-getcloudhadoopbucketlist) 참조 |

### 선택 옵션

`getCloudHadoopObjectList`의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--prefix` | String | Optional | 객체 이름 접두사 - 접두사로 시작하는 객체만 필터링 |
| `--delimiter` | String | Optional | 구분 문자 - 구분 문자가 포함된 객체는 응답의 `commonPrefixList`에 접두사만 표시되며, 개별 객체 목록에서 제외 |
| `--maxKeys` | String | Optional | 응답에 표시할 최대 파일 수 |
| `--marker` | String | Optional | 응답 시작점 - 시작점 이후의 객체를 UTF-8 바이너리 순서로 표시 |

### 공통 옵션

`vhadoop` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud Hadoop (VPC) 옵션](/docs/cli-vhadoop#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

Cloud Hadoop 버킷의 객체 목록 조회 요청이 성공하면 각 객체의 식별 정보와 메타 정보가 반환됩니다.

### 명령

명령 예시는 다음과 같습니다.

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

### 출력

출력 예시는 다음과 같습니다.

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