vcenter Package¶

`vcenter` Package¶

`inventory_client` Module¶

The com.vmware.vcenter.inventory_client component provides methods and classes for retrieving vCenter datastore and network information for a given list of identifiers.

class com.vmware.vcenter.inventory_client.Datastore(config)[source]¶

Bases: vmware.vapi.bindings.stub.VapiInterface

The Datastore class provides methods to retrieve information about datastores.

Parameters:	config (`vmware.vapi.bindings.stub.StubConfiguration`) – Configuration to be used for creating the stub.

class Info(type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Datastore.Info class contains information about a datastore.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:	type (`str`) – Type of the datastore. When clients pass a value of this class as a parameter, the attribute must be one of `Datastore` or `StoragePod`. When methods return a value of this class as a return value, the attribute will be one of `Datastore` or `StoragePod`.

Datastore.find(datastores)[source]¶

Returns datastore information for the specified datastores. The key in the return value dict is the datastore identifier and the value in the dict is the datastore information.

Parameters:	datastores (`list` of `str`) – Identifiers of the datastores for which information will be returned. The parameter must contain identifiers for the resource type: `Datastore`.
Return type:	`dict` of `str` and (`Datastore.Info` or `None`)
Returns:	Datastore information for the specified datastores. The key in the return value `dict` is the datastore identifier and the value in the `dict` is the datastore information. The key in the return value `dict` will be an identifier for the resource type: `Datastore`.
Raise :	`com.vmware.vapi.std.errors_client.NotFound` if no datastore can be found for one or more of the datastore identifiers in `datastores`
Raise :	`com.vmware.vapi.std.errors_client.Unauthorized` if you do not have all of the privileges described as follows: Method execution requires `System.Read`. The resource `Datastore` referenced by the parameter `datastores` requires `System.Read`.

class com.vmware.vcenter.inventory_client.Network(config)[source]¶

Bases: vmware.vapi.bindings.stub.VapiInterface

The Network class provides methods to retrieve information about vCenter Server networks.

Parameters:	config (`vmware.vapi.bindings.stub.StubConfiguration`) – Configuration to be used for creating the stub.

class Info(type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Network.Info class contains information about a vCenter Server network.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:	type (`str`) – Type of the vCenter Server network. When clients pass a value of this class as a parameter, the attribute must be one of `Network`, `DistributedVirtualPortgroup`, or `OpaqueNetwork`. When methods return a value of this class as a return value, the attribute will be one of `Network`, `DistributedVirtualPortgroup`, or `OpaqueNetwork`.

Network.find(networks)[source]¶

Returns network information for the specified vCenter Server networks. The key in the return value dict is the network identifier and the value in the dict is the network information.

Parameters:	networks (`list` of `str`) – Identifiers of the vCenter Server networks for which information will be returned. The parameter must contain identifiers for the resource type: `Network`.
Return type:	`dict` of `str` and (`Network.Info` or `None`)
Returns:	Network information for the specified vCenter Server networks. The key in the return value `dict` is the network identifier and the value in the `dict` is the network information. The key in the return value `dict` will be an identifier for the resource type: `Network`.
Raise :	`com.vmware.vapi.std.errors_client.NotFound` if no datastore can be found for one or more of the vCenter Server network identifiers in `networks`
Raise :	`com.vmware.vapi.std.errors_client.Unauthorized` if you do not have all of the privileges described as follows: Method execution requires `System.Read`. The resource `Network` referenced by the parameter `networks` requires `System.Read`.

`ovf_client` Module¶

The com.vmware.vcenter.ovf_client module provides services to capture and deploy Open Virtualization Format (OVF) packages to and from the content library.

It provides the ability to deploy OVF packages from the content library with support for advanced network topologies, network services, creating virtual appliances and virtual machines in hosts, resource pools or clusters. It also provides the ability to export virtual appliances and virtual machines from hosts, resource pools or clusters as OVF packages to the content library.

class com.vmware.vcenter.ovf_client.CertificateParams(issuer=None, subject=None, is_valid=None, is_self_signed=None, x509=None, type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The CertificateParams class contains information about the public key certificate used to sign the OVF package. This class will only be returned if the OVF package is signed.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

issuer (str) – Certificate issuer. For example: /C=US/ST=California/L=Palo Alto/O=VMware, Inc. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
subject (str) – Certificate subject. For example: /C=US/ST=Massachusetts/L=Hopkinton/O=EMC Corporation/OU=EMC Avamar/CN=EMC Corporation. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
is_valid (bool) – Is the certificate chain validated. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
is_self_signed (bool) – Is the certificate self-signed. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
x509 (str) – The X509 representation of the certificate. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
type (str) – Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters class. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class com.vmware.vcenter.ovf_client.DeploymentOption(key=None, label=None, description=None, default_choice=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The DeploymentOption class contains the information about a deployment option as defined in the OVF specification.

This corresponds to the ovf:Configuration element of the ovf:DeploymentOptionSection in the specification. The ovf:DeploymentOptionSection specifies a discrete set of intended resource allocation configurations. This class represents one item from that set.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

key (str) – The key of the deployment option, corresponding to the ovf:id attribute in the OVF descriptor. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
label (str) – A localizable label for the deployment option. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
description (str) – A localizable description for the deployment option. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
default_choice (bool) – A bool flag indicates whether this deployment option is the default choice. This attribute is not used in the input parameters when deploying an OVF package. This attribute is optional in the result when retrieving information about an OVF package. If None or false, it is not the default.

class com.vmware.vcenter.ovf_client.DeploymentOptionParams(deployment_options=None, selected_key=None, type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The DeploymentOptionParams class describes the possible deployment options as well as the choice provided by the user.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

deployment_options (list of DeploymentOption) – list of deployment options. This attribute corresponds to the ovf:Configuration elements of the ovf:DeploymentOptionSection in the specification. It is a discrete set of intended resource allocation configurations from which one can be selected. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
selected_key (str) – The selected deployment option. Identifies the DeploymentOption in the list in the deploymentOptions attribute with a matching value in the DeploymentOption.key attribute. This attribute is optional in the input parameters when deploying an OVF package. If None the server will use the default deployment configuration, usually it’s the first one in DeploymentOptionParams.deployment_options list. This attribute is optional in the result when retrieving information about an OVF package. The value will be set only if it is specified with the optional ovf:default attribute.
type (str) – Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters class. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class com.vmware.vcenter.ovf_client.DiskProvisioningType(string)[source]¶

Bases: vmware.vapi.bindings.enum.Enum

The DiskProvisioningType class defines the virtual disk provisioning types that can be set for a disk on the target platform.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:	string (`str`) – String value for the `DiskProvisioningType` instance.

eagerZeroedThick = DiskProvisioningType(string='eagerZeroedThick')¶

An eager zeroed thick provisioned virtual disk has all space allocated and wiped clean of any previous contents on the physical media at creation time.

Disks specified as eager zeroed thick may take longer time to create than disks specified with the other disk provisioning types.

thick = DiskProvisioningType(string='thick')¶: A thick provisioned virtual disk has all space allocated at creation time and the space is zeroed on demand as the space is used.

thin = DiskProvisioningType(string='thin')¶: A thin provisioned virtual disk has space allocated and zeroed on demand as the space is used.

class com.vmware.vcenter.ovf_client.ExportFlag(config)[source]¶

Bases: vmware.vapi.bindings.stub.VapiInterface

The ExportFlag class provides methods for retrieving information about the export flags supported by the server. Export flags can be specified in a LibraryItem.CreateSpec to customize an OVF export.

Parameters:	config (`vmware.vapi.bindings.stub.StubConfiguration`) – Configuration to be used for creating the stub.

class Info(option=None, description=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ExportFlag.Info class describes an export flag supported by the server.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:	option (`str`) – The name of the export flag that is supported by the server. description (`com.vmware.vapi.std_client.LocalizableMessage`) – Localizable description of the export flag.

ExportFlag.list()[source]¶

Returns information about the supported export flags by the server.

PRESERVE_MAC: Include MAC addresses for network adapters.
EXTRA_CONFIG: Include extra configuration in OVF export.

Future server versions might support additional flags.

Return type:

list of ExportFlag.Info

Returns:

A list of supported export flags.

Raise :

com.vmware.vapi.std.errors_client.Unauthorized if you do not have all of the privileges described as follows:

Method execution requires System.Read.

class com.vmware.vcenter.ovf_client.ExtraConfig(key=None, value=None, virtual_system_id=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ExtraConfig class contains the information about a vmw:ExtraConfig element which can be used to specify configuration settings that are transferred directly to the .vmx file. The behavior of the vmw:ExtraConfig element is similar to the extraConfig property of the VirtualMachineConfigSpec object in the VMware vSphere API. Thus, the same restrictions apply, such as you cannot set values that could otherwise be set with other properties in the VirtualMachineConfigSpec object. See the VMware vSphere API reference for details on this.

vmw:ExtraConfig elements may occur as direct child elements of a VirtualHardwareSection, or as child elements of individual virtual hardware items.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

key (str) – The key of the ExtraConfig element. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
value (str) – The value of the ExtraConfig element. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
virtual_system_id (str) – The identifier of the virtual system containing the vmw:ExtraConfig element. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class com.vmware.vcenter.ovf_client.ExtraConfigParams(extra_configs=None, exclude_keys=None, include_keys=None, type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ExtraConfigParams class contains the parameters with information about the vmw:ExtraConfig elements in an OVF package.

vmw:ExtraConfig elements can be used to specify configuration settings that are transferred directly to the .vmx file.

The behavior of the vmw:ExtraConfig element is similar to the extraConfig property of the VirtualMachineConfigSpec object in the VMware vSphere API. Thus, the same restrictions apply, such as you cannot set values that could otherwise be set with other properties in the VirtualMachineConfigSpec object. See the VMware vSphere API reference for details on this.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

extra_configs (list of ExtraConfig) – list of vmw:ExtraConfig elements in the OVF package. This attribute is optional in the input parameters when deploying an OVF package. If None there are no extra configuration elements to use for this OVF package deployment. This attribute will always be present in the result when retrieving information about an OVF package. It will be an empty list if there are no extra configuration elements in the OVF package.
exclude_keys (list of str) –
Specifies which extra configuration items in the list in the extraConfigs field should be ignored during deployment.

If set, the given keys for extra configurations will be ignored during deployment. The key is defined in the ExtraConfig.key attribute. This attribute is optional in the input parameters when deploying an OVF package. It is an error to set both this and ExtraConfigParams.include_keys. This attribute is optional in the result when retrieving information about an OVF package. It is an error to set both this and ExtraConfigParams.include_keys.
include_keys (list of str) –
Specifies which extra configuration items in the list in the extraConfigs field should be included during deployment.

If set, all but the given keys for extra configurations will be ignored during deployment. The key is defined in the ExtraConfig.key attribute. This attribute is optional in the input parameters when deploying an OVF package. It is an error to set both this and ExtraConfigParams.exclude_keys. This attribute is optional in the result when retrieving information about an OVF package. It is an error to set both this and ExtraConfigParams.exclude_keys.
type (str) – Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters class. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class com.vmware.vcenter.ovf_client.ImportFlag(config)[source]¶

Bases: vmware.vapi.bindings.stub.VapiInterface

The ImportFlag class provides methods for retrieving information about the import flags supported by the deployment platform. Import flags can be specified in a LibraryItem.ResourcePoolDeploymentSpec to customize an OVF deployment.

Parameters:	config (`vmware.vapi.bindings.stub.StubConfiguration`) – Configuration to be used for creating the stub.

class Info(option=None, description=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ImportFlag.Info class describes an import flag supported by the deployment platform.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:	option (`str`) – The name of the import flag that is supported by the deployment platform. description (`com.vmware.vapi.std_client.LocalizableMessage`) – Localizable description of the import flag.

ImportFlag.list(rp)[source]¶

Returns information about the import flags supported by the deployment platform.

LAX: Lax mode parsing of the OVF descriptor.

Future server versions might support additional flags.

Parameters:	rp (`str`) – The identifier of resource pool target for retrieving the import flag(s). The parameter must be an identifier for the resource type: `ResourcePool`.
Return type:	`list` of `ImportFlag.Info`
Returns:	A `list` of supported import flags.
Raise :	`com.vmware.vapi.std.errors_client.NotFound` If the resource pool associated with `rp` does not exist.
Raise :	`com.vmware.vapi.std.errors_client.Unauthorized` if you do not have all of the privileges described as follows: Method execution requires `System.Read`. The resource `ResourcePool` referenced by the parameter `rp` requires `System.Read`.

class com.vmware.vcenter.ovf_client.IpAllocationParams(supported_allocation_scheme=None, supported_ip_allocation_policy=None, ip_allocation_policy=None, supported_ip_protocol=None, ip_protocol=None, type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The IpAllocationParams class specifies how IP addresses are allocated to OVF properties. In particular, it informs the deployment platform whether the guest supports IPv4, IPv6, or both. It also specifies whether the IP addresses can be obtained through DHCP or through the properties provided in the OVF environment.

Ovf Property elements are exposed to the guest software through the OVF environment. Each Property element exposed in the OVF environment shall be constructed from the value of the ovf:key attribute. A Property element contains a key/value pair, it may optionally specify type qualifiers using the ovf:qualifiers attribute with multiple qualifiers separated by commas.

The settings in IpAllocationParams class are global to a deployment. Thus, if a virtual machine is part of a virtual appliance, then its settings are ignored and the settings for the virtual appliance is used.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

supported_allocation_scheme (list of IpAllocationParams.IpAllocationScheme) – Specifies the IP allocation schemes supported by the guest software. This attribute defines the valid values for the IP allocation policy. This setting is often configured by the virtual appliance template author or OVF package author to reflect what the guest software supports, and the IP allocation policy is configured at deployment time. See IpAllocationParams.ip_allocation_policy. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
supported_ip_allocation_policy (list of IpAllocationParams.IpAllocationPolicy) – Specifies the IP allocation policies supported. The set of valid options for the policy is based on the capabilities of the virtual appliance software, as specified by the IpAllocationParams.supported_allocation_scheme attribute. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
ip_allocation_policy (IpAllocationParams.IpAllocationPolicy) – Specifies how IP allocation is done through an IP Pool. This is typically specified by the deployer. This attribute is optional in the input parameters when deploying an OVF package. If None there is no IP allocation policy. This attribute will always be present in the result when retrieving information about an OVF package.
supported_ip_protocol (list of IpAllocationParams.IpProtocol) – Specifies the IP protocols supported by the guest. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
ip_protocol (IpAllocationParams.IpProtocol) – Specifies the chosen IP protocol for this deployment. This must be one of the IP protocols supported by the guest software. See IpAllocationParams.supported_ip_protocol. This attribute is optional in the input parameters when deploying an OVF package. If None there is no IP protocol chosen. This attribute will always be present in the result when retrieving information about an OVF package.
type (str) – Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters class. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class IpAllocationPolicy(string)[source]¶

Bases: vmware.vapi.bindings.enum.Enum

The IpAllocationParams.IpAllocationPolicy class defines the possible IP allocation policy for a deployment.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:	string (`str`) – String value for the `IpAllocationPolicy` instance.

DHCP = IpAllocationPolicy(string='DHCP')¶: Specifies that DHCP will be used to allocate IP addresses.

STATIC_IPPOOL = IpAllocationPolicy(string='STATIC_IPPOOL')¶: Specifies that IP addresses are allocated from the range managed by an IP pool. The IP addresses are allocated at first power-on, and remain allocated at power-off. This ensures that a virtual appliance gets a consistent IP for its life-time.

STATIC_MANUAL = IpAllocationPolicy(string='STATIC_MANUAL')¶: Specifies that IP addresses are configured manually upon deployment, and will be kept until reconfigured or the virtual appliance destroyed. This ensures that a property gets a consistent IP for its lifetime.

TRANSIENT_IPPOOL = IpAllocationPolicy(string='TRANSIENT_IPPOOL')¶: Specifies that IP addresses are allocated from an IP pool. The IP addresses are allocated when needed, typically at power-on, and deallocated during power-off. There is no guarantee that a property will receive same IP address when restarted.

class IpAllocationParams.IpAllocationScheme(string)[source]¶

Bases: vmware.vapi.bindings.enum.Enum

The IpAllocationParams.IpAllocationScheme class defines the possible IP allocation schemes that can be supported by the guest software.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:	string (`str`) – String value for the `IpAllocationScheme` instance.

DHCP = IpAllocationScheme(string='DHCP')¶: It supports DHCP to acquire IP configuration.

OVF_ENVIRONMENT = IpAllocationScheme(string='OVF_ENVIRONMENT')¶: It supports setting the IP configuration through the properties provided in the OVF environment.

class IpAllocationParams.IpProtocol(string)[source]¶

Bases: vmware.vapi.bindings.enum.Enum

The IpAllocationParams.IpProtocol class defines the IP protocols supported by the guest software.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:	string (`str`) – String value for the `IpProtocol` instance.

IPV4 = IpProtocol(string='IPV4')¶: It supports the IPv4 protocol.

IPV6 = IpProtocol(string='IPV6')¶: It supports the IPv6 protocol.

class com.vmware.vcenter.ovf_client.LibraryItem(config)[source]¶

Bases: vmware.vapi.bindings.stub.VapiInterface

The LibraryItem class provides methods to deploy virtual machines and virtual appliances from library items containing Open Virtualization Format (OVF) packages in content library, as well as methods to create library items in content library from virtual machines and virtual appliances.

Create a LibraryItem.DeploymentTarget to specify the target deployment type and target deployment designation.
Create a LibraryItem.ResourcePoolDeploymentSpec to specify the parameters for the target deployment.
Use the deploy method with the created target and parameter specifications, along with the identifier of the specified source content library item. See LibraryItem.deploy().

To create a library item in content library from a virtual machine or virtual appliance:

Create a LibraryItem.DeployableIdentity to specify the source virtual machine or virtual appliance to be used as the OVF template source.
Create a LibraryItem.CreateTarget to specify the target library and library item.
Create a LibraryItem.CreateSpec to specify the settings for the OVF package to be created.
Use the create method with the created target and parameter specifications, along with the specified source entity. See LibraryItem.create().

Parameters:	config (`vmware.vapi.bindings.stub.StubConfiguration`) – Configuration to be used for creating the stub.

class CreateResult(succeeded=None, ovf_library_item_id=None, error=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryItem.CreateResult class defines the result of the create method. See LibraryItem.create().

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

succeeded (bool) – Whether the create method completed successfully.
ovf_library_item_id (str or None) – Identifier of the created or updated library item. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.content.library.Item. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.content.library.Item. If None, the create method failed and LibraryItem.CreateResult.error will describe the error(s) that caused the failure.
error (LibraryItem.ResultInfo or None) – Errors, warnings, and informational messages produced by the create method. If None, no errors, warnings, or informational messages were reported by the create method.

class LibraryItem.CreateSpec(name=None, description=None, flags=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryItem.CreateSpec class defines the information used to create or update a library item containing an OVF package.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

name (str or None) – Name to use in the OVF descriptor stored in the library item. If None, the server will use source’s current name.
description (str or None) – Description to use in the OVF descriptor stored in the library item. If None, the server will use source’s current annotation.
flags (list of str or None) – Flags to use for OVF package creation. The supported flags can be obtained using ExportFlag.list(). If None, no flags will be used.

class LibraryItem.CreateTarget(library_id=None, library_item_id=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryItem.CreateTarget class specifies the target library item when capturing a virtual machine or virtual appliance as an OVF package in a library item in a content library. The target can be an existing library item, which will be updated, creating a new version, or it can be a newly created library item in a specified library. See LibraryItem.create().

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

library_id (str or None) – Identifier of the library in which a new library item should be created. This attribute is not used if the libraryItemId attribute is specified. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.content.Library. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.content.Library. If None, the libraryItemId attribute must be specified.
library_item_id (str or None) – Identifier of the library item that should be should be updated. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: com.vmware.content.library.Item. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: com.vmware.content.library.Item. If None, a new library item will be created. The libraryId attribute must be specified if this attribute is None.

LibraryItem.DEPLOYABLE = ['VirtualMachine', 'VirtualApp']¶: The types of resources that can be created by deploying an OVF package and can be captured to create a library item using the LibraryItem class.

class LibraryItem.DeployableIdentity(type=None, id=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryItem.DeployableIdentity class describes the resource created by a deployment, or the source resource from which library item can be created, by specifying its resource type and resource identifier.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

type (str) – Type of the deployable resource. When clients pass a value of this class as a parameter, the attribute must be one of VirtualMachine or VirtualApp. When methods return a value of this class as a return value, the attribute will be one of VirtualMachine or VirtualApp.
id (str) – Identifier of the deployable resource. When clients pass a value of this class as a parameter, the attribute type must contain the actual resource type. When methods return a value of this class as a return value, the attribute type will contain the actual resource type.

class LibraryItem.DeploymentResult(succeeded=None, resource_id=None, error=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryItem.DeploymentResult class defines the result of the deploy method. See LibraryItem.deploy().

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

succeeded (bool) – Whether the deploy method completed successfully.
resource_id (LibraryItem.DeployableIdentity or None) – Identifier of the deployed resource entity. If None, the deploy method failed and LibraryItem.DeploymentResult.error will describe the error(s) that caused the failure.
error (LibraryItem.ResultInfo or None) – Errors, warnings, and informational messages produced by the deploy method. If None, no errors, warnings, or informational messages were reported by the deploy method.

class LibraryItem.DeploymentTarget(resource_pool_id=None, host_id=None, folder_id=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryItem.DeploymentTarget class describes the location (target) where a virtual machine or virtual appliance should be deployed. It is used in the deploy and filter methods. See LibraryItem.deploy() and LibraryItem.filter().

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

resource_pool_id (str) – Identifier of the resource pool to which the virtual machine or virtual appliance should be attached. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: ResourcePool. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: ResourcePool.
host_id (str or None) – Identifier of the target host on which the virtual machine or virtual appliance will run. The target host must be a member of the cluster that contains the resource pool identified by LibraryItem.DeploymentTarget.resource_pool_id. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: HostSystem. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: HostSystem. If None, the server will automatically select a target host from the resource pool if LibraryItem.DeploymentTarget.resource_pool_id is a stand-alone host or a cluster with Distributed Resource Scheduling (DRS) enabled.
folder_id (str or None) – Identifier of the vCenter folder that should contain the virtual machine or virtual appliance. The folder must be virtual machine folder. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Folder. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Folder. If None, the server will choose the deployment folder.

class LibraryItem.OvfSummary(name=None, annotation=None, eulas=None, networks=None, storage_groups=None, additional_params=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryItem.OvfSummary class defines the result of the filter method. See LibraryItem.filter(). The attributes in the class describe parameterizable information in the OVF descriptor, with respect to a deployment target, for the deploy method. See LibraryItem.deploy().

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

name (str or None) – Default name for the virtual machine or virtual appliance. If None, the OVF descriptor did not specify a name.
annotation (str or None) – Default annotation for the virtual machine or virtual appliance. If None, the OVF descriptor did not specify an annotation.
eulas (list of str) – list of End User License Agreements specified in the OVF descriptor. All end user license agreements must be accepted in order for the deploy method to succeed. See LibraryItem.ResourcePoolDeploymentSpec.accept_all_eula.
networks (list of str or None) – list of section identifiers for sections of type ovf:NetworkSection in the OVF descriptor. These identifiers can be used as keys in LibraryItem.ResourcePoolDeploymentSpec.network_mappings. If None, the OVF descriptor did not specify any networks.
storage_groups (list of str or None) – list of section identifiers for sections of type vmw:StorageGroupSection in the OVF descriptor. These identifiers can be used as keys in LibraryItem.ResourcePoolDeploymentSpec.storage_mappings. If None, the OVF descriptor did not specify any storage groups.
additional_params (list of vmware.vapi.struct.VapiStruct or None) – List of additional OVF parameters which can be specified for the deployment target. These OVF parameters can be inspected, optionally modified, and used as values in LibraryItem.ResourcePoolDeploymentSpec.additional_parameters for the deploy method. When clients pass a value of this class as a parameter, the attribute must contain all the attributes defined in OvfParams. When methods return a value of this class as a return value, the attribute will contain all the attributes defined in OvfParams. If None, the OVF descriptor does not require addtional parameters or does not have additional parameters suitable for the deployment target.

class LibraryItem.ResourcePoolDeploymentSpec(name=None, annotation=None, accept_all_eula=None, network_mappings=None, storage_mappings=None, storage_provisioning=None, storage_profile_id=None, locale=None, flags=None, additional_parameters=None, default_datastore_id=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryItem.ResourcePoolDeploymentSpec class defines the deployment parameters that can be specified for the deploy method where the deployment target is a resource pool. See LibraryItem.deploy().

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

name (str or None) – Name assigned to the deployed target virtual machine or virtual appliance. If None, the server will use the name from the OVF package.
annotation (str or None) – Annotation assigned to the deployed target virtual machine or virtual appliance. If None, the server will use the annotation from the OVF package.
accept_all_eula (bool) – Whether to accept all End User License Agreements. See LibraryItem.OvfSummary.eulas.
network_mappings ((dict of str and str) or None) – Specification of the target network to use for sections of type ovf:NetworkSection in the OVF descriptor. The key in the dict is the section identifier of the ovf:NetworkSection section in the OVF descriptor and the value is the target network to be used for deployment. When clients pass a value of this class as a parameter, the value in the attribute dict must be an identifier for the resource type: Network. When methods return a value of this class as a return value, the value in the attribute dict will be an identifier for the resource type: Network. If None, the server will choose a network mapping.
storage_mappings ((dict of str and LibraryItem.StorageGroupMapping) or None) – Specification of the target storage to use for sections of type vmw:StorageGroupSection in the OVF descriptor. The key in the dict is the section identifier of the ovf:StorageGroupSection section in the OVF descriptor and the value is the target storage specification to be used for deployment. See LibraryItem.StorageGroupMapping. If None, the server will choose a storage mapping.
storage_provisioning (DiskProvisioningType or None) – Default storage provisioning type to use for all sections of type vmw:StorageSection in the OVF descriptor. If None, the server will choose the provisioning type.
storage_profile_id (str or None) – Default storage profile to use for all sections of type vmw:StorageSection in the OVF descriptor. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: StorageProfile. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: StorageProfile. If None, the server will choose the default profile.
locale (str or None) – The locale to use for parsing the OVF descriptor. If None, the server locale will be used.
flags (list of str or None) – Flags to be use for deployment. The supported flag values can be obtained using ImportFlag.list(). If None, no flags will be used.
additional_parameters (list of vmware.vapi.struct.VapiStruct or None) –
Additional OVF parameters that may be needed for the deployment. Additional OVF parameters may be required by the OVF descriptor of the OVF package in the library item. Examples of OVF parameters that can be specified through this attribute include, but are not limited to:
When clients pass a value of this class as a parameter, the attribute must contain all the attributes defined in OvfParams. When methods return a value of this class as a return value, the attribute will contain all the attributes defined in OvfParams. If None, the server will choose default settings for all parameters necessary for the deploy method. See LibraryItem.deploy().
default_datastore_id (str or None) – Default datastore to use for all sections of type vmw:StorageSection in the OVF descriptor. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore. If None, the server will choose the default datastore.

class LibraryItem.ResultInfo(errors=None, warnings=None, information=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryItem.ResultInfo class defines the information returned along with the result of a create or deploy method to describe errors, warnings, and informational messages produced by the server.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

errors (list of OvfError) – List of errors. Errors would have prevented the create or deploy method from completing successfully.
warnings (list of OvfWarning) – List of warnings. Warnings would not have prevented the create or deploy method from completing successfully. But there might be issues that warrant attention.
information (list of OvfInfo) – List of information messages. For example, a non-required parameter was ignored.

class LibraryItem.StorageGroupMapping(type=None, datastore_id=None, storage_profile_id=None, provisioning=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The LibraryItem.StorageGroupMapping class defines the storage deployment target and storage provisioning type for a section of type vmw:StorageGroupSection in the OVF descriptor.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

type (LibraryItem.StorageGroupMapping.Type) – Type of storage deployment target to use for the vmw:StorageGroupSection section. The specified value must be LibraryItem.StorageGroupMapping.Type.DATASTORE or LibraryItem.StorageGroupMapping.Type.STORAGE_PROFILE.
datastore_id (str) – Target datastore to be used for the storage group. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: Datastore. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: Datastore. This attribute is optional and it is only relevant when the value of type is LibraryItem.StorageGroupMapping.Type.DATASTORE.
storage_profile_id (str) – Target storage profile to be used for the storage group. When clients pass a value of this class as a parameter, the attribute must be an identifier for the resource type: StorageProfile. When methods return a value of this class as a return value, the attribute will be an identifier for the resource type: StorageProfile. This attribute is optional and it is only relevant when the value of type is LibraryItem.StorageGroupMapping.Type.STORAGE_PROFILE.
provisioning (DiskProvisioningType or None) – Target provisioning type to use for the storage group. If None, LibraryItem.ResourcePoolDeploymentSpec.storage_provisioning will be used.

class Type(string)[source]¶

Bases: vmware.vapi.bindings.enum.Enum

The LibraryItem.StorageGroupMapping.Type class defines the supported types of storage targets for sections of type vmw:StroageGroupSection in the OVF descriptor.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:	string (`str`) – String value for the `Type` instance.

DATASTORE = Type(string='DATASTORE')¶: Storage deployment target is a datastore.

STORAGE_PROFILE = Type(string='STORAGE_PROFILE')¶: Storage deployment target is a storage profile.

LibraryItem.create(source, target, create_spec, client_token=None)[source]¶

Creates a library item in content library from a virtual machine or virtual appliance.

This method creates a library item in content library whose content is an OVF package derived from a source virtual machine or virtual appliance, using the supplied create specification. The OVF package may be stored as in a newly created library item or in an in an existing library item. For an existing library item whose content is updated by this method, the original content is overwritten.

Parameters:	client_token (`str` or `None`) – Client-generated token used to retry a request if the client fails to get a response from the server. If the original request succeeded, the result of that request will be returned, otherwise the operation will be retried. If None, the server will create a token. source (`LibraryItem.DeployableIdentity`) – Identifier of the virtual machine or virtual appliance to use as the source. target (`LibraryItem.CreateTarget`) – Specification of the target content library and library item. create_spec (`LibraryItem.CreateSpec`) – Information used to create the OVF package from the source virtual machine or virtual appliance.
Return type:	`LibraryItem.CreateResult`
Returns:	Information about the success or failure of the method, along with the details of the result or failure.
Raise :	`com.vmware.vapi.std.errors_client.InvalidArgument` if `create_spec` contains invalid arguments.
Raise :	`com.vmware.vapi.std.errors_client.InvalidArgument` if `source` describes an unexpected resource type.
Raise :	`com.vmware.vapi.std.errors_client.NotFound` if the virtual machine or virtual appliance specified by `source` does not exist.
Raise :	`com.vmware.vapi.std.errors_client.NotFound` if the library or library item specified by `target` does not exist.
Raise :	`com.vmware.vapi.std.errors_client.NotAllowedInCurrentState` if the operation cannot be performed because of the specified virtual machine or virtual appliance’s current state. For example, if the virtual machine configuration information is not available, or if the virtual appliance is running.
Raise :	`com.vmware.vapi.std.errors_client.ResourceInaccessible` if there was an error accessing a file from the source virtual machine or virtual appliance.
Raise :	`com.vmware.vapi.std.errors_client.ResourceBusy` if the specified virtual machine or virtual appliance is busy.
Raise :	`com.vmware.vapi.std.errors_client.Unauthorized` if you do not have all of the privileges described as follows: Method execution requires `System.Read`. The attribute `LibraryItem.DeployableIdentity.id` requires `VApp.Export`. The resource `com.vmware.content.Library` referenced by the attribute `LibraryItem.CreateTarget.library_id` requires `ContentLibrary.AddLibraryItem`. The resource `com.vmware.content.library.Item` referenced by the attribute `LibraryItem.CreateTarget.library_item_id` requires `System.Read`.

LibraryItem.deploy(ovf_library_item_id, target, deployment_spec, client_token=None)[source]¶

Deploys an OVF package stored in content library to a newly created virtual machine or virtual appliance.

This method deploys an OVF package which is stored in the library item specified by ovf_library_item_id. It uses the deployment specification in deployment_spec to deploy the OVF package to the location specified by target.

Parameters:	client_token (`str` or `None`) – Client-generated token used to retry a request if the client fails to get a response from the server. If the original request succeeded, the result of that request will be returned, otherwise the operation will be retried. If None, the server will create a token. ovf_library_item_id (`str`) – Identifier of the content library item containing the OVF package to be deployed. The parameter must be an identifier for the resource type: `com.vmware.content.library.Item`. target (`LibraryItem.DeploymentTarget`) – Specification of the deployment target. deployment_spec (`LibraryItem.ResourcePoolDeploymentSpec`) – Specification of how the OVF package should be deployed to the target.
Return type:	`LibraryItem.DeploymentResult`
Returns:	Information about the success or failure of the method, along with the details of the result or failure.
Raise :	`com.vmware.vapi.std.errors_client.InvalidArgument` if `target` contains invalid arguments.
Raise :	`com.vmware.vapi.std.errors_client.InvalidArgument` if `deployment_spec` contains invalid arguments or has attributes that are inconsistent with `target`.
Raise :	`com.vmware.vapi.std.errors_client.NotFound` if the library item specified by `ovf_library_item_id` does not exist.
Raise :	`com.vmware.vapi.std.errors_client.NotFound` if any resource specified by a attribute of the `LibraryItem.DeploymentTarget` class, specified by `target`, does not exist.
Raise :	`com.vmware.vapi.std.errors_client.ResourceInaccessible` if there was an error accessing the OVF package stored in the library item specified by `ovf_library_item_id`.
Raise :	`com.vmware.vapi.std.errors_client.Unauthorized` if you do not have all of the privileges described as follows : Method execution requires VirtualMachine.Config.AddNewDisk if the OVF descriptor has a disk drive (type 17) section. Method execution requires VirtualMachine.Config.AdvancedConfig if the OVF descriptor has an ExtraConfig section. Method execution requires Extension.Register for specified resource group if the OVF descriptor has a vServiceDependency section. Method execution requires Network.Assign for target network if specified. Method execution requires Datastore.AllocateSpace for target datastore if specified.
Raise :	`com.vmware.vapi.std.errors_client.Unauthorized` if you do not have all of the privileges described as follows: Method execution requires `System.Read`. The resource `com.vmware.content.library.Item` referenced by the parameter `ovf_library_item_id` requires `System.Read`. The resource `HostSystem` referenced by the attribute `LibraryItem.DeploymentTarget.host_id` requires `System.Read`. The resource `Network` referenced by the `dict` value of attribute `LibraryItem.ResourcePoolDeploymentSpec.network_mappings` requires `System.Read`. The resource `StorageProfile` referenced by the attribute `LibraryItem.ResourcePoolDeploymentSpec.storage_profile_id` requires `System.Read`. The resource `Datastore` referenced by the attribute `LibraryItem.ResourcePoolDeploymentSpec.default_datastore_id` requires `System.Read`. The resource `ResourcePool` referenced by the attribute `LibraryItem.DeploymentTarget.resource_pool_id` requires `VApp.Import`. The resource `Folder` referenced by the attribute `LibraryItem.DeploymentTarget.folder_id` requires `VApp.Import`.

LibraryItem.filter(ovf_library_item_id, target)[source]¶

Queries an OVF package stored in content library to retrieve information to use when deploying the package. See LibraryItem.deploy().

This method retrieves information from the descriptor of the OVF package stored in the library item specified by ovf_library_item_id. The information returned by the method can be used to populate the deployment specification (see LibraryItem.ResourcePoolDeploymentSpec when deploying the OVF package to the deployment target specified by target.

Parameters:	ovf_library_item_id (`str`) – Identifier of the content library item containing the OVF package to query. The parameter must be an identifier for the resource type: `com.vmware.content.library.Item`. target (`LibraryItem.DeploymentTarget`) – Specification of the deployment target.
Return type:	`LibraryItem.OvfSummary`
Returns:	Information that can be used to populate the deployment specification (see `LibraryItem.ResourcePoolDeploymentSpec`) when deploying the OVF package to the deployment target specified by `target`.
Raise :	`com.vmware.vapi.std.errors_client.InvalidArgument` if `target` contains invalid arguments.
Raise :	`com.vmware.vapi.std.errors_client.NotFound` if the library item specified by `ovf_library_item_id` does not exist.
Raise :	`com.vmware.vapi.std.errors_client.NotFound` if any resource specified by a attribute of the `LibraryItem.DeploymentTarget` class, specified by `target`, does not exist.
Raise :	`com.vmware.vapi.std.errors_client.ResourceInaccessible` if there was an error accessing the OVF package at the specified `ovf_library_item_id`.
Raise :	`com.vmware.vapi.std.errors_client.Unauthorized` if you do not have all of the privileges described as follows: Method execution requires `System.Read`. The resource `com.vmware.content.library.Item` referenced by the parameter `ovf_library_item_id` requires `System.Read`. The resource `ResourcePool` referenced by the attribute `LibraryItem.DeploymentTarget.resource_pool_id` requires `System.Read`. The resource `HostSystem` referenced by the attribute `LibraryItem.DeploymentTarget.host_id` requires `System.Read`. The resource `Folder` referenced by the attribute `LibraryItem.DeploymentTarget.folder_id` requires `System.Read`.

class com.vmware.vcenter.ovf_client.OvfError(category=None, issues=None, name=None, value=None, message=None, error=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The OvfError class describes an error related to accessing, validating, deploying, or exporting an OVF package.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

category (OvfMessage.Category) – The message category.
issues (list of ParseIssue) – list of parse issues (see ParseIssue). This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.VALIDATION.
name (str) – The name of input parameter. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.INPUT.
value (str) – The value of input parameter. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.INPUT.
message (com.vmware.vapi.std_client.LocalizableMessage) – A localizable message. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.INPUT.
error (vmware.vapi.struct.VapiStruct) – Represents a server com.vmware.vapi.std.errors_client.Error. When clients pass a value of this class as a parameter, the attribute must contain all the attributes defined in com.vmware.vapi.std.errors_client.Error. When methods return a value of this class as a return value, the attribute will contain all the attributes defined in com.vmware.vapi.std.errors_client.Error. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.SERVER.

class com.vmware.vcenter.ovf_client.OvfInfo(messages=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The OvfInfo class contains informational messages related to accessing, validating, deploying, or exporting an OVF package.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:	messages (`list` of `com.vmware.vapi.std_client.LocalizableMessage`) – A `list` of localizable messages (see `com.vmware.vapi.std_client.LocalizableMessage`).

class com.vmware.vcenter.ovf_client.OvfMessage(category=None, issues=None, name=None, value=None, message=None, error=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The OvfMessage class describes a base OVF handling error message related to accessing, validating, deploying, or exporting an OVF package.

These messages fall into different categories defined in OvfMessage.Category:

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

category (OvfMessage.Category) – The message category.
issues (list of ParseIssue) – list of parse issues (see ParseIssue). This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.VALIDATION.
name (str) – The name of input parameter. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.INPUT.
value (str) – The value of input parameter. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.INPUT.
message (com.vmware.vapi.std_client.LocalizableMessage) – A localizable message. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.INPUT.
error (vmware.vapi.struct.VapiStruct) – Represents a server com.vmware.vapi.std.errors_client.Error. When clients pass a value of this class as a parameter, the attribute must contain all the attributes defined in com.vmware.vapi.std.errors_client.Error. When methods return a value of this class as a return value, the attribute will contain all the attributes defined in com.vmware.vapi.std.errors_client.Error. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.SERVER.

class Category(string)[source]¶

Bases: vmware.vapi.bindings.enum.Enum

The OvfMessage.Category class defines the categories of messages (see OvfMessage).

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:	string (`str`) – String value for the `Category` instance.

INPUT = Category(string='INPUT')¶: The user provided input parameters are invalid.

SERVER = Category(string='SERVER')¶: Server error.

VALIDATION = Category(string='VALIDATION')¶: The OVF descriptor is invalid, for example, syntax errors or schema errors.

class com.vmware.vcenter.ovf_client.OvfParams(type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The OvfParams class defines the common attributes for all OVF deployment parameters. OVF parameters serve several purposes:

Describe information about a given OVF package.
Describe default deployment configuration.
Describe possible deployment values based on the deployment environment.
Provide deployment-specific configuration.

Each OVF parameters class specifies a particular configurable aspect of OVF deployment. An aspect has both a query-model and a deploy-model. The query-model is used when the OVF package is queried, and the deploy-model is used when deploying an OVF package.

Most OVF parameter classes provide both informational and deployment parameters. However, some are purely informational (for example, download size) and some are purely deployment parameters (for example, the flag to indicate whether registration as a vCenter extension is accepted).

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:	type (`str`) – Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters class. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class com.vmware.vcenter.ovf_client.OvfWarning(category=None, issues=None, name=None, value=None, message=None, error=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The OvfWarning class describes a warning related to accessing, validating, deploying, or exporting an OVF package.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

category (OvfMessage.Category) – The message category.
issues (list of ParseIssue) – list of parse issues (see ParseIssue). This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.VALIDATION.
name (str) – The name of input parameter. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.INPUT.
value (str) – The value of input parameter. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.INPUT.
message (com.vmware.vapi.std_client.LocalizableMessage) – A localizable message. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.INPUT.
error (vmware.vapi.struct.VapiStruct) – Represents a server com.vmware.vapi.std.errors_client.Error. When clients pass a value of this class as a parameter, the attribute must contain all the attributes defined in com.vmware.vapi.std.errors_client.Error. When methods return a value of this class as a return value, the attribute will contain all the attributes defined in com.vmware.vapi.std.errors_client.Error. This attribute is optional and it is only relevant when the value of category is OvfMessage.Category.SERVER.

class com.vmware.vcenter.ovf_client.ParseIssue(category=None, file=None, line_number=None, column_number=None, message=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ParseIssue class contains the information about the issue found when parsing an OVF package during deployment or exporting an OVF package including:

Parsing and validation error on OVF descriptor (which is an XML document), manifest and certificate files.
OVF descriptor generating and device error.
Unexpected server error.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

category (ParseIssue.Category) – The category of the parse issue.
file (str) – The name of the file in which the parse issue was found.
line_number (long) – The line number of the line in the file (see ParseIssue.file) where the parse issue was found (or -1 if not applicable).
column_number (long) – The position in the line (see ParseIssue.line_number) (or -1 if not applicable).
message (com.vmware.vapi.std_client.LocalizableMessage) – A localizable message describing the parse issue.

class Category(string)[source]¶

Bases: vmware.vapi.bindings.enum.Enum

The ParseIssue.Category class defines the categories of issues that can be found when parsing files inside an OVF package (see ParseIssue) including OVF descriptor (which is an XML document), manifest and certificate files, or exporting an OVF package.

Note

This class represents an enumerated type in the interface language definition. The class contains class attributes which represent the values in the current version of the enumerated type. Newer versions of the enumerated type may contain new values. To use new values of the enumerated type in communication with a server that supports the newer version of the API, you instantiate this class. See enumerated type description page.

Parameters:	string (`str`) – String value for the `Category` instance.

ATTRIBUTE_ILLEGAL = Category(string='ATTRIBUTE_ILLEGAL')¶: Illegal attribute error. It indicates that an illegal attribute is set for an element in the OVF descriptor. For example, empty disks do not use format, parentRef, and populatedSize attributes, if these attributes are present in an empty disk element then will get this pasrse issue.

ATTRIBUTE_REQUIRED = Category(string='ATTRIBUTE_REQUIRED')¶: Required attribute error. It indicates that a required attribute is missing from an element in the OVF descriptor.

ELEMENT_ILLEGAL = Category(string='ELEMENT_ILLEGAL')¶: Illegal element error. It indicates that an element is present in a location which is not allowed, or found multiple elements but only one is allowed at the location in the OVF descriptor.

ELEMENT_REQUIRED = Category(string='ELEMENT_REQUIRED')¶: Required element error. It indicates that a required element is missing from the OVF descriptor.

ELEMENT_UNKNOWN = Category(string='ELEMENT_UNKNOWN')¶: Unknown element error. It indicates that an element is unsupported when parsing an OVF descriptor.

EXPORT_ERROR = Category(string='EXPORT_ERROR')¶: Issue during OVF export, for example, malformed deviceId, controller not found, or file backing for a device not found.

GENERATE_ERROR = Category(string='GENERATE_ERROR')¶: OVF descriptor (which is an XML document) generating error, for example, well-formedness errors as well as unexpected processing conditions.

INTERNAL_ERROR = Category(string='INTERNAL_ERROR')¶: Server encountered an unexpected error which prevented it from fulfilling the request.

PARSE_ERROR = Category(string='PARSE_ERROR')¶

OVF package parsing error, including:

OVF descriptor parsing errors, for example, syntax errors or schema errors.
Manifest file parsing and verification errors.
Certificate file parsing and verification errors.

SECTION_RESTRICTION = Category(string='SECTION_RESTRICTION')¶: Section restriction error. It indicates that a section appears in place in the OVF descriptor where it is not allowed, a section appears fewer times than is required, or a section appears more times than is allowed.

SECTION_UNKNOWN = Category(string='SECTION_UNKNOWN')¶: Section unknown error. It indicates that a section is unsupported when parsing an OVF descriptor.

VALIDATION_ERROR = Category(string='VALIDATION_ERROR')¶: An issue with the manifest and signing.

VALUE_ILLEGAL = Category(string='VALUE_ILLEGAL')¶: Illegal value error. For example, the value is malformed, not a number, or outside of the given range, and so on.

class com.vmware.vcenter.ovf_client.Property(class_id=None, id=None, instance_id=None, category=None, ui_optional=None, label=None, description=None, type=None, value=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The Property class contains the information about a property in an OVF package.

A property is uniquely identified by its [classid.]id[.instanceid] fully-qualified name (see Property.class_id, Property.id, and Property.instance_id). If multiple properties in an OVF package have the same fully-qualified name, then the property is excluded and cannot be set. We do warn about this during import.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

class_id (str) – The classId of this OVF property. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
id (str) – The identifier of this OVF property. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
instance_id (str) – The instanceId of this OVF property. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
category (str) – If this is set to a non-empty string, this property starts a new category. This attribute is not used in the input parameters when deploying an OVF package. This attribute is optional in the result when retrieving information about an OVF package. If None, the property is in the same category as the previous item, otherwise, it starts a new category.
ui_optional (bool) –
Whether a category is UI optional. This is only used if this property starts a new category (see Property.category).

The value is stored in an optional attribute vmw:uioptional to the ovf:Category element. The default value is false. If this value is true, the properties within this category are optional. The UI renders this as a group with a check box, and the group is grayed out until the check box is selected. When the check box is selected, the input values are read and used in deployment. If properties within the same category specify conflicting values the default is used. Only implemented in vSphere Web Client 5.1 and later as of Nov 2012. This attribute is not used in the input parameters when deploying an OVF package. This attribute is optional in the result when retrieving information about an OVF package.
label (str) – The display name of this OVF property. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
description (str) – A description of this OVF property. This attribute is not used in the input parameters when deploying an OVF package. This attribute is optional in the result when retrieving information about an OVF package.
type (str) – The type of this OVF property. Refer to the configuration of a virtual appliance/virtual machine for the valid values. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
value (str) – The OVF property value. This contains the default value from ovf:defaultValue if ovf:value is not present when read. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class com.vmware.vcenter.ovf_client.PropertyParams(properties=None, type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The PropertyParams class contains a list of OVF properties that can be configured when the OVF package is deployed.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

properties (list of Property) – list of OVF properties. This attribute is optional in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
type (str) – Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters class. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class com.vmware.vcenter.ovf_client.ScaleOutGroup(id=None, description=None, instance_count=None, minimum_instance_count=None, maximum_instance_count=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ScaleOutGroup class contains information about a scale-out group.

It allows a virtual system collection to contain a set of children that are homogeneous with respect to a prototypical virtual system or virtual system collection. It shall cause the deployment function to replicate the prototype a number of times, thus allowing the number of instantiated virtual systems to be configured dynamically at deployment time.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

id (str) – The identifier of the scale-out group. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
description (str) – The description of the scale-out group. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
instance_count (long) – The scaling factor to use. It defines the number of replicas of the prototypical virtual system or virtual system collection. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
minimum_instance_count (long) – The minimum scaling factor. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package. This will be 1 if there is no explicit limit.
maximum_instance_count (long) – The maximum scaling factor. This attribute is not used in the input parameters when deploying an OVF package. This attribute is optional in the result when retrieving information about an OVF package. This will be None if there is no explicit limit.

class com.vmware.vcenter.ovf_client.ScaleOutParams(groups=None, type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The ScaleOutParams class contains information about the scale-out groups described in the OVF package.

When deploying an OVF package, a deployment specific instance count can be specified (see ScaleOutGroup.instance_count.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

groups (list of ScaleOutGroup) – The list of scale-out groups. This attribute is optional in the input parameters when deploying an OVF package. If None there are no scale-out groups. This attribute will always be present in the result when retrieving information about an OVF package.
type (str) – Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters class. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class com.vmware.vcenter.ovf_client.SizeParams(approximate_download_size=None, approximate_flat_deployment_size=None, approximate_sparse_deployment_size=None, variable_disk_size=None, type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The SizeParams class contains estimates of the download and deployment sizes.

This information is based on the file references and the ovf:DiskSection in the OVF descriptor.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

approximate_download_size (long) –
A best guess as to the total amount of data that must be transferred to download the OVF package.

This may be inaccurate due to disk compression etc.

This attribute is not used in the input parameters when deploying an OVF package. This attribute is optional in the result when retrieving information about an OVF package. It will be None if there is insufficient information to provide a proper estimate.
approximate_flat_deployment_size (long) – A best guess as to the total amount of space required to deploy the OVF package if using flat disks. This attribute is not used in the input parameters when deploying an OVF package. This attribute is optional in the result when retrieving information about an OVF package. It will be None if there is insufficient information to provide a proper estimate.
approximate_sparse_deployment_size (long) – A best guess as to the total amount of space required to deploy the OVF package using sparse disks. This attribute is not used in the input parameters when deploying an OVF package. This attribute is optional in the result when retrieving information about an OVF package. It will be None if there is insufficient information to provide a proper estimate.
variable_disk_size (bool) –
Whether the OVF uses variable disk sizes.

For empty disks, rather than specifying a fixed virtual disk capacity, the capacity may be given using a reference to a ovf:Property element in a ovf:ProductSection element in OVF package. This attribute is not used in the input parameters when deploying an OVF package. This attribute is optional in the result when retrieving information about an OVF package. If None or false, the OVF does not use variable disk sizes.
type (str) – Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters class. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class com.vmware.vcenter.ovf_client.UnknownSection(tag=None, info=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The UnknownSection class contains information about an unknown section in an OVF package.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:	tag (`str`) – A namespace-qualified tag in the form `{ns}tag`. info (`str`) – The description of the Info element.

class com.vmware.vcenter.ovf_client.UnknownSectionParams(unknown_sections=None, type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The UnknownSectionParams class contains a list of unknown, non-required sections.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

unknown_sections (list of UnknownSection) – list of unknown, non-required sections. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
type (str) – Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters class. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

class com.vmware.vcenter.ovf_client.VcenterExtensionParams(required=None, registration_accepted=None, type=None)[source]¶

Bases: vmware.vapi.bindings.struct.VapiStruct

The VcenterExtensionParams class specifies that the OVF package should be registered as a vCenter extension. The virtual machine or virtual appliance will gain unrestricted access to the vCenter Server APIs. It must be connected to a network with connectivity to the vCenter server.

Tip

The arguments are used to initialize data attributes with the same names.

Parameters:

required (bool) – Whether registration as a vCenter extension is required. This attribute is not used in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
registration_accepted (bool) –
Whether registration as a vCenter extension is accepted.

If registration as a vCenter extension is required (see VcenterExtensionParams.required), this must be set to true during deployment. Defaults to false when returned from server. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.
type (str) – Unique identifier describing the type of the OVF parameters. The value is the name of the OVF parameters class. This attribute must be provided in the input parameters when deploying an OVF package. This attribute will always be present in the result when retrieving information about an OVF package.

vcenter Package¶

`vcenter` Package¶

`inventory_client` Module¶

`ovf_client` Module¶

Table Of Contents

Previous topic

Next topic

This Page

Navigation

vcenter Package¶

vcenter Package¶

inventory_client Module¶

ovf_client Module¶

Table Of Contents

Previous topic

Next topic

This Page

Quick search

Navigation

`vcenter` Package¶

`inventory_client` Module¶

`ovf_client` Module¶