1. Packages
  2. Vsphere Provider
  3. API Docs
  4. getOvfVmTemplate
vSphere v4.13.2 published on Wednesday, Apr 9, 2025 by Pulumi

vsphere.getOvfVmTemplate

Explore with Pulumi AI

vSphere v4.13.2 published on Wednesday, Apr 9, 2025 by Pulumi

The vsphere.getOvfVmTemplate data source can be used to submit an OVF to vSphere and extract its hardware settings in a form that can be then used as inputs for a vsphere.VirtualMachine resource.

Using getOvfVmTemplate

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getOvfVmTemplate(args: GetOvfVmTemplateArgs, opts?: InvokeOptions): Promise<GetOvfVmTemplateResult>
function getOvfVmTemplateOutput(args: GetOvfVmTemplateOutputArgs, opts?: InvokeOptions): Output<GetOvfVmTemplateResult>
Copy
def get_ovf_vm_template(allow_unverified_ssl_cert: Optional[bool] = None,
                        datastore_id: Optional[str] = None,
                        deployment_option: Optional[str] = None,
                        disk_provisioning: Optional[str] = None,
                        enable_hidden_properties: Optional[bool] = None,
                        folder: Optional[str] = None,
                        host_system_id: Optional[str] = None,
                        ip_allocation_policy: Optional[str] = None,
                        ip_protocol: Optional[str] = None,
                        local_ovf_path: Optional[str] = None,
                        name: Optional[str] = None,
                        ovf_network_map: Optional[Mapping[str, str]] = None,
                        remote_ovf_url: Optional[str] = None,
                        resource_pool_id: Optional[str] = None,
                        opts: Optional[InvokeOptions] = None) -> GetOvfVmTemplateResult
def get_ovf_vm_template_output(allow_unverified_ssl_cert: Optional[pulumi.Input[bool]] = None,
                        datastore_id: Optional[pulumi.Input[str]] = None,
                        deployment_option: Optional[pulumi.Input[str]] = None,
                        disk_provisioning: Optional[pulumi.Input[str]] = None,
                        enable_hidden_properties: Optional[pulumi.Input[bool]] = None,
                        folder: Optional[pulumi.Input[str]] = None,
                        host_system_id: Optional[pulumi.Input[str]] = None,
                        ip_allocation_policy: Optional[pulumi.Input[str]] = None,
                        ip_protocol: Optional[pulumi.Input[str]] = None,
                        local_ovf_path: Optional[pulumi.Input[str]] = None,
                        name: Optional[pulumi.Input[str]] = None,
                        ovf_network_map: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                        remote_ovf_url: Optional[pulumi.Input[str]] = None,
                        resource_pool_id: Optional[pulumi.Input[str]] = None,
                        opts: Optional[InvokeOptions] = None) -> Output[GetOvfVmTemplateResult]
Copy
func GetOvfVmTemplate(ctx *Context, args *GetOvfVmTemplateArgs, opts ...InvokeOption) (*GetOvfVmTemplateResult, error)
func GetOvfVmTemplateOutput(ctx *Context, args *GetOvfVmTemplateOutputArgs, opts ...InvokeOption) GetOvfVmTemplateResultOutput
Copy

> Note: This function is named GetOvfVmTemplate in the Go SDK.

public static class GetOvfVmTemplate 
{
    public static Task<GetOvfVmTemplateResult> InvokeAsync(GetOvfVmTemplateArgs args, InvokeOptions? opts = null)
    public static Output<GetOvfVmTemplateResult> Invoke(GetOvfVmTemplateInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetOvfVmTemplateResult> getOvfVmTemplate(GetOvfVmTemplateArgs args, InvokeOptions options)
public static Output<GetOvfVmTemplateResult> getOvfVmTemplate(GetOvfVmTemplateArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: vsphere:index/getOvfVmTemplate:getOvfVmTemplate
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

HostSystemId This property is required. string
The ID of the ESXi host system to deploy the virtual machine.
Name This property is required. string
Name of the virtual machine to create.
ResourcePoolId This property is required. string
The ID of a resource pool in which to place the virtual machine.
AllowUnverifiedSslCert bool
Allow unverified SSL certificates when deploying OVF/OVA from a URL.
DatastoreId string
The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual disks that are created without datastores.
DeploymentOption Changes to this property will trigger replacement. string
The key of the chosen deployment option. If empty, the default option is chosen.
DiskProvisioning Changes to this property will trigger replacement. string
The disk provisioning type. If set, all the disks in the deployed OVA/OVF will have the same specified disk type. Can be one of thin, flat, thick or sameAsSource.
EnableHiddenProperties Changes to this property will trigger replacement. bool
Allow properties with ovf:userConfigurable=false to be set.
Folder string
The name of the folder in which to place the virtual machine.
IpAllocationPolicy Changes to this property will trigger replacement. string
The IP allocation policy.
IpProtocol Changes to this property will trigger replacement. string
The IP protocol.
LocalOvfPath Changes to this property will trigger replacement. string
The absolute path to the OVF/OVA file on the local system. When deploying from an OVF, ensure all necessary files such as the .vmdk files are present in the same directory as the OVF.
OvfNetworkMap Changes to this property will trigger replacement. Dictionary<string, string>
The mapping of name of network identifiers from the OVF descriptor to network UUID in the environment.
RemoteOvfUrl Changes to this property will trigger replacement. string

URL of the remote OVF/OVA file to be deployed.

NOTE: Either local_ovf_path or remote_ovf_url is required, both can not be empty.

HostSystemId This property is required. string
The ID of the ESXi host system to deploy the virtual machine.
Name This property is required. string
Name of the virtual machine to create.
ResourcePoolId This property is required. string
The ID of a resource pool in which to place the virtual machine.
AllowUnverifiedSslCert bool
Allow unverified SSL certificates when deploying OVF/OVA from a URL.
DatastoreId string
The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual disks that are created without datastores.
DeploymentOption Changes to this property will trigger replacement. string
The key of the chosen deployment option. If empty, the default option is chosen.
DiskProvisioning Changes to this property will trigger replacement. string
The disk provisioning type. If set, all the disks in the deployed OVA/OVF will have the same specified disk type. Can be one of thin, flat, thick or sameAsSource.
EnableHiddenProperties Changes to this property will trigger replacement. bool
Allow properties with ovf:userConfigurable=false to be set.
Folder string
The name of the folder in which to place the virtual machine.
IpAllocationPolicy Changes to this property will trigger replacement. string
The IP allocation policy.
IpProtocol Changes to this property will trigger replacement. string
The IP protocol.
LocalOvfPath Changes to this property will trigger replacement. string
The absolute path to the OVF/OVA file on the local system. When deploying from an OVF, ensure all necessary files such as the .vmdk files are present in the same directory as the OVF.
OvfNetworkMap Changes to this property will trigger replacement. map[string]string
The mapping of name of network identifiers from the OVF descriptor to network UUID in the environment.
RemoteOvfUrl Changes to this property will trigger replacement. string

URL of the remote OVF/OVA file to be deployed.

NOTE: Either local_ovf_path or remote_ovf_url is required, both can not be empty.

hostSystemId This property is required. String
The ID of the ESXi host system to deploy the virtual machine.
name This property is required. String
Name of the virtual machine to create.
resourcePoolId This property is required. String
The ID of a resource pool in which to place the virtual machine.
allowUnverifiedSslCert Boolean
Allow unverified SSL certificates when deploying OVF/OVA from a URL.
datastoreId String
The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual disks that are created without datastores.
deploymentOption Changes to this property will trigger replacement. String
The key of the chosen deployment option. If empty, the default option is chosen.
diskProvisioning Changes to this property will trigger replacement. String
The disk provisioning type. If set, all the disks in the deployed OVA/OVF will have the same specified disk type. Can be one of thin, flat, thick or sameAsSource.
enableHiddenProperties Changes to this property will trigger replacement. Boolean
Allow properties with ovf:userConfigurable=false to be set.
folder String
The name of the folder in which to place the virtual machine.
ipAllocationPolicy Changes to this property will trigger replacement. String
The IP allocation policy.
ipProtocol Changes to this property will trigger replacement. String
The IP protocol.
localOvfPath Changes to this property will trigger replacement. String
The absolute path to the OVF/OVA file on the local system. When deploying from an OVF, ensure all necessary files such as the .vmdk files are present in the same directory as the OVF.
ovfNetworkMap Changes to this property will trigger replacement. Map<String,String>
The mapping of name of network identifiers from the OVF descriptor to network UUID in the environment.
remoteOvfUrl Changes to this property will trigger replacement. String

URL of the remote OVF/OVA file to be deployed.

NOTE: Either local_ovf_path or remote_ovf_url is required, both can not be empty.

hostSystemId This property is required. string
The ID of the ESXi host system to deploy the virtual machine.
name This property is required. string
Name of the virtual machine to create.
resourcePoolId This property is required. string
The ID of a resource pool in which to place the virtual machine.
allowUnverifiedSslCert boolean
Allow unverified SSL certificates when deploying OVF/OVA from a URL.
datastoreId string
The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual disks that are created without datastores.
deploymentOption Changes to this property will trigger replacement. string
The key of the chosen deployment option. If empty, the default option is chosen.
diskProvisioning Changes to this property will trigger replacement. string
The disk provisioning type. If set, all the disks in the deployed OVA/OVF will have the same specified disk type. Can be one of thin, flat, thick or sameAsSource.
enableHiddenProperties Changes to this property will trigger replacement. boolean
Allow properties with ovf:userConfigurable=false to be set.
folder string
The name of the folder in which to place the virtual machine.
ipAllocationPolicy Changes to this property will trigger replacement. string
The IP allocation policy.
ipProtocol Changes to this property will trigger replacement. string
The IP protocol.
localOvfPath Changes to this property will trigger replacement. string
The absolute path to the OVF/OVA file on the local system. When deploying from an OVF, ensure all necessary files such as the .vmdk files are present in the same directory as the OVF.
ovfNetworkMap Changes to this property will trigger replacement. {[key: string]: string}
The mapping of name of network identifiers from the OVF descriptor to network UUID in the environment.
remoteOvfUrl Changes to this property will trigger replacement. string

URL of the remote OVF/OVA file to be deployed.

NOTE: Either local_ovf_path or remote_ovf_url is required, both can not be empty.

host_system_id This property is required. str
The ID of the ESXi host system to deploy the virtual machine.
name This property is required. str
Name of the virtual machine to create.
resource_pool_id This property is required. str
The ID of a resource pool in which to place the virtual machine.
allow_unverified_ssl_cert bool
Allow unverified SSL certificates when deploying OVF/OVA from a URL.
datastore_id str
The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual disks that are created without datastores.
deployment_option Changes to this property will trigger replacement. str
The key of the chosen deployment option. If empty, the default option is chosen.
disk_provisioning Changes to this property will trigger replacement. str
The disk provisioning type. If set, all the disks in the deployed OVA/OVF will have the same specified disk type. Can be one of thin, flat, thick or sameAsSource.
enable_hidden_properties Changes to this property will trigger replacement. bool
Allow properties with ovf:userConfigurable=false to be set.
folder str
The name of the folder in which to place the virtual machine.
ip_allocation_policy Changes to this property will trigger replacement. str
The IP allocation policy.
ip_protocol Changes to this property will trigger replacement. str
The IP protocol.
local_ovf_path Changes to this property will trigger replacement. str
The absolute path to the OVF/OVA file on the local system. When deploying from an OVF, ensure all necessary files such as the .vmdk files are present in the same directory as the OVF.
ovf_network_map Changes to this property will trigger replacement. Mapping[str, str]
The mapping of name of network identifiers from the OVF descriptor to network UUID in the environment.
remote_ovf_url Changes to this property will trigger replacement. str

URL of the remote OVF/OVA file to be deployed.

NOTE: Either local_ovf_path or remote_ovf_url is required, both can not be empty.

hostSystemId This property is required. String
The ID of the ESXi host system to deploy the virtual machine.
name This property is required. String
Name of the virtual machine to create.
resourcePoolId This property is required. String
The ID of a resource pool in which to place the virtual machine.
allowUnverifiedSslCert Boolean
Allow unverified SSL certificates when deploying OVF/OVA from a URL.
datastoreId String
The ID of the virtual machine's datastore. The virtual machine configuration is placed here, along with any virtual disks that are created without datastores.
deploymentOption Changes to this property will trigger replacement. String
The key of the chosen deployment option. If empty, the default option is chosen.
diskProvisioning Changes to this property will trigger replacement. String
The disk provisioning type. If set, all the disks in the deployed OVA/OVF will have the same specified disk type. Can be one of thin, flat, thick or sameAsSource.
enableHiddenProperties Changes to this property will trigger replacement. Boolean
Allow properties with ovf:userConfigurable=false to be set.
folder String
The name of the folder in which to place the virtual machine.
ipAllocationPolicy Changes to this property will trigger replacement. String
The IP allocation policy.
ipProtocol Changes to this property will trigger replacement. String
The IP protocol.
localOvfPath Changes to this property will trigger replacement. String
The absolute path to the OVF/OVA file on the local system. When deploying from an OVF, ensure all necessary files such as the .vmdk files are present in the same directory as the OVF.
ovfNetworkMap Changes to this property will trigger replacement. Map<String>
The mapping of name of network identifiers from the OVF descriptor to network UUID in the environment.
remoteOvfUrl Changes to this property will trigger replacement. String

URL of the remote OVF/OVA file to be deployed.

NOTE: Either local_ovf_path or remote_ovf_url is required, both can not be empty.

getOvfVmTemplate Result

The following output properties are available:

AlternateGuestName string
An alternate guest operating system name.
Annotation string
A description of the virtual machine.
CpuHotAddEnabled bool
Allow CPUs to be added to the virtual machine while powered on.
CpuHotRemoveEnabled bool
Allow CPUs to be removed from the virtual machine while powered on.
CpuPerformanceCountersEnabled bool
Firmware string
The firmware to use on the virtual machine.
GuestId string
The ID for the guest operating system
HostSystemId string
Id string
The provider-assigned unique ID for this managed resource.
IdeControllerCount int
Memory int
The size of the virtual machine memory, in MB.
MemoryHotAddEnabled bool
Allow memory to be added to the virtual machine while powered on.
Name string
NestedHvEnabled bool
Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest.
NumCoresPerSocket int
The number of cores per virtual CPU in the virtual machine.
NumCpus int
The number of virtual CPUs to assign to the virtual machine.
ResourcePoolId string
SataControllerCount int
ScsiControllerCount int
ScsiType string
SwapPlacementPolicy string
The swap file placement policy for the virtual machine.
AllowUnverifiedSslCert bool
DatastoreId string
DeploymentOption string
DiskProvisioning string
EnableHiddenProperties bool
Folder string
IpAllocationPolicy string
IpProtocol string
LocalOvfPath string
OvfNetworkMap Dictionary<string, string>
RemoteOvfUrl string
AlternateGuestName string
An alternate guest operating system name.
Annotation string
A description of the virtual machine.
CpuHotAddEnabled bool
Allow CPUs to be added to the virtual machine while powered on.
CpuHotRemoveEnabled bool
Allow CPUs to be removed from the virtual machine while powered on.
CpuPerformanceCountersEnabled bool
Firmware string
The firmware to use on the virtual machine.
GuestId string
The ID for the guest operating system
HostSystemId string
Id string
The provider-assigned unique ID for this managed resource.
IdeControllerCount int
Memory int
The size of the virtual machine memory, in MB.
MemoryHotAddEnabled bool
Allow memory to be added to the virtual machine while powered on.
Name string
NestedHvEnabled bool
Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest.
NumCoresPerSocket int
The number of cores per virtual CPU in the virtual machine.
NumCpus int
The number of virtual CPUs to assign to the virtual machine.
ResourcePoolId string
SataControllerCount int
ScsiControllerCount int
ScsiType string
SwapPlacementPolicy string
The swap file placement policy for the virtual machine.
AllowUnverifiedSslCert bool
DatastoreId string
DeploymentOption string
DiskProvisioning string
EnableHiddenProperties bool
Folder string
IpAllocationPolicy string
IpProtocol string
LocalOvfPath string
OvfNetworkMap map[string]string
RemoteOvfUrl string
alternateGuestName String
An alternate guest operating system name.
annotation String
A description of the virtual machine.
cpuHotAddEnabled Boolean
Allow CPUs to be added to the virtual machine while powered on.
cpuHotRemoveEnabled Boolean
Allow CPUs to be removed from the virtual machine while powered on.
cpuPerformanceCountersEnabled Boolean
firmware String
The firmware to use on the virtual machine.
guestId String
The ID for the guest operating system
hostSystemId String
id String
The provider-assigned unique ID for this managed resource.
ideControllerCount Integer
memory Integer
The size of the virtual machine memory, in MB.
memoryHotAddEnabled Boolean
Allow memory to be added to the virtual machine while powered on.
name String
nestedHvEnabled Boolean
Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest.
numCoresPerSocket Integer
The number of cores per virtual CPU in the virtual machine.
numCpus Integer
The number of virtual CPUs to assign to the virtual machine.
resourcePoolId String
sataControllerCount Integer
scsiControllerCount Integer
scsiType String
swapPlacementPolicy String
The swap file placement policy for the virtual machine.
allowUnverifiedSslCert Boolean
datastoreId String
deploymentOption String
diskProvisioning String
enableHiddenProperties Boolean
folder String
ipAllocationPolicy String
ipProtocol String
localOvfPath String
ovfNetworkMap Map<String,String>
remoteOvfUrl String
alternateGuestName string
An alternate guest operating system name.
annotation string
A description of the virtual machine.
cpuHotAddEnabled boolean
Allow CPUs to be added to the virtual machine while powered on.
cpuHotRemoveEnabled boolean
Allow CPUs to be removed from the virtual machine while powered on.
cpuPerformanceCountersEnabled boolean
firmware string
The firmware to use on the virtual machine.
guestId string
The ID for the guest operating system
hostSystemId string
id string
The provider-assigned unique ID for this managed resource.
ideControllerCount number
memory number
The size of the virtual machine memory, in MB.
memoryHotAddEnabled boolean
Allow memory to be added to the virtual machine while powered on.
name string
nestedHvEnabled boolean
Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest.
numCoresPerSocket number
The number of cores per virtual CPU in the virtual machine.
numCpus number
The number of virtual CPUs to assign to the virtual machine.
resourcePoolId string
sataControllerCount number
scsiControllerCount number
scsiType string
swapPlacementPolicy string
The swap file placement policy for the virtual machine.
allowUnverifiedSslCert boolean
datastoreId string
deploymentOption string
diskProvisioning string
enableHiddenProperties boolean
folder string
ipAllocationPolicy string
ipProtocol string
localOvfPath string
ovfNetworkMap {[key: string]: string}
remoteOvfUrl string
alternate_guest_name str
An alternate guest operating system name.
annotation str
A description of the virtual machine.
cpu_hot_add_enabled bool
Allow CPUs to be added to the virtual machine while powered on.
cpu_hot_remove_enabled bool
Allow CPUs to be removed from the virtual machine while powered on.
cpu_performance_counters_enabled bool
firmware str
The firmware to use on the virtual machine.
guest_id str
The ID for the guest operating system
host_system_id str
id str
The provider-assigned unique ID for this managed resource.
ide_controller_count int
memory int
The size of the virtual machine memory, in MB.
memory_hot_add_enabled bool
Allow memory to be added to the virtual machine while powered on.
name str
nested_hv_enabled bool
Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest.
num_cores_per_socket int
The number of cores per virtual CPU in the virtual machine.
num_cpus int
The number of virtual CPUs to assign to the virtual machine.
resource_pool_id str
sata_controller_count int
scsi_controller_count int
scsi_type str
swap_placement_policy str
The swap file placement policy for the virtual machine.
allow_unverified_ssl_cert bool
datastore_id str
deployment_option str
disk_provisioning str
enable_hidden_properties bool
folder str
ip_allocation_policy str
ip_protocol str
local_ovf_path str
ovf_network_map Mapping[str, str]
remote_ovf_url str
alternateGuestName String
An alternate guest operating system name.
annotation String
A description of the virtual machine.
cpuHotAddEnabled Boolean
Allow CPUs to be added to the virtual machine while powered on.
cpuHotRemoveEnabled Boolean
Allow CPUs to be removed from the virtual machine while powered on.
cpuPerformanceCountersEnabled Boolean
firmware String
The firmware to use on the virtual machine.
guestId String
The ID for the guest operating system
hostSystemId String
id String
The provider-assigned unique ID for this managed resource.
ideControllerCount Number
memory Number
The size of the virtual machine memory, in MB.
memoryHotAddEnabled Boolean
Allow memory to be added to the virtual machine while powered on.
name String
nestedHvEnabled Boolean
Enable nested hardware virtualization on the virtual machine, facilitating nested virtualization in the guest.
numCoresPerSocket Number
The number of cores per virtual CPU in the virtual machine.
numCpus Number
The number of virtual CPUs to assign to the virtual machine.
resourcePoolId String
sataControllerCount Number
scsiControllerCount Number
scsiType String
swapPlacementPolicy String
The swap file placement policy for the virtual machine.
allowUnverifiedSslCert Boolean
datastoreId String
deploymentOption String
diskProvisioning String
enableHiddenProperties Boolean
folder String
ipAllocationPolicy String
ipProtocol String
localOvfPath String
ovfNetworkMap Map<String>
remoteOvfUrl String

Package Details

Repository
vSphere pulumi/pulumi-vsphere
License
Apache-2.0
Notes
This Pulumi package is based on the vsphere Terraform Provider.
vSphere v4.13.2 published on Wednesday, Apr 9, 2025 by Pulumi