내 서버 이미지를 생성합니다.
구문
createServerImage 구문은 다음과 같습니다.
./ncloud vserver createServerImage \
--serverInstanceNo <server-instance-no> \
--serverImageName <server-image-name> \
[--blockStorageList <block-storage-config>] \
[--serverImageDescription <description>] \
[--regionCode <FKR>] \
[--output <json|xml>]
옵션
createServerImage 실행 시 지정할 수 있는 옵션을 설명합니다.
필수 옵션
createServerImage의 필수 옵션입니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--serverInstanceNo |
String | Required | 원본 서버의 인스턴스 번호 |
--serverImageName |
String | Required | 서버 이미지 이름
|
선택 옵션
createServerImage의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.
| 옵션 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
--blockStorageList |
List | Optional | 서버 이미지에 추가할 블록 스토리지 목록
|
--serverImageDescription |
String | Optional | 서버 이미지 설명 (Byte)
|
공통 옵션
vserver 명령에서 공통으로 사용하는 옵션에 대한 정보는 Server 옵션을 참조해 주십시오.
예시
서버 이미지 생성 요청이 성공하면 서버 이미지의 식별 정보와 생성 상태가 반환됩니다.
명령
명령 예시는 다음과 같습니다.
./ncloud vserver createServerImage \
--serverInstanceNo 34567890 \
--serverImageName test-server-image-01 \
--serverImageDescription "Test server image" \
--regionCode FKR \
--output json
출력
출력 예시는 다음과 같습니다.
{
"createServerImageResponse": {
"totalRows": 1,
"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": "XEN",
"codeName": "XEN"
},
"cpuArchitectureType": {
"code": "X86_64",
"codeName": "x86 64bit"
},
"osCategoryType": {
"code": "LINUX",
"codeName": "LINUX"
},
"osType": {
"code": "UBUNTU",
"codeName": "UBUNTU"
},
"serverImageStatus": {
"code": "INIT",
"codeName": "NSI INIT state"
},
"serverImageOperation": {
"code": "CREAT",
"codeName": "NSI CREAT OP"
},
"serverImageStatusName": "creating",
"shareStatus": {
"code": "NULL",
"codeName": "NSI Share NULL State"
},
"blockStorageMappingList": [
{
"order": 0,
"blockStorageSize": 53687091200,
"blockStorageName": "test-server-image-01-storage-0",
"blockStorageVolumeType": {
"code": "SSD",
"codeName": "SSD"
},
"isEncryptedVolume": false
},
{
"order": 1,
"blockStorageSize": 53687091200,
"blockStorageName": "test-server-image-01-storage-1",
"blockStorageVolumeType": {
"code": "SSD",
"codeName": "SSD"
},
"isEncryptedVolume": false
}
],
"sharedLoginIdList": [],
"serverImageProductCode": "SW.VSVR.OS.LNX64.UBNTU.SVR2004.B050",
"createDate": "2026-05-22T17:10:12+0900",
"platformCategoryCode": "OS"
}
],
"requestId": "282b90ed-7fa1-4493-a572-dfc4fa390820",
"returnCode": "0",
"returnMessage": "success"
}
}