---
title: "getCloudHadoopObjectList"
slug: "cli-vhadoop-getcloudhadoopobjectlist"
updated: 2026-04-23T09:04:50Z
published: 2026-04-23T09:07:28Z
---

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

# getCloudHadoopObjectList

## 개요<a name="개요"></a>

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

## 요청<a name="요청"></a>

### 요청 파라미터<a name="요청파라미터"></a>

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

## 응답<a name="응답"></a>

### 응답 데이터 타입<a name="응답데이터타입"></a>

- CloudHadoopObjectList 타입

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

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

## 예시<a name="예시"></a>

### 호출<a name="호출"></a>

```http
ncloud vhadoop getCloudHadoopObjectList  --regionCode FKR --bucketName test***
```

### 응답<a name="응답"></a>

```xml
<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>
```