VPC 환경에서 이용 가능합니다.
Cloud Hadoop 클러스터에 연동된 Object Storage 버킷의 객체 목록을 조회합니다.
구문
getCloudHadoopObjectList 구문은 다음과 같습니다.
./ncloud vhadoop getCloudHadoopObjectList \
--bucketName <bucket-name> \
[--prefix <prefix>] \
[--delimiter <delimiter>] \
[--maxKeys <max-keys>] \
[--marker <marker>] \
[--regionCode <KR|KRS>] \
[--output <json|xml>]
옵션
getCloudHadoopObjectList 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
getCloudHadoopObjectList의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--bucketName |
String | Required | 버킷 이름 |
선택 옵션
getCloudHadoopObjectList의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--prefix |
String | Optional | 객체 이름 접두사
|
--delimiter |
String | Optional | 구분 문자
|
--maxKeys |
String | Optional | 응답에 표시할 최대 파일 수 |
--marker |
String | Optional | 응답 시작점
|
공통 옵션
vhadoop 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud Hadoop (VPC) 옵션을 참조해 주십시오.
예시
Cloud Hadoop 버킷의 객체 목록 조회 요청이 성공하면 각 객체의 식별 정보와 메타 정보가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vhadoop getCloudHadoopObjectList \
--bucketName my-test-bucket \
--delimiter / \
--maxKeys 100 \
--regionCode KR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"getCloudHadoopObjectListResponse": {
"commonPrefixList": [
"cloud-db-for-mysql/",
"mssql-backup/"
],
"cloudHadoopObjectList": [
{
"key": "20260706-000014F.tar",
"lastModified": "2026-07-06T12:00:35+0900",
"size": 5877760
},
{
"key": "20260708.1783476538",
"lastModified": "2026-07-08T11:08:59+0900",
"size": 112
},
{
"key": "20260708.1783476643",
"lastModified": "2026-07-08T11:10:43+0900",
"size": 112
},
{
"key": "mongos.log.2026-07-01T20-00-01",
"lastModified": "2026-07-02T11:57:52+0900",
"size": 31950106
},
{
"key": "postgresql-2026-07-03_000000.log",
"lastModified": "2026-07-06T13:47:08+0900",
"size": 822
}
],
"requestId": "70992e21-11ec-459e-8b04-b6e416a8915b",
"returnCode": "0",
"returnMessage": "success"
}
}