getCloudHadoopObjectList

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	버킷 이름 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-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"
  }
}