---
title: "getCloudHadoopObjectList"
slug: "cli-vhadoop-getcloudhadoopobjectlist"
updated: 2026-05-21T09:01:59Z
published: 2026-05-21T09:11:30Z
canonical: "cli-gov.ncloud-docs.com/cli-vhadoop-getcloudhadoopobjectlist"
---

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

# getCloudHadoopObjectList

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

## 개요

Cloud Hadoop에서 사용할 수 있는 Object Storage 버킷의 파일 리스트를 조회합니다.

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| regionCode | No | String |  | - 리전 코드 - Cloud Hadoop Object 리스트를 조회할 리전(Region) 결정 가능 - regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능 - Default: getRegionList 조회 결과의 첫 번째 리전 선택 |
| bucketName | Yes | String |  | - 버킷 이름 - Object Storage에 데이터를 저장하기 위한 공간을 의미 - bucketName은 [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopbucketlist) 액션을 통해 획득 가능 |
| prefix | No | String |  | - 조회할 오브젝트 이름의 접두어 - prefix로 시작하는 오브젝트 이름에만 응답하도록 제한 |
| delimiter | No | String |  | - 오브젝트 구조의 위치 구분자 - prefix와 delimiter 사이에 있는 오브젝트를 하나로 묶음 |
| maxKeys | No | String |  | 응답에 표시할 오브젝트 개수 제한 |
| marker | No | String |  | UTF-8 바이너리 순서로 목록이 시작되어야 하는 위치부터 오브젝트 지정 |
| output | No | String |  | - 응답 결과의 포맷 타입 - Options: xml \| json - Default: xml |

## 응답

### 응답 데이터 타입

- CloudHadoopObjectList 타입

| CloudHadoopObjectList extends CommonResponse |
| --- |
| private Integer totalRows; |
| private String marker; |
| private String nextMarker; |
| private List<String> commonPrefixList; |
| private List<CloudHadoopObject> cloudHadoopObjectList = new ArrayList<>(); |

| CloudHadoopObjectList |
| --- |
| private String key; |
| private Date lastModified; |
| private Long size; |

## 예시

### 호출

```
ncloud vhadoop getCloudHadoopObjectList  --regionCode KR --bucketName test***
```

### 응답

```
<getCloudHadoopObjectListResponse>
    <requestId>d3b26cc2-d47e-4a97-9e9b-468dac851fb4</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>2</totalRows>
    <commonPrefixList/>
    <cloudHadoopObjectList>
        <cloudHadoopObject>
            <key>20210916-dasd002.backup.tar.gz</key>
            <lastModified>2021-09-16T14:45:23+0900</lastModified>
            <size>10142</size>
        </cloudHadoopObject>
        <cloudHadoopObject>
            <key>CONFIG-BACKUP/</key>
            <lastModified>2021-11-09T18:08:23+0900</lastModified>
            <size>0</size>
        </cloudHadoopObject>
    </cloudHadoopObjectList>
</getCloudHadoopObjectListResponse>
```