Create clone image

Description

Creates a clone image from a virtual server.

Stop the target virtual server before creating a clone image.

An error will occur if an clone image with the same name already exists in the project.

CAUTION:

The virtual server where the clone image is created must reflect the specific information (computer name, IP address, etc.) specified during creation of the virtual server in the operating system. The specific information will be reflected in the operating system when the virtual server is started.

Therefore, for the virtual server where the clone image is created, specify one that has been started once.

If you create a clone image from a virtual server that has not been started at all, clone image creation will be successful, however, an error will occur when creating a virtual server using that clone image.

Request

Header

Content-Type: application/x-www-form-urlencoded

Accept: application/xml

X-Auth-Token: Keystone token (*1)

X-VA-Project-Id: Project ID of resource creation destination (*2)

X-VA-Domain-Id: Domain ID of resource creation destination (*2)

*1: The scope specified for the token is ignored when this API is executed by the system administrator.

*2: Mandatory when this API is executed by the system administrator. ignored when executed by other users.

Method

POST

Path

/server_images

Query

n/a

Body

Argument name Description
name Specifies the clone image name.

Specify a string of up to 32 characters using halfwidth alphanumeric characters and underscores (_). It must start with a halfwidth letter.

type Specify "cloning".
l_server_rid Specifies the resource ID of the virtual server where the clone image will be created.
comment Specifies comments for the clone image (optional).

String of up to 96 characters using halfwidth or fullwidth characters, except for percent (%), backslash (\), double quotation mark ("), and line feed characters.

Response

Status code

202 Accepted

Body

Task information

However, <resource id="resourceId"/> is not displayed.