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 참조

선택 옵션

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

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

공통 옵션

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