VPC 환경에서 이용 가능합니다.
서버 이미지 목록을 조회합니다.
구문
getServerImageList 구문은 다음과 같습니다.
./ncloud vserver getServerImageList \
[--serverImageNoList <server-image-no-list>] \
[--serverImageName <server-image-name>] \
[--serverImageStatusCode <INIT|CREAT|CREFL>] \
[--serverImageTypeCodeList <SELF|NCP>] \
[--hypervisorTypeCodeList <XEN|KVM>] \
[--osTypeCodeList <CENTOS|UBUNTU|WINDOWS|ROCKY|NAVIX>] \
[--platformCategoryCodeList <OS|APP|DBMS|GPU>] \
[--pageNo <page-no>] \
[--pageSize <page-size>] \
[--sortedBy <serverImageName>] \
[--sortingOrder <ASC|DESC>] \
[--regionCode <KR|SGN|JPN>] \
[--output <json|xml>]
옵션
getServerImageList 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
getServerImageList의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--pageSize |
Integer | Conditional | 페이지당 항목 수
|
선택 옵션
getServerImageList의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--serverImageNoList |
List | Optional | 서버 이미지 번호 목록
|
--serverImageName |
String | Optional | 서버 이미지 이름 |
--serverImageStatusCode |
String | Optional | 서버 이미지 상태 코드
|
--serverImageTypeCodeList |
List | Optional | 서버 이미지 유형 코드 목록
|
--hypervisorTypeCodeList |
List | Optional | 하이퍼바이저 타입 코드 목록
|
--osTypeCodeList |
List | Optional | 운영 체제 타입 코드 목록
|
--platformCategoryCodeList |
List | Optional | 플랫폼 카테고리 코드 목록
|
--pageNo |
Integer | Optional | 페이지 번호
|
--sortedBy |
String | Optional | 정렬 기준
|
--sortingOrder |
String | Optional | 정렬 순서
|
공통 옵션
vserver 명령에서 공통으로 사용하는 옵션에 대한 정보는 Server (VPC) 옵션을 참조해 주십시오.
예시
서버 이미지 목록 조회 요청이 성공하면 각 서버 이미지의 식별 및 구성 정보가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vserver getServerImageList \
--serverImageStatusCode CREAT \
--serverImageTypeCodeList SELF \
--hypervisorTypeCodeList KVM \
--osTypeCodeList NAVIX \
--platformCategoryCodeList OS \
--pageNo 0 \
--pageSize 10 \
--sortedBy serverImageName \
--sortingOrder ASC \
--regionCode KR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"getServerImageListResponse": {
"totalRows": 2,
"serverImageList": [
{
"serverImageNo": "45678901",
"serverImageName": "test-server-image-01",
"serverImageDescription": "Test server image",
"serverImageType": {
"code": "SELF",
"codeName": "SELF 서버이미지"
},
"serverImageLifeCyclePhase": {
"code": "IN_SERVICE",
"codeName": "In Service"
},
"hypervisorType": {
"code": "KVM",
"codeName": "KVM"
},
"cpuArchitectureType": {
"code": "X86_64",
"codeName": "x86 64bit"
},
"osCategoryType": {
"code": "LINUX",
"codeName": "LINUX"
},
"osType": {
"code": "NAVIX",
"codeName": "NAVIX"
},
"serverImageStatus": {
"code": "CREAT",
"codeName": "NSI CREATED state"
},
"serverImageOperation": {
"code": "NULL",
"codeName": "NSI NULL OP"
},
"serverImageStatusName": "created",
"shareStatus": {
"code": "NULL",
"codeName": "NSI Share NULL State"
},
"blockStorageMappingList": [
{
"order": 0,
"blockStorageSnapshotInstanceNo": 90123456,
"blockStorageSnapshotName": "n01234567890abcd",
"blockStorageSize": 10737418240,
"blockStorageVolumeType": {
"code": "CB1",
"codeName": "Common BlockStorage 1"
},
"iops": 100,
"throughput": 104857600,
"isEncryptedVolume": false
}
],
"sharedLoginIdList": [],
"serverImageProductCode": "SW.VSVR.OS.LNX64.NAVIX.09.G003",
"createDate": "2026-05-14T16:25:00+0900",
"platformCategoryCode": "OS"
},
{
"serverImageNo": "45678902",
"serverImageName": "test-server-image-fromsnap-01",
"serverImageType": {
"code": "SELF",
"codeName": "SELF 서버이미지"
},
"serverImageLifeCyclePhase": {
"code": "IN_SERVICE",
"codeName": "In Service"
},
"hypervisorType": {
"code": "KVM",
"codeName": "KVM"
},
"cpuArchitectureType": {
"code": "X86_64",
"codeName": "x86 64bit"
},
"osCategoryType": {
"code": "LINUX",
"codeName": "LINUX"
},
"osType": {
"code": "NAVIX",
"codeName": "NAVIX"
},
"serverImageStatus": {
"code": "CREAT",
"codeName": "NSI CREATED state"
},
"serverImageOperation": {
"code": "NULL",
"codeName": "NSI NULL OP"
},
"serverImageStatusName": "created",
"shareStatus": {
"code": "NULL",
"codeName": "NSI Share NULL State"
},
"blockStorageMappingList": [
{
"order": 0,
"blockStorageSnapshotInstanceNo": 90123457,
"blockStorageSnapshotName": "test-bootable-snap-01",
"blockStorageSize": 10737418240,
"blockStorageVolumeType": {
"code": "CB1",
"codeName": "Common BlockStorage 1"
},
"iops": 100,
"throughput": 104857600,
"isEncryptedVolume": false
}
],
"sharedLoginIdList": [],
"serverImageProductCode": "SW.VSVR.OS.LNX64.NAVIX.09.G003",
"createDate": "2026-05-14T16:31:28+0900",
"platformCategoryCode": "OS"
}
],
"requestId": "d4e5f678-9012-3456-def0-456789012345",
"returnCode": "0",
"returnMessage": "success"
}
}