Available in VPC
Overview
Create a My server image.
Request
Request parameters
Parameter name | Required | Type | Restrictions | Description |
---|---|---|---|---|
regionCode | No | String | - | - Region code Determine the Region in which the server image list will be viewed regionCode can be obtained through the getRegionList action Default: Select the first Region of the getRegionList search result |
serverInstanceNo | Yes | String | - | - Source server instance number |
serverImageName | Yes | String | Min: 3, Max: 30 Only English letters, numbers, and special character "-" are allowed, and it must start with an English letter It must end with an English letter or number |
- Server image name |
serverImageDescription | No | String | Min: 0, Max: 1000 Bytes | - Description of the server image to be created |
blockStorageList.N.order | Yes | Integer | Min: 0, Max: 20 | - Block storage order Determine the order of storage to be assigned to the created server. There must be one default storage. Enter 0 to set it as the default storage. Up to 21 storage can be assigned. |
blockStorageList.N.snapshotInstanceNo | Yes | String | - | - Storage snapshot instance number Determine the snapshot instance that will be used to create the server image. snapshotInstanceNo can be obtained through the getBlockStorageSnapshotInstanceList action. |
blockStorageList.N.blockStorageSize | Conditional | Integer | - | - Storage size (GB) Determine the size (GB) of the storage to create. If a snapshot is specified, it must be equal to or larger than the snapshot size. For size restrictions by volume type, see the user guide. Compute > Server > VPC > Using Server > Server > Block Storage > Block Storage overview > Block Storage overview |
blockStorageList.N.blockStorageVolumeTypeCode | Conditional | String | - | - Storage type Determine the type of the storage to create. The default storage can't be changed. Options: CB1 | FB1 Must enter either the storage snapshot instance number (snapshotInstanceNo) or the storage type (blockStorageVolumeTypeCode). |
blockStorageList.N.noBlockStorage | Conditional | Boolean | - | - Whether to exclude storage Determine whether to exclude the storage. The default storage can't be changed. Options: true | false If false, the storage snapshot instance number (snapshotInstanceNo) must be entered. |
blockStorageList.N.emptyBlockStorage | Conditional | Boolean | - | - Whether to create new storage Create new storage without creating storage from a snapshot. The default storage can't be changed. Options: true | false If false, the storage snapshot instance number (snapshotInstanceNo) must be entered. |
responseFormatType | No | String | - | - Response result's format type Options: xml | json Default: xml |
Response
Response data type
- ServerImageList type
ServerImageList extends CommonResponse |
---|
private Integer totalRows; |
private List<ServerImage> serverImageList = new ArrayList<>(); |
ServerImage |
---|
private String serverImageNo; |
private String serverImageName; |
private String serverImageDescription; |
private CommonCode serverImageType; |
private CommonCode hypervisorType; |
private CommonCode cpuArchitectureType; |
private CommonCode osCategoryType; |
private CommonCode osType; |
private String serverImageStatusName; |
private CommonCode serverImageStatus; |
private CommonCode serverImageOperation; |
private String serverImageProductCode; |
private Date createDate; |
private CommonCode shareStatus; |
private SharedLoginIdList sharedLoginIdList; |
private String platformCategoryCode; |
private List<BlockStorageMapping> blockStorageMappingList; |
BlockStorageMapping |
---|
private Integer order; |
private String blockStorageSnapshotInstanceNo; |
private String blockStorageSnapshotName; |
private Long blockStorageSize; |
private String blockStorageName; |
private CommonCode blockStorageVolumeType; |
private Long iops; |
private Long throughput; |
private Boolean isEncryptedVolume; |
Examples
Request example
ncloud vserver createServerImage --regionCode KR --serverInstanceNo 1234 --serverImageName test-***
Response example
<getServerImageListResponse>
<requestId></requestId>
<returnCode>0</returnCode>
<returnMessage>success</returnMessage>
<totalRows>1</totalRows>
<serverImageList>
<serverImage>
<serverImageNo>***5847</serverImageNo>
<serverImageName>test-***</serverImageName>
<serverImageDescription></serverImageDescription>
<serverImageType>
<code>NCP</code>
<codeName>NCP Server Image</codeName>
</serverImageType>
<hypervisorType>
<code>XEN</code>
<codeName>XEN</codeName>
</hypervisorType>
<cpuArchitectureType>
<code>X86_64</code>
<codeName>x86 64bit</codeName>
</cpuArchitectureType>
<osCategoryType>
<code>LINUX</code>
<codeName>LINUX</codeName>
</osCategoryType>
<osType>
<code>CENTOS</code>
<codeName>CENTOS</codeName>
</osType>
<serverImageProductCode>SW.VSVR.OS.LNX64.CNTOS.0703.B050</serverImageProductCode>
<serverImageStatus>
<code>CREAT</code>
<codeName>Server created state</codeName>
</serverImageStatus>
<serverImageOperation>
<code>NULL</code>
<codeName>NULL OP</codeName>
</serverImageOperation>
<serverImageStatusName>created</serverImageStatusName>
<createDate>2020-08-24T10:34:27+0900</createDate>
<blockStorageMappingList>
<blockStorageMapping>
<order>0</order>
<blockStorageSize>53687091200</blockStorageSize>
<blockStorageVolumeType>
<code>HDD</code>
<codeName>HDD</codeName>
</blockStorageVolumeType>
<isEncryptedVolume>false</isEncryptedVolume>
</blockStorageMapping>
</blockStorageMappingList>
<shareStatus>
<code>NULL</code>
<codeName>NSI Share NULL State</codeName>
</shareStatus>
<sharedLoginIdList/>
<platformCategoryCode>OS</platformCategoryCode>
</serverImage>
</serverImageList>
</getServerImageListResponse>