Clone VM With Custom Settings operation - Documentation for BMC Atrium Orchestrator Content 20.14.02

Element

Definition

Required

<operation-type>

Defines the type of the operation: Configure_Vm

Yes

<operation-name>

Defines the name of the operation: Clone_VM_With_Custom_Settings

Yes

<soap-url>

Specifies the URL for the remote SOAP service running on the VMware VirtualCenter

If the <soap-url> element is not specified, the request uses the VirtualCenter Server details specified in the adapter configuration.

Default format for HTTPS:

Default format for HTTP:

Note

If you want to use an HTTP value, you might need to change the configuration of the VMware Infrastructure application.

No

<transport>

Specifies the transport protocol for the message

If the <transport> element is not provided, the request uses the VirtualCenter Server details specified in the adapter configuration.

Valid values: https-rpc (default), http-rpc

Note

If the value of the <transport> element is https-rpc, you must install the security certificate for the VMware Virtual Center to the keystore of the peer on which the adapter is enabled.

No

<user-name>

Specifies the user name that is used for HTTP basic authentication on the VMware Virtual Center

If no user name is specified, the request is executed with the user name that is specified in the configuration.

No

<password>

Specifies the password corresponding to <user-name>

Conditional; required if <user-name> is specified

<parameters>

Contains the elements required to execute the operation

Yes

<virtual-machine>

Specifies the name of the virtual machine to be cloned

Yes

<folder>

Specifies the folder in which the clone virtual machine is to be created

If this element is not specified, the clone virtual machine is created in the default vm folder.

No

<datacenter>

Specifies the data center in which the clone virtual machine is to be created

Yes

<name>

Specifies a name for the clone virtual machine

Yes

<power-on>

Specifies whether to power on the clone virtual machine after creation

As part of a customization, this flag is generally set to true because the first power-on operation completes the customization process. This flag is ignored if a template is being created.

Valid values: true, false

Yes

<template>

Specifies whether the new virtual machine should be marked as a template

Valid values: true, false

Yes

<location>

Specifies the location of resources that the clone virtual machine uses

For more information about the child elements of <location>, see location.

Conditional; not required if the virtual machine is cloned from a template

<version>

Specifies the version string for the virtual machine

No

<guest-id>

Specifies the short identifier for the guest operating system

If the guest operating system is not specified, the virtual machine is cloned with the same operating system as the original virtual machine.

For more information about short identifiers for guest operation systems, see Guest operating system identifiers for VMware Infrastructure.

No

<annotation>

Contains a description of the clone virtual machine

No

<tools>

Specifies the configuration of VMware tools running on the guest operating system on the clone

For more information about the child elements of <tools>, see tools.

No

<flags>

Encapsulates the flag settings for the clone virtual machine

For more information about the child elements of <flags>, see flags.

No

<console-preferences>

Specifies the preferences for the legacy console application that affect the way the console behaves during power operations on the clone virtual machine

For more information about the child elements of <console-preferences>, see console-preferences.

No

<power-op-info>

Specifies the configuration for the clone's default power operations

For more information about the child elements of <power-op-info>, see power-op-info.

No

<num-cpus>

Specifies the number of virtual processors in the clone virtual machine

No

<memory-mb>

Specifies the memory size of the clone virtual machine, in MB

Valid values: Any number

No

<device-change-list>

Specifies the set of virtual devices being added to the clone by the configuration operation

For more information about the child elements of <device-change-list>, see device-change-list for adding and device-change-list for updating devices.

No

<cpu-allocation>

Specifies the resource limits for the CPU on the clone

For more information about the child elements of <cpu-allocation>, see cpu-allocation.

No

<memory-allocation>

Specifies the resource limits for memory on the clone

For more information about the child elements of <memory-allocation>, see memory-allocation.

No

<memory-affinity>

Specifies the list of non-uniform memory access (NUMA) nodes that can be used by the clone virtual machine

If the array is empty when you modify the affinity setting, any existing affinity is removed.

No

<network-shaper>

Specifies the network traffic shaping specification used to configure the network utilization characteristics of the clone virtual machine

For information about child elements of <network-shaper>, see network-shaper.

No

<cpu-feature-mask-list>

Specifies the CPU feature compatibility masks

For more information about the child elements of <cpu-feature-mask-list>, see cpu-feature-mask-list.

No

<customization>

Specifies the details for customizing the guest operating system of the clone virtual machine

For more information about the child elements of <customization>, see customization.

Yes

<gui-run-once>

Specifies the list of commands to run when the user logs on for the first time after guest customization

No