Clone a Server

Description

Use this request to create a clone of an existing server. The {ve-name} part of the URL must contain the name of the source server. The {new-server-name} part must contain the new server name (user-defined). The IP addresses, gateway, and DNS settings for the new server will be set automatically. The rest of the server configuration will be inherited from the source server. The administrator password for the new server will be automatically generated and returned to the caller. If the server you are trying to create exceeds the subscription server limit, the operation will fail with HTTP error 406: "Subscription limit for VE number exceeded".

Syntax 1

Use this syntax to clone a server when the customer account has only one subscription.

POST baseURL/ve/{ve-name}/clone-to/{new-server-name}

Syntax 2

Use this syntax when the customer account has more than one subscription. The {subscription-id} part must contain the subscription ID.

POST baseURL/ve/{ve-name}/clone-to/{new-server-name}/for/{subscription-id}

Request Parameters

None

Response

Element

Attribute

Description

pwd-response

 

Container for response data.

message

 

A text message describing the status of the operation.

password

 

An automatically generated administrator password for the new server.

Example

Request

POST https://c2u-web:4465/paci/v1.0/ve/Web60/clone-to/My_new_server

Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<pwd-response>
    <message>Clone VE initiated</message>
    <password>621zwPqs</password>
</pwd-response>