ManageIQ

Advanced Provisioning Attributes

This appendix lists parameters that apply to REST API initiated provisioning via /api/provision_requests.

Defining new vLans adapters

These attributes allow adding new vLan adapters during the provisioning request.

Attribute Type Required Values Default
network## string Required Network Name  
network##.mac_address string Optional MAC Address  
network##.deviceType string Optional VirtualE1000, VirtualPCNet32, VirtualVmxnet VirtualPCNet32
network##.connectable.allowGuestControl boolean Optional   true
network##.connectable.startConnected boolean Optional   true
network##.connectable.connected boolean Optional   true

Example:

"network0" : "VM Network",
"network0.mac_address" : "00:50:56:57:58:59"

Defining new SCSI Controller

The SCSI Controller attributes are optional. If a controller is required, it will be added with the defined defaults. These settings are only required if you need to override a default value.

Attribute Type Required Values Default
ctrlscsi## string Required VirtualBusLogicController, VirtualLsiLogicController VirtualLsiLogicController
ctrlscsi##.sharedBus string Optional noSharing, physicalSharing, virtualSharing noSharing

Note:

The ## value defines the controller bus number

Example:

"ctrlscsi00" : "VirtualBusLogicController"
"ctrlscsi00.sharedBus" : "virtualSharing"

Defining new Disks

The Disk attributes allow adding disks as part of the provisioning request.

Attribute Type Required Values Default
diskscsi## string Required “controller_#:controller_position_#:size_in_mb”  
diskscsi##.datastore string Optional Datastore Name  
diskscsi##.filename string Optional Filename  
diskscsi##.connectable.allowGuestControl boolean Optional   false
diskscsi##.connectable.startConnected boolean Optional   true
diskscsi##.connectable.connected boolean Optional   true
diskscsi##.backing.diskmode string Optional persistent, independent_persistent, independent_nonpersistent, nonpersistent persistent
diskscsi##.backing.split boolean Optional   false
diskscsi##.backing.thinProvisioned boolean Optional   false
diskscsi##.backing.writeThrough boolean Optional   false

Example:

"diskscsi0" : "0:0:10"
"diskscsi1" : "0:0:8"
"diskscsi1.datastore" : "storage1"
"diskscsi1.backing.diskmode" : "independent_persistent"

Increasing the template disk size

The allocated_disk_storage attribute allows for the first disk on a VM to be increased in size after the clone operation is complete. This is only supported for templates with 1 disk. The attribute’s unit is gigabytes.

This is supported by the VMware vSphere provider.

allocated_disk_storage: 10

Cloning Type

This attribute sets the type of cloning request, either clone to vm or clone to template. It is an attribute to set with the template_fields hash.

Attribute Type Required Values Default
request_type string Optional clone_to_vm, clone_to_template clone_to_vm

Example:

"template_fields" : {
  "guid" : "afe6e8a0-89fd-11e3-b6ac-b8e85646e742",
  "request_type" : "clone_to_template"
}

Limit Template Selection

This attribute value limits the template selection to the Datacenters contained in the specified cluster. It is an attribute to be specified with the additional_values hash.

Attribute Type Required
cluster string Optional

Example:

"additional_values" : {
  "request_id" : "87458",
  "cluster" : "sales_prod"
}