getCloudHadoopInstanceList
Classic 환경에서 이용 가능합니다.
Cloud Hadoop 클러스터 목록을 조회합니다.
요청
요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.
| 메서드 | URI |
|---|
| GET | POST | /hadoop/v2/getCloudHadoopInstanceList |
참고
가이드는 GET 방식 기준으로 안내합니다. POST 방식의 호출 테스트는 네이버 클라우드 플랫폼 콘솔의 API Gateway 서비스에서 Swagger를 통해서 가능합니다.
요청 헤더
Cloud Hadoop API에서 공통으로 사용하는 헤더에 대한 정보는 Cloud Hadoop 요청 헤더를 참조해 주십시오.
요청 쿼리 파라미터
요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|
regionNo | String | Optional | 리전 번호 |
zoneNo | String | Optional | 존 번호로 필터링 |
cloudHadoopInstanceNo | String | Optional | 클러스터 인스턴스 번호로 필터링 |
searchFilterName | String | Optional | 검색 컬럼clusterName: 클러스터 이름 (유효 값)searchFilterValue를 입력한 경우, 필수 입력
|
searchFilterValue | String | Optional | 검색 키워드- 검색 컬럼 옵션(
clusterName)과 전체 일치하지 않는 값을 입력한 경우, 응답에 빈 값 표시 searchFilterName 없이 요청하는 경우, 전체 목록 표시
|
pageNo | Integer | Optional | 페이지 번호 |
pageSize | Integer | Optional | 페이지 출력 수 |
responseFormatType | String | Optional | 응답 데이터의 형식 |
요청 예시
요청 예시는 다음과 같습니다.
응답
응답 형식을 설명합니다.
응답 바디
응답 바디에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|
getCloudHadoopInstanceListResponse | Object | - | 응답 결과 |
getCloudHadoopInstanceListResponse.totalRows | Integer | - | 응답 결과 수 |
getCloudHadoopInstanceListResponse.cloudHadoopInstanceList | Array | - | 클러스터 목록 |
getCloudHadoopInstanceListResponse.requestId | String | - | 요청에 대한 아이디 |
getCloudHadoopInstanceListResponse.returnCode | String | - | 응답 코드 |
getCloudHadoopInstanceListResponse.returnMessage | String | - | 응답 메시지 |
getCloudHadoopInstanceListResponse.cloudHadoopInstanceList
getCloudHadoopInstanceListResponse.cloudHadoopInstanceList에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|
cloudHadoopInstanceNo | String | - | 클러스터 인스턴스 번호 |
cloudHadoopClusterName | String | - | 클러스터 이름 |
cloudHadoopImageProductCode | String | - | 클러스터 이미지 코드 |
cloudHadoopClusterType | Object | - | 클러스터 타입 정보cloudHadoopInstanceStatusName이 running 또는 settingup인 경우, 표시
|
cloudHadoopClusterType.code | String | - | 클러스터 타입 코드CHADP | HBASE | SPARK | PRESTOCHADP: Core HadoopHBASE: HBaseSPARK: SparkPRESTO: Presto
|
cloudHadoopClusterType.codeName | String | - | 클러스터 타입 코드 이름 |
masterNodeCpuCount | Integer | - | 마스터노드 CPU 수 |
masterNodeCount | Integer | - | 마스터노드 수 |
masterNodeMemorySize | Integer | - | 마스터노드 메모리 용량(Byte) |
workerNodeCpuCount | Integer | - | 작업자노드 CPU 수 |
workerNodeCount | Integer | - | 작업자노드 수 |
workerNodeMemorySize | Integer | - | 작업자노드 메모리 용량(Byte) |
edgeNodeCpuCount | Integer | - | 엣지노드 CPU 수 |
edgeNodeCount | Integer | - | 엣지노드 수 |
edgeNodeMemorySize | Integer | - | 엣지노드 메모리 용량(Byte) |
cloudHadoopInstanceStatus | Object | - | 클러스터 상태 정보cloudHadoopInstanceStatusName이 creating인 경우, 표시
|
cloudHadoopInstanceStatus.code | String | - | 클러스터 상태 코드INIT: Cloud Hadoop INIT 상태
|
cloudHadoopInstanceStatus.codeName | String | - | 클러스터 상태 코드 이름 |
cloudHadoopInstanceOperation | Object | - | 클러스터 운영 정보cloudHadoopInstanceStatusName이 running 또는 settingup인 경우, 표시
|
cloudHadoopInstanceOperation.code | String | - | 클러스터 운영 코드SETUP | NULLSETUP: Cloud Hadoop SETUP OPNULL: Cloud Hadoop NULL OP
|
cloudHadoopInstanceOperation.codeName | String | - | 클러스터 운영 코드 이름 |
cloudHadoopInstanceStatusName | String | - | 클러스터 상태 이름creating | running | settingup | deletingcreating: 생성 중running: 운영 중settingup: 설정 중deleting: 삭제 중
|
publicDnsName | String | - | 공인 도메인 |
publicIp | String | - | 공인 IP 주소 |
isHa | Boolean | - | 고가용성 지원 여부 |
zone | Object | - | 존 정보 |
zone.zoneNo | String | - | 존 번호 |
zone.zoneName | String | - | 존 이름 |
zone.zoneCode | String | - | 존 코드 |
zone.zoneDescription | String | - | 존 설명 |
zone.regionNo | String | - | 리전 번호 |
region | Object | - | 리전 정보 |
region.regionNo | String | - | 리전 번호 |
region.regionCode | String | - | 리전 코드 |
region.regionName | String | - | 리전 이름 |
masterNodeServerName | String | - | 마스터노드 서버 이름 |
createDate | String | - | 클러스터 생성 일시 |
dataArchitecture | String | - | 데이터 아키텍처 |
bucketName | String | - | Object Storage 버킷 이름 |
directConnectionAccount | String | - | 클러스터 직접 접속 계정 |
loginKeyName | String | - | 인증키 이름 |
accessControlGroupList | Array | - | ACG 목록 |
accessControlGroupList
accessControlGroupList에 대한 설명은 다음과 같습니다.
| 필드 | 타입 | 필수 여부 | 설명 |
|---|
accessControlGroupConfigurationNo | String | - | ACG 아이디 |
accessControlGroupName | String | - | ACG 이름 |
accessControlGroupDescription | String | - | ACG에 대한 메모 |
isDefault | Boolean | - | 기본 ACG 여부true | falsetrue: 기본 ACGfalse: 기본 ACG 아님
|
createDate | String | - | ACG 생성 일시 |
응답 상태 코드
Cloud Hadoop API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Cloud Hadoop 응답 상태 코드를 참조해 주십시오.
응답 예시
응답 예시는 다음과 같습니다.
{
"getCloudHadoopInstanceListResponse": {
"totalRows": 3,
"cloudHadoopInstanceList": [
{
"cloudHadoopInstanceNo": "2777****",
"cloudHadoopClusterName": "cluster001",
"cloudHadoopImageProductCode": "SPSWCHADPLINUX02",
"masterNodeCpuCount": 4,
"masterNodeCount": 2,
"masterNodeMemorySize": 8589934592,
"workerNodeCpuCount": 4,
"workerNodeCount": 2,
"workerNodeMemorySize": 17179869184,
"cloudHadoopInstanceStatus": {
"code": "INIT",
"codeName": "Cloud Hadoop INIT 상태"
},
"cloudHadoopInstanceStatusName": "creating",
"isHa": true,
"zone": {
"zoneNo": "3",
"zoneName": "KR-2",
"zoneCode": "KR-2",
"zoneDescription": "평촌 zone",
"regionNo": "1"
},
"region": {
"regionNo": "1",
"regionCode": "KR",
"regionName": "Korea"
},
"masterNodeServerName": "m-001-cluster001-hd",
"createDate": "2025-02-28T13:56:45+0900",
"dataArchitecture": "OBJST",
"bucketName": "nb002",
"directConnectionAccount": "sshuser",
"loginKeyName": "test-123",
"accessControlGroupList": [
{
"accessControlGroupConfigurationNo": "192****",
"accessControlGroupName": "cloud-hadoop-gjcmb",
"accessControlGroupDescription": "Group for Cloud Hadoop cluster cluster001 (automatically created)",
"isDefault": false,
"createDate": "2025-02-28T13:56:47+0900"
}
]
},
{
"cloudHadoopInstanceNo": "2777****",
"cloudHadoopClusterName": "cluster000",
"cloudHadoopImageProductCode": "SPSWCHADPLINUX03",
"masterNodeCpuCount": 4,
"masterNodeCount": 2,
"masterNodeMemorySize": 8589934592,
"workerNodeCpuCount": 4,
"workerNodeCount": 2,
"workerNodeMemorySize": 34359738368,
"edgeNodeCpuCount": 4,
"edgeNodeCount": 1,
"edgeNodeMemorySize": 8589934592,
"cloudHadoopInstanceStatusName": "deleting",
"publicDnsName": "****.hadoop.ntruss.com",
"publicIp": "***.***.***.***",
"isHa": true,
"zone": {
"zoneNo": "3",
"zoneName": "KR-2",
"zoneCode": "KR-2",
"zoneDescription": "평촌 zone",
"regionNo": "1"
},
"region": {
"regionNo": "1",
"regionCode": "KR",
"regionName": "Korea"
},
"masterNodeServerName": "m-001-cluster000-hd",
"createDate": "2025-02-28T13:04:38+0900",
"dataArchitecture": "OBJST",
"bucketName": "nb001",
"directConnectionAccount": "sshuser",
"loginKeyName": "test-123",
"accessControlGroupList": [
{
"accessControlGroupConfigurationNo": "192****",
"accessControlGroupName": "cloud-hadoop-gjcel",
"accessControlGroupDescription": "Group for Cloud Hadoop cluster cluster000 (automatically created)",
"isDefault": false,
"createDate": "2025-02-28T13:04:40+0900"
}
]
},
{
"cloudHadoopInstanceNo": "2777****",
"cloudHadoopClusterName": "cluster",
"cloudHadoopImageProductCode": "SPSWCHADPLINUX03",
"cloudHadoopClusterType": {
"code": "CHADP",
"codeName": "Core Hadoop"
},
"masterNodeCpuCount": 4,
"masterNodeCount": 2,
"masterNodeMemorySize": 8589934592,
"workerNodeCpuCount": 4,
"workerNodeCount": 22,
"workerNodeMemorySize": 34359738368,
"edgeNodeCpuCount": 4,
"edgeNodeCount": 1,
"edgeNodeMemorySize": 8589934592,
"cloudHadoopInstanceOperation": {
"code": "NULL",
"codeName": "Cloud Hadoop NULL OP"
},
"cloudHadoopInstanceStatusName": "running",
"publicDnsName": "****.hadoop.ntruss.com",
"publicIp": "***.***.***.***",
"isHa": true,
"zone": {
"zoneNo": "3",
"zoneName": "KR-2",
"zoneCode": "KR-2",
"zoneDescription": "평촌 zone",
"regionNo": "1"
},
"region": {
"regionNo": "1",
"regionCode": "KR",
"regionName": "Korea"
},
"masterNodeServerName": "m-001-cluster-hd",
"createDate": "2025-02-28T09:16:46+0900",
"dataArchitecture": "OBJST",
"bucketName": "dataforest",
"directConnectionAccount": "sshuser",
"loginKeyName": "test-123",
"accessControlGroupList": [
{
"accessControlGroupConfigurationNo": "192****",
"accessControlGroupName": "cloud-hadoop-gjb5m",
"accessControlGroupDescription": "Group for Cloud Hadoop cluster cluster (automatically created)",
"isDefault": false,
"createDate": "2025-02-28T09:16:48+0900"
}
]
}
],
"requestId": "af2c44e0-****-****-****-99c9f669ad22",
"returnCode": "0",
"returnMessage": "success"
}
}
의견을 보내 주셔서 감사합니다! 우리 팀이 당신에게 돌아갈 것입니다.
