Provision cloud hosts

Available in versions: 12.56-12.63 only using the URL below.


Provisions a host on the cloud.


Copy code


Only Amazon EC2 is supported for provisioning cloud hosts using the REST API.

HTTP Method

POST: Creates the cloud host.



Content-Type: application/xml


Versions 2023 and later


Versions 2022 - 2022 R2




Versions 2021 - 2021 R2



Versions 2020 - 2020 SP3


Versions earlier than 2020



Request Body:

POST: An XML describing the cloud host.

This table lists the fields in the provision request (all fields are mandatory unless indicated as optional):


The ID of the host template. Generated automatically at the time the host template is added.

HostsAmountThe number of hosts to provision in the batch. All hosts in the batch use the same account, location, and template, and have identical configurations.

The testing tools available on the host: LoadGenerator.

HostPriorityA numeric value assigned to the host. The higher the priority you give the host, the more likely the host will be allocated to a test.
SecurityGroupA security group that allows the necessary access to your testing hosts. Security group specifies which inbound and outbound connections are permitted from the hosts, such as port 80 (HTTP) or port 3389 (RDP). Security groups are configured on your cloud provider's website, and must be created separately for each location. Only security groups configured for your selected location are displayed.

A key pair for which you have the private key. Key pair is used to generate the administrator password for Windows machines and to log in to Linux machines. Key pair is only relevant if you plan to remotely connect to your cloud hosts. Key pairs are managed on your cloud provider's website, and must be created separately for each location. Only key pairs configured for your selected location are displayed.

Note: You must have at least one keypair to provision a host.


Can contain Attribute sub elements which are used to set Host properties values.

This field is optional.


Host attribute value should contain Host Properties values as defined in LAB_PROJECT under Project Customization > Project Lists > Host Properties.

You can specify multiple Attribute elements using either the default host attributes (as in the example below) or any custom attribute defined by the user.

Pools List the IDs the appropriate host pools to which the newly provisioned cloud hosts will be added.

Date to be notified if the hosts are still provisioned in the cloud provider. Hosts provisioned past this date will be listed in the cloud hosts daily digest report.

This field is optional. We recommend that you enter a value for better tracking of hosts that are past there due date.


Indicates whether to use a defined a pool of predefined IP addresses with your cloud provider. Enter "1" to use elastic IPs.

This field is optional.



Content-Type: application/xml or application/json



HTML Return Code:

One of the HTTP Return Codes

Upon successful deletion, returns HTTP status 200 (OK).

HTML Body:

The response body contains the request ID, and the Location header contains the URL for monitoring provisioning progress.

You can query the operations for this request ID to see the current provision status. For details, see Get all provision requests.

See Also

Deprovision cloud hosts
Get provision request
Get all provision requests
Get all cloud hosts
Audit cloud hosts
Get Cloud Account