Data Object - VAppIPAssignmentInfo

Property of
VmConfigInfo, VmConfigSpec
Extends
DynamicData
Since
vSphere API 4.0

Data Object Description

The IPAssignmentInfo class specifies how the guest software gets configured with IP addresses, including protocol type (IPv4 or IPv6) and the life-time of those IP addresses.

A vApp/virtual machine can either use DHCP to acquire an IP configuration, or it can acquire its IP configuration through the use of the vSphere platform using the OVF environment's properties. The latter is a known as OVF-environment-assigned IP configuration.

Guest software can be constructed to support DHCP , OVF assigned IP configuration, or both. The supportedAssignmentScheme property lists the supported schemes. This is typically specified by the author of a vApp.

The deployer / operator of a vApp, specifies what IP allocation policy should be used:

Transient and fixed assignment differs in the life time of the IP allocation. For transient, IP addresses are automatically assigned on power-on and released on power-off. For fixed, the IP addresses are explicitly specified by the deployer and does not change between a power-on/power-off. Fixed allocated is a hybrid of transient and fixed assignment. IP addresses are allocated at first power-on and remain allocated on power-off.

The IPAssignment settings are global to a deployment. Thus, if a vApp or virtual machine is part of another vApp, then the settings are ignored, and the ones for the top-most vApp container is used.

Properties

Name Type Description
ipAllocationPolicy*xsd:string

Specifies how IP allocation should be managed by the VI platform. This is typically specified by the deployer. The set of valid options for the policy is based on the capabilities of the vApp software, as specified by the supportedAllocationSchemes property.

Reconfigure privilege: VApp.InstanceConfig

ipProtocol*xsd:string

Specifies the chosen IP protocol for this deployment. This must be one of the values in the supportedIpProtocol field.

Reconfigure privilege: VApp.InstanceConfig

supportedAllocationScheme*xsd:string[]

Specifies the IP allocation schemes supported by the guest software.

When updating this field, an empty array will be interpreted as no changes. An array of the form [""] will clear all settings. Otherwise, the supplied value will overwrite the current setting.

Reconfigure privilege: VApp.ApplicationConfig

supportedIpProtocol*xsd:string[]

Specifies the IP protocols supported by the guest software.

When updating this field, an empty array will be interpreted as no changes. An array of the form [""] will clear all settings. Otherwise, the supplied value will overwrite the current setting.

Reconfigure privilege: VApp.ApplicationConfig

Properties inherited from DynamicData
dynamicProperty, dynamicType
*Need not be set
Show WSDL type definition