getCloudHadoopObjectList

Prev Next

개요

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

요청

요청 파라미터

파라미터명 필수 여부 타입 제약 사항 설명
regionCode No String - 리전 코드
- Cloud Hadoop Object 리스트를 조회할 리전(Region) 결정 가능
- regionCode는 getRegionList 액션을 통해서 획득 가능
- Default: getRegionList 조회 결과의 첫 번째 리전을 선택
bucketName Yes String - 버킷 이름
- Object Storage에 데이터를 저장하기 위한 공간을 의미
- bucketName은 getCloudHadoopInstanceList 액션을 통해 획득 가능
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 FKR --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>