1. Packages
  2. Vcd Provider
  3. API Docs
  4. getVappVm
vcd 3.14.1 published on Monday, Apr 14, 2025 by vmware

vcd.getVappVm

Explore with Pulumi AI

Provides a VMware Cloud Director VM data source. This can be used to access VMs within a vApp.

Supported in provider v2.6+

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as vcd from "@pulumi/vcd";

const web = vcd.getVapp({
    name: "web",
});
const web1 = web.then(web => vcd.getVappVm({
    vappName: web.name,
    name: "web1",
}));
export const vmId = data.vcd_vapp_vm.id;
export const vm = web1;
Copy
import pulumi
import pulumi_vcd as vcd

web = vcd.get_vapp(name="web")
web1 = vcd.get_vapp_vm(vapp_name=web.name,
    name="web1")
pulumi.export("vmId", data["vcd_vapp_vm"]["id"])
pulumi.export("vm", web1)
Copy
package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/vcd/v3/vcd"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		web, err := vcd.LookupVapp(ctx, &vcd.LookupVappArgs{
			Name: "web",
		}, nil)
		if err != nil {
			return err
		}
		web1, err := vcd.LookupVappVm(ctx, &vcd.LookupVappVmArgs{
			VappName: web.Name,
			Name:     "web1",
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("vmId", data.Vcd_vapp_vm.Id)
		ctx.Export("vm", web1)
		return nil
	})
}
Copy
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Vcd = Pulumi.Vcd;

return await Deployment.RunAsync(() => 
{
    var web = Vcd.GetVapp.Invoke(new()
    {
        Name = "web",
    });

    var web1 = Vcd.GetVappVm.Invoke(new()
    {
        VappName = web.Apply(getVappResult => getVappResult.Name),
        Name = "web1",
    });

    return new Dictionary<string, object?>
    {
        ["vmId"] = data.Vcd_vapp_vm.Id,
        ["vm"] = web1,
    };
});
Copy
package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.vcd.VcdFunctions;
import com.pulumi.vcd.inputs.GetVappArgs;
import com.pulumi.vcd.inputs.GetVappVmArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        final var web = VcdFunctions.getVapp(GetVappArgs.builder()
            .name("web")
            .build());

        final var web1 = VcdFunctions.getVappVm(GetVappVmArgs.builder()
            .vappName(web.applyValue(getVappResult -> getVappResult.name()))
            .name("web1")
            .build());

        ctx.export("vmId", data.vcd_vapp_vm().id());
        ctx.export("vm", web1.applyValue(getVappVmResult -> getVappVmResult));
    }
}
Copy
variables:
  web:
    fn::invoke:
      function: vcd:getVapp
      arguments:
        name: web
  web1:
    fn::invoke:
      function: vcd:getVappVm
      arguments:
        vappName: ${web.name}
        name: web1
outputs:
  vmId: ${data.vcd_vapp_vm.id}
  vm: ${web1}
Copy

Sample output:

vm = {
  "computer_name" = "TestVM"
  "cpu_cores" = 1
  "cpus" = 2
  "description" = "This OVA provides a minimal installed profile of PhotonOS. Default password for root user is changeme"
  "disk" = []
  "guest_properties" = {}
  "href" = "https://my-vcd.org/api/vApp/vm-ecb449a2-0b11-494d-bbc7-6ae2f2ff9b82"
  "id" = "urn:vcloud:vm:ecb449a2-0b11-494d-bbc7-6ae2f2ff9b82"
  "memory" = 1024
  "metadata" = {
    "vm_metadata" = "VM Metadata."
  }
  "name" = "vm-datacloud"
  "network" = [
    {
      "ip" = "192.168.2.10"
      "ip_allocation_mode" = "MANUAL"
      "is_primary" = true
      "mac" = "00:50:56:29:08:89"
      "name" = "net-datacloud-r"
      "type" = "org"
    },
  ]
  "org" = "datacloud"
  "storage_profile" = "*"
  "vapp_name" = "vapp-datacloud"
  "vdc" = "vdc-datacloud"
}

Metadata

The metadata_entry (v3.8+) is a set of metadata entries that have the following structure:

  • key - Key of this metadata entry.
  • value - Value of this metadata entry.
  • type - Type of this metadata entry. One of: MetadataStringValue, MetadataNumberValue, MetadataDateTimeValue, MetadataBooleanValue.
  • user_access - User access level for this metadata entry. One of: PRIVATE (hidden), READONLY (read only), READWRITE (read/write).
  • is_system - Domain for this metadata entry. true if it belongs to SYSTEM, false if it belongs to GENERAL.

Using getVappVm

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 getVappVm(args: GetVappVmArgs, opts?: InvokeOptions): Promise<GetVappVmResult>
function getVappVmOutput(args: GetVappVmOutputArgs, opts?: InvokeOptions): Output<GetVappVmResult>
Copy
def get_vapp_vm(id: Optional[str] = None,
                name: Optional[str] = None,
                network_dhcp_wait_seconds: Optional[float] = None,
                org: Optional[str] = None,
                placement_policy_id: Optional[str] = None,
                sizing_policy_id: Optional[str] = None,
                vapp_name: Optional[str] = None,
                vdc: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetVappVmResult
def get_vapp_vm_output(id: Optional[pulumi.Input[str]] = None,
                name: Optional[pulumi.Input[str]] = None,
                network_dhcp_wait_seconds: Optional[pulumi.Input[float]] = None,
                org: Optional[pulumi.Input[str]] = None,
                placement_policy_id: Optional[pulumi.Input[str]] = None,
                sizing_policy_id: Optional[pulumi.Input[str]] = None,
                vapp_name: Optional[pulumi.Input[str]] = None,
                vdc: Optional[pulumi.Input[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetVappVmResult]
Copy
func LookupVappVm(ctx *Context, args *LookupVappVmArgs, opts ...InvokeOption) (*LookupVappVmResult, error)
func LookupVappVmOutput(ctx *Context, args *LookupVappVmOutputArgs, opts ...InvokeOption) LookupVappVmResultOutput
Copy

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

public static class GetVappVm 
{
    public static Task<GetVappVmResult> InvokeAsync(GetVappVmArgs args, InvokeOptions? opts = null)
    public static Output<GetVappVmResult> Invoke(GetVappVmInvokeArgs args, InvokeOptions? opts = null)
}
Copy
public static CompletableFuture<GetVappVmResult> getVappVm(GetVappVmArgs args, InvokeOptions options)
public static Output<GetVappVmResult> getVappVm(GetVappVmArgs args, InvokeOptions options)
Copy
fn::invoke:
  function: vcd:index/getVappVm:getVappVm
  arguments:
    # arguments dictionary
Copy

The following arguments are supported:

Name This property is required. string
A name for the VM, unique within the vApp
VappName This property is required. string
The vApp this VM belongs to.
Id string
NetworkDhcpWaitSeconds double
Allows to wait for up to a defined amount of seconds before IP address is reported for NICs with ip_allocation_mode=DHCP setting. It constantly checks if IP is reported so the time given is a maximum. VM must be powered on and at least one of the following must be true:

  • VM has guest tools. It waits for IP address to be reported in vCD UI. This is a slower option, but does not require for the VM to use Edge Gateways DHCP service.
  • VM DHCP interface is connected to routed Org network and is using Edge Gateways DHCP service (not relayed). It works by querying DHCP leases on edge gateway. In general it is quicker than waiting until UI reports IP addresses, but is more constrained. However this is the only option if guest tools are not present on the VM.
Org string
The name of organization to use, optional if defined at provider level. Useful when connected as sysadmin working across different organisations
PlacementPolicyId string
(v3.8+) VM placement policy ID.
SizingPolicyId string
(v3.0+, vCD 10.0+) VM sizing policy ID.
Vdc string
The name of VDC to use, optional if defined at provider level
Name This property is required. string
A name for the VM, unique within the vApp
VappName This property is required. string
The vApp this VM belongs to.
Id string
NetworkDhcpWaitSeconds float64
Allows to wait for up to a defined amount of seconds before IP address is reported for NICs with ip_allocation_mode=DHCP setting. It constantly checks if IP is reported so the time given is a maximum. VM must be powered on and at least one of the following must be true:

  • VM has guest tools. It waits for IP address to be reported in vCD UI. This is a slower option, but does not require for the VM to use Edge Gateways DHCP service.
  • VM DHCP interface is connected to routed Org network and is using Edge Gateways DHCP service (not relayed). It works by querying DHCP leases on edge gateway. In general it is quicker than waiting until UI reports IP addresses, but is more constrained. However this is the only option if guest tools are not present on the VM.
Org string
The name of organization to use, optional if defined at provider level. Useful when connected as sysadmin working across different organisations
PlacementPolicyId string
(v3.8+) VM placement policy ID.
SizingPolicyId string
(v3.0+, vCD 10.0+) VM sizing policy ID.
Vdc string
The name of VDC to use, optional if defined at provider level
name This property is required. String
A name for the VM, unique within the vApp
vappName This property is required. String
The vApp this VM belongs to.
id String
networkDhcpWaitSeconds Double
Allows to wait for up to a defined amount of seconds before IP address is reported for NICs with ip_allocation_mode=DHCP setting. It constantly checks if IP is reported so the time given is a maximum. VM must be powered on and at least one of the following must be true:

  • VM has guest tools. It waits for IP address to be reported in vCD UI. This is a slower option, but does not require for the VM to use Edge Gateways DHCP service.
  • VM DHCP interface is connected to routed Org network and is using Edge Gateways DHCP service (not relayed). It works by querying DHCP leases on edge gateway. In general it is quicker than waiting until UI reports IP addresses, but is more constrained. However this is the only option if guest tools are not present on the VM.
org String
The name of organization to use, optional if defined at provider level. Useful when connected as sysadmin working across different organisations
placementPolicyId String
(v3.8+) VM placement policy ID.
sizingPolicyId String
(v3.0+, vCD 10.0+) VM sizing policy ID.
vdc String
The name of VDC to use, optional if defined at provider level
name This property is required. string
A name for the VM, unique within the vApp
vappName This property is required. string
The vApp this VM belongs to.
id string
networkDhcpWaitSeconds number
Allows to wait for up to a defined amount of seconds before IP address is reported for NICs with ip_allocation_mode=DHCP setting. It constantly checks if IP is reported so the time given is a maximum. VM must be powered on and at least one of the following must be true:

  • VM has guest tools. It waits for IP address to be reported in vCD UI. This is a slower option, but does not require for the VM to use Edge Gateways DHCP service.
  • VM DHCP interface is connected to routed Org network and is using Edge Gateways DHCP service (not relayed). It works by querying DHCP leases on edge gateway. In general it is quicker than waiting until UI reports IP addresses, but is more constrained. However this is the only option if guest tools are not present on the VM.
org string
The name of organization to use, optional if defined at provider level. Useful when connected as sysadmin working across different organisations
placementPolicyId string
(v3.8+) VM placement policy ID.
sizingPolicyId string
(v3.0+, vCD 10.0+) VM sizing policy ID.
vdc string
The name of VDC to use, optional if defined at provider level
name This property is required. str
A name for the VM, unique within the vApp
vapp_name This property is required. str
The vApp this VM belongs to.
id str
network_dhcp_wait_seconds float
Allows to wait for up to a defined amount of seconds before IP address is reported for NICs with ip_allocation_mode=DHCP setting. It constantly checks if IP is reported so the time given is a maximum. VM must be powered on and at least one of the following must be true:

  • VM has guest tools. It waits for IP address to be reported in vCD UI. This is a slower option, but does not require for the VM to use Edge Gateways DHCP service.
  • VM DHCP interface is connected to routed Org network and is using Edge Gateways DHCP service (not relayed). It works by querying DHCP leases on edge gateway. In general it is quicker than waiting until UI reports IP addresses, but is more constrained. However this is the only option if guest tools are not present on the VM.
org str
The name of organization to use, optional if defined at provider level. Useful when connected as sysadmin working across different organisations
placement_policy_id str
(v3.8+) VM placement policy ID.
sizing_policy_id str
(v3.0+, vCD 10.0+) VM sizing policy ID.
vdc str
The name of VDC to use, optional if defined at provider level
name This property is required. String
A name for the VM, unique within the vApp
vappName This property is required. String
The vApp this VM belongs to.
id String
networkDhcpWaitSeconds Number
Allows to wait for up to a defined amount of seconds before IP address is reported for NICs with ip_allocation_mode=DHCP setting. It constantly checks if IP is reported so the time given is a maximum. VM must be powered on and at least one of the following must be true:

  • VM has guest tools. It waits for IP address to be reported in vCD UI. This is a slower option, but does not require for the VM to use Edge Gateways DHCP service.
  • VM DHCP interface is connected to routed Org network and is using Edge Gateways DHCP service (not relayed). It works by querying DHCP leases on edge gateway. In general it is quicker than waiting until UI reports IP addresses, but is more constrained. However this is the only option if guest tools are not present on the VM.
org String
The name of organization to use, optional if defined at provider level. Useful when connected as sysadmin working across different organisations
placementPolicyId String
(v3.8+) VM placement policy ID.
sizingPolicyId String
(v3.0+, vCD 10.0+) VM sizing policy ID.
vdc String
The name of VDC to use, optional if defined at provider level

getVappVm Result

The following output properties are available:

BootOptions List<GetVappVmBootOption>
ComputerName string
Computer name to assign to this virtual machine.
CpuCores double
The number of cores per socket
CpuHotAddEnabled bool
CpuLimit double
The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
CpuPriority string
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
CpuReservation double
The amount of MHz reservation on the underlying virtualization infrastructure
CpuShares double
Custom priority for the resource in MHz
Cpus double
The number of virtual CPUs allocated to the VM
Customizations List<GetVappVmCustomization>
Description string
The VM description. Note: description is read only. Currently, this field has the description of the OVA used to create the VM
Disks List<GetVappVmDisk>
Independent disk attachment configuration.
ExposeHardwareVirtualization bool
Expose hardware-assisted CPU virtualization to guest OS
ExtraConfigs List<GetVappVmExtraConfig>
Firmware string
GuestProperties Dictionary<string, string>
Key value map of guest properties
HardwareVersion string
(v2.9+) Virtual Hardware Version (e.g.vmx-14, vmx-13, vmx-12, etc.).
Href string
Id string
InheritedMetadata Dictionary<string, string>
(v3.11+; VCD 10.5.1+) A map that contains read-only metadata that is automatically added by VCD (10.5.1+) and provides details on the origin of the VM (e.g. vm.origin.id, vm.origin.name, vm.origin.type).
InternalDisks List<GetVappVmInternalDisk>
(v2.7+) A block providing internal disk of VM details
Memory double
The amount of RAM (in MB) allocated to the VM
MemoryHotAddEnabled bool
MemoryLimit double
The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
MemoryPriority string
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
MemoryReservation double
The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
MemoryShares double
Custom priority for the resource in MB
Metadata Dictionary<string, string>
(Deprecated) Use metadata_entry instead. Key value map of metadata assigned to this VM

Deprecated: Deprecated

MetadataEntries List<GetVappVmMetadataEntry>
A set of metadata entries assigned to this VM. See Metadata section for details
Name string
Networks List<GetVappVmNetwork>
A block defining a network interface. Multiple can be used.
OsType string
(v2.9+) Operating System type.
PlacementPolicyId string
(v3.8+) VM placement policy ID.
SecurityTags List<string>
(v3.9+) Set of security tags assigned to this VM.
SizingPolicyId string
(v3.0+, vCD 10.0+) VM sizing policy ID.
Status double
(v3.8+) The vApp status as a numeric code.
StatusText string
(v3.8+) The vApp status as text.
StorageProfile string
VappId string
VappName string
VmType string
(3.2+) - type of the VM (either vcd.VappVm or vcd.Vm)
NetworkDhcpWaitSeconds double
Org string
Vdc string
BootOptions []GetVappVmBootOption
ComputerName string
Computer name to assign to this virtual machine.
CpuCores float64
The number of cores per socket
CpuHotAddEnabled bool
CpuLimit float64
The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
CpuPriority string
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
CpuReservation float64
The amount of MHz reservation on the underlying virtualization infrastructure
CpuShares float64
Custom priority for the resource in MHz
Cpus float64
The number of virtual CPUs allocated to the VM
Customizations []GetVappVmCustomization
Description string
The VM description. Note: description is read only. Currently, this field has the description of the OVA used to create the VM
Disks []GetVappVmDisk
Independent disk attachment configuration.
ExposeHardwareVirtualization bool
Expose hardware-assisted CPU virtualization to guest OS
ExtraConfigs []GetVappVmExtraConfig
Firmware string
GuestProperties map[string]string
Key value map of guest properties
HardwareVersion string
(v2.9+) Virtual Hardware Version (e.g.vmx-14, vmx-13, vmx-12, etc.).
Href string
Id string
InheritedMetadata map[string]string
(v3.11+; VCD 10.5.1+) A map that contains read-only metadata that is automatically added by VCD (10.5.1+) and provides details on the origin of the VM (e.g. vm.origin.id, vm.origin.name, vm.origin.type).
InternalDisks []GetVappVmInternalDisk
(v2.7+) A block providing internal disk of VM details
Memory float64
The amount of RAM (in MB) allocated to the VM
MemoryHotAddEnabled bool
MemoryLimit float64
The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
MemoryPriority string
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
MemoryReservation float64
The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
MemoryShares float64
Custom priority for the resource in MB
Metadata map[string]string
(Deprecated) Use metadata_entry instead. Key value map of metadata assigned to this VM

Deprecated: Deprecated

MetadataEntries []GetVappVmMetadataEntry
A set of metadata entries assigned to this VM. See Metadata section for details
Name string
Networks []GetVappVmNetwork
A block defining a network interface. Multiple can be used.
OsType string
(v2.9+) Operating System type.
PlacementPolicyId string
(v3.8+) VM placement policy ID.
SecurityTags []string
(v3.9+) Set of security tags assigned to this VM.
SizingPolicyId string
(v3.0+, vCD 10.0+) VM sizing policy ID.
Status float64
(v3.8+) The vApp status as a numeric code.
StatusText string
(v3.8+) The vApp status as text.
StorageProfile string
VappId string
VappName string
VmType string
(3.2+) - type of the VM (either vcd.VappVm or vcd.Vm)
NetworkDhcpWaitSeconds float64
Org string
Vdc string
bootOptions List<GetVappVmBootOption>
computerName String
Computer name to assign to this virtual machine.
cpuCores Double
The number of cores per socket
cpuHotAddEnabled Boolean
cpuLimit Double
The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
cpuPriority String
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
cpuReservation Double
The amount of MHz reservation on the underlying virtualization infrastructure
cpuShares Double
Custom priority for the resource in MHz
cpus Double
The number of virtual CPUs allocated to the VM
customizations List<GetVappVmCustomization>
description String
The VM description. Note: description is read only. Currently, this field has the description of the OVA used to create the VM
disks List<GetVappVmDisk>
Independent disk attachment configuration.
exposeHardwareVirtualization Boolean
Expose hardware-assisted CPU virtualization to guest OS
extraConfigs List<GetVappVmExtraConfig>
firmware String
guestProperties Map<String,String>
Key value map of guest properties
hardwareVersion String
(v2.9+) Virtual Hardware Version (e.g.vmx-14, vmx-13, vmx-12, etc.).
href String
id String
inheritedMetadata Map<String,String>
(v3.11+; VCD 10.5.1+) A map that contains read-only metadata that is automatically added by VCD (10.5.1+) and provides details on the origin of the VM (e.g. vm.origin.id, vm.origin.name, vm.origin.type).
internalDisks List<GetVappVmInternalDisk>
(v2.7+) A block providing internal disk of VM details
memory Double
The amount of RAM (in MB) allocated to the VM
memoryHotAddEnabled Boolean
memoryLimit Double
The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
memoryPriority String
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
memoryReservation Double
The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
memoryShares Double
Custom priority for the resource in MB
metadata Map<String,String>
(Deprecated) Use metadata_entry instead. Key value map of metadata assigned to this VM

Deprecated: Deprecated

metadataEntries List<GetVappVmMetadataEntry>
A set of metadata entries assigned to this VM. See Metadata section for details
name String
networks List<GetVappVmNetwork>
A block defining a network interface. Multiple can be used.
osType String
(v2.9+) Operating System type.
placementPolicyId String
(v3.8+) VM placement policy ID.
securityTags List<String>
(v3.9+) Set of security tags assigned to this VM.
sizingPolicyId String
(v3.0+, vCD 10.0+) VM sizing policy ID.
status Double
(v3.8+) The vApp status as a numeric code.
statusText String
(v3.8+) The vApp status as text.
storageProfile String
vappId String
vappName String
vmType String
(3.2+) - type of the VM (either vcd.VappVm or vcd.Vm)
networkDhcpWaitSeconds Double
org String
vdc String
bootOptions GetVappVmBootOption[]
computerName string
Computer name to assign to this virtual machine.
cpuCores number
The number of cores per socket
cpuHotAddEnabled boolean
cpuLimit number
The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
cpuPriority string
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
cpuReservation number
The amount of MHz reservation on the underlying virtualization infrastructure
cpuShares number
Custom priority for the resource in MHz
cpus number
The number of virtual CPUs allocated to the VM
customizations GetVappVmCustomization[]
description string
The VM description. Note: description is read only. Currently, this field has the description of the OVA used to create the VM
disks GetVappVmDisk[]
Independent disk attachment configuration.
exposeHardwareVirtualization boolean
Expose hardware-assisted CPU virtualization to guest OS
extraConfigs GetVappVmExtraConfig[]
firmware string
guestProperties {[key: string]: string}
Key value map of guest properties
hardwareVersion string
(v2.9+) Virtual Hardware Version (e.g.vmx-14, vmx-13, vmx-12, etc.).
href string
id string
inheritedMetadata {[key: string]: string}
(v3.11+; VCD 10.5.1+) A map that contains read-only metadata that is automatically added by VCD (10.5.1+) and provides details on the origin of the VM (e.g. vm.origin.id, vm.origin.name, vm.origin.type).
internalDisks GetVappVmInternalDisk[]
(v2.7+) A block providing internal disk of VM details
memory number
The amount of RAM (in MB) allocated to the VM
memoryHotAddEnabled boolean
memoryLimit number
The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
memoryPriority string
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
memoryReservation number
The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
memoryShares number
Custom priority for the resource in MB
metadata {[key: string]: string}
(Deprecated) Use metadata_entry instead. Key value map of metadata assigned to this VM

Deprecated: Deprecated

metadataEntries GetVappVmMetadataEntry[]
A set of metadata entries assigned to this VM. See Metadata section for details
name string
networks GetVappVmNetwork[]
A block defining a network interface. Multiple can be used.
osType string
(v2.9+) Operating System type.
placementPolicyId string
(v3.8+) VM placement policy ID.
securityTags string[]
(v3.9+) Set of security tags assigned to this VM.
sizingPolicyId string
(v3.0+, vCD 10.0+) VM sizing policy ID.
status number
(v3.8+) The vApp status as a numeric code.
statusText string
(v3.8+) The vApp status as text.
storageProfile string
vappId string
vappName string
vmType string
(3.2+) - type of the VM (either vcd.VappVm or vcd.Vm)
networkDhcpWaitSeconds number
org string
vdc string
boot_options Sequence[GetVappVmBootOption]
computer_name str
Computer name to assign to this virtual machine.
cpu_cores float
The number of cores per socket
cpu_hot_add_enabled bool
cpu_limit float
The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
cpu_priority str
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
cpu_reservation float
The amount of MHz reservation on the underlying virtualization infrastructure
cpu_shares float
Custom priority for the resource in MHz
cpus float
The number of virtual CPUs allocated to the VM
customizations Sequence[GetVappVmCustomization]
description str
The VM description. Note: description is read only. Currently, this field has the description of the OVA used to create the VM
disks Sequence[GetVappVmDisk]
Independent disk attachment configuration.
expose_hardware_virtualization bool
Expose hardware-assisted CPU virtualization to guest OS
extra_configs Sequence[GetVappVmExtraConfig]
firmware str
guest_properties Mapping[str, str]
Key value map of guest properties
hardware_version str
(v2.9+) Virtual Hardware Version (e.g.vmx-14, vmx-13, vmx-12, etc.).
href str
id str
inherited_metadata Mapping[str, str]
(v3.11+; VCD 10.5.1+) A map that contains read-only metadata that is automatically added by VCD (10.5.1+) and provides details on the origin of the VM (e.g. vm.origin.id, vm.origin.name, vm.origin.type).
internal_disks Sequence[GetVappVmInternalDisk]
(v2.7+) A block providing internal disk of VM details
memory float
The amount of RAM (in MB) allocated to the VM
memory_hot_add_enabled bool
memory_limit float
The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
memory_priority str
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
memory_reservation float
The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
memory_shares float
Custom priority for the resource in MB
metadata Mapping[str, str]
(Deprecated) Use metadata_entry instead. Key value map of metadata assigned to this VM

Deprecated: Deprecated

metadata_entries Sequence[GetVappVmMetadataEntry]
A set of metadata entries assigned to this VM. See Metadata section for details
name str
networks Sequence[GetVappVmNetwork]
A block defining a network interface. Multiple can be used.
os_type str
(v2.9+) Operating System type.
placement_policy_id str
(v3.8+) VM placement policy ID.
security_tags Sequence[str]
(v3.9+) Set of security tags assigned to this VM.
sizing_policy_id str
(v3.0+, vCD 10.0+) VM sizing policy ID.
status float
(v3.8+) The vApp status as a numeric code.
status_text str
(v3.8+) The vApp status as text.
storage_profile str
vapp_id str
vapp_name str
vm_type str
(3.2+) - type of the VM (either vcd.VappVm or vcd.Vm)
network_dhcp_wait_seconds float
org str
vdc str
bootOptions List<Property Map>
computerName String
Computer name to assign to this virtual machine.
cpuCores Number
The number of cores per socket
cpuHotAddEnabled Boolean
cpuLimit Number
The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
cpuPriority String
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
cpuReservation Number
The amount of MHz reservation on the underlying virtualization infrastructure
cpuShares Number
Custom priority for the resource in MHz
cpus Number
The number of virtual CPUs allocated to the VM
customizations List<Property Map>
description String
The VM description. Note: description is read only. Currently, this field has the description of the OVA used to create the VM
disks List<Property Map>
Independent disk attachment configuration.
exposeHardwareVirtualization Boolean
Expose hardware-assisted CPU virtualization to guest OS
extraConfigs List<Property Map>
firmware String
guestProperties Map<String>
Key value map of guest properties
hardwareVersion String
(v2.9+) Virtual Hardware Version (e.g.vmx-14, vmx-13, vmx-12, etc.).
href String
id String
inheritedMetadata Map<String>
(v3.11+; VCD 10.5.1+) A map that contains read-only metadata that is automatically added by VCD (10.5.1+) and provides details on the origin of the VM (e.g. vm.origin.id, vm.origin.name, vm.origin.type).
internalDisks List<Property Map>
(v2.7+) A block providing internal disk of VM details
memory Number
The amount of RAM (in MB) allocated to the VM
memoryHotAddEnabled Boolean
memoryLimit Number
The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure. -1 value for unlimited.
memoryPriority String
Pre-determined relative priorities according to which the non-reserved portion of this resource is made available to the virtualized workload. Values can be: LOW, NORMAL, HIGH and CUSTOM
memoryReservation Number
The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
memoryShares Number
Custom priority for the resource in MB
metadata Map<String>
(Deprecated) Use metadata_entry instead. Key value map of metadata assigned to this VM

Deprecated: Deprecated

metadataEntries List<Property Map>
A set of metadata entries assigned to this VM. See Metadata section for details
name String
networks List<Property Map>
A block defining a network interface. Multiple can be used.
osType String
(v2.9+) Operating System type.
placementPolicyId String
(v3.8+) VM placement policy ID.
securityTags List<String>
(v3.9+) Set of security tags assigned to this VM.
sizingPolicyId String
(v3.0+, vCD 10.0+) VM sizing policy ID.
status Number
(v3.8+) The vApp status as a numeric code.
statusText String
(v3.8+) The vApp status as text.
storageProfile String
vappId String
vappName String
vmType String
(3.2+) - type of the VM (either vcd.VappVm or vcd.Vm)
networkDhcpWaitSeconds Number
org String
vdc String

Supporting Types

GetVappVmBootOption

BootDelay This property is required. double
BootRetryDelay This property is required. double
BootRetryEnabled This property is required. bool
EfiSecureBoot This property is required. bool
EnterBiosSetupOnNextBoot This property is required. bool
BootDelay This property is required. float64
BootRetryDelay This property is required. float64
BootRetryEnabled This property is required. bool
EfiSecureBoot This property is required. bool
EnterBiosSetupOnNextBoot This property is required. bool
bootDelay This property is required. Double
bootRetryDelay This property is required. Double
bootRetryEnabled This property is required. Boolean
efiSecureBoot This property is required. Boolean
enterBiosSetupOnNextBoot This property is required. Boolean
bootDelay This property is required. number
bootRetryDelay This property is required. number
bootRetryEnabled This property is required. boolean
efiSecureBoot This property is required. boolean
enterBiosSetupOnNextBoot This property is required. boolean
boot_delay This property is required. float
boot_retry_delay This property is required. float
boot_retry_enabled This property is required. bool
efi_secure_boot This property is required. bool
enter_bios_setup_on_next_boot This property is required. bool
bootDelay This property is required. Number
bootRetryDelay This property is required. Number
bootRetryEnabled This property is required. Boolean
efiSecureBoot This property is required. Boolean
enterBiosSetupOnNextBoot This property is required. Boolean

GetVappVmCustomization

AdminPassword This property is required. string
AllowLocalAdminPassword This property is required. bool
AutoGeneratePassword This property is required. bool
ChangeSid This property is required. bool
Enabled This property is required. bool
Force This property is required. bool
Initscript This property is required. string
JoinDomain This property is required. bool
JoinDomainAccountOu This property is required. string
JoinDomainName This property is required. string
JoinDomainPassword This property is required. string
JoinDomainUser This property is required. string
JoinOrgDomain This property is required. bool
MustChangePasswordOnFirstLogin This property is required. bool
NumberOfAutoLogons This property is required. double
AdminPassword This property is required. string
AllowLocalAdminPassword This property is required. bool
AutoGeneratePassword This property is required. bool
ChangeSid This property is required. bool
Enabled This property is required. bool
Force This property is required. bool
Initscript This property is required. string
JoinDomain This property is required. bool
JoinDomainAccountOu This property is required. string
JoinDomainName This property is required. string
JoinDomainPassword This property is required. string
JoinDomainUser This property is required. string
JoinOrgDomain This property is required. bool
MustChangePasswordOnFirstLogin This property is required. bool
NumberOfAutoLogons This property is required. float64
adminPassword This property is required. String
allowLocalAdminPassword This property is required. Boolean
autoGeneratePassword This property is required. Boolean
changeSid This property is required. Boolean
enabled This property is required. Boolean
force This property is required. Boolean
initscript This property is required. String
joinDomain This property is required. Boolean
joinDomainAccountOu This property is required. String
joinDomainName This property is required. String
joinDomainPassword This property is required. String
joinDomainUser This property is required. String
joinOrgDomain This property is required. Boolean
mustChangePasswordOnFirstLogin This property is required. Boolean
numberOfAutoLogons This property is required. Double
adminPassword This property is required. string
allowLocalAdminPassword This property is required. boolean
autoGeneratePassword This property is required. boolean
changeSid This property is required. boolean
enabled This property is required. boolean
force This property is required. boolean
initscript This property is required. string
joinDomain This property is required. boolean
joinDomainAccountOu This property is required. string
joinDomainName This property is required. string
joinDomainPassword This property is required. string
joinDomainUser This property is required. string
joinOrgDomain This property is required. boolean
mustChangePasswordOnFirstLogin This property is required. boolean
numberOfAutoLogons This property is required. number
admin_password This property is required. str
allow_local_admin_password This property is required. bool
auto_generate_password This property is required. bool
change_sid This property is required. bool
enabled This property is required. bool
force This property is required. bool
initscript This property is required. str
join_domain This property is required. bool
join_domain_account_ou This property is required. str
join_domain_name This property is required. str
join_domain_password This property is required. str
join_domain_user This property is required. str
join_org_domain This property is required. bool
must_change_password_on_first_login This property is required. bool
number_of_auto_logons This property is required. float
adminPassword This property is required. String
allowLocalAdminPassword This property is required. Boolean
autoGeneratePassword This property is required. Boolean
changeSid This property is required. Boolean
enabled This property is required. Boolean
force This property is required. Boolean
initscript This property is required. String
joinDomain This property is required. Boolean
joinDomainAccountOu This property is required. String
joinDomainName This property is required. String
joinDomainPassword This property is required. String
joinDomainUser This property is required. String
joinOrgDomain This property is required. Boolean
mustChangePasswordOnFirstLogin This property is required. Boolean
numberOfAutoLogons This property is required. Number

GetVappVmDisk

BusNumber This property is required. string
Name This property is required. string
A name for the VM, unique within the vApp
SizeInMb This property is required. double
UnitNumber This property is required. string
BusNumber This property is required. string
Name This property is required. string
A name for the VM, unique within the vApp
SizeInMb This property is required. float64
UnitNumber This property is required. string
busNumber This property is required. String
name This property is required. String
A name for the VM, unique within the vApp
sizeInMb This property is required. Double
unitNumber This property is required. String
busNumber This property is required. string
name This property is required. string
A name for the VM, unique within the vApp
sizeInMb This property is required. number
unitNumber This property is required. string
bus_number This property is required. str
name This property is required. str
A name for the VM, unique within the vApp
size_in_mb This property is required. float
unit_number This property is required. str
busNumber This property is required. String
name This property is required. String
A name for the VM, unique within the vApp
sizeInMb This property is required. Number
unitNumber This property is required. String

GetVappVmExtraConfig

Key This property is required. string
Required This property is required. bool
Value This property is required. string
Key This property is required. string
Required This property is required. bool
Value This property is required. string
key This property is required. String
required This property is required. Boolean
value This property is required. String
key This property is required. string
required This property is required. boolean
value This property is required. string
key This property is required. str
required This property is required. bool
value This property is required. str
key This property is required. String
required This property is required. Boolean
value This property is required. String

GetVappVmInternalDisk

BusNumber This property is required. double
BusType This property is required. string
DiskId This property is required. string
Iops This property is required. double
SizeInMb This property is required. double
StorageProfile This property is required. string
ThinProvisioned This property is required. bool
UnitNumber This property is required. double
BusNumber This property is required. float64
BusType This property is required. string
DiskId This property is required. string
Iops This property is required. float64
SizeInMb This property is required. float64
StorageProfile This property is required. string
ThinProvisioned This property is required. bool
UnitNumber This property is required. float64
busNumber This property is required. Double
busType This property is required. String
diskId This property is required. String
iops This property is required. Double
sizeInMb This property is required. Double
storageProfile This property is required. String
thinProvisioned This property is required. Boolean
unitNumber This property is required. Double
busNumber This property is required. number
busType This property is required. string
diskId This property is required. string
iops This property is required. number
sizeInMb This property is required. number
storageProfile This property is required. string
thinProvisioned This property is required. boolean
unitNumber This property is required. number
bus_number This property is required. float
bus_type This property is required. str
disk_id This property is required. str
iops This property is required. float
size_in_mb This property is required. float
storage_profile This property is required. str
thin_provisioned This property is required. bool
unit_number This property is required. float
busNumber This property is required. Number
busType This property is required. String
diskId This property is required. String
iops This property is required. Number
sizeInMb This property is required. Number
storageProfile This property is required. String
thinProvisioned This property is required. Boolean
unitNumber This property is required. Number

GetVappVmMetadataEntry

IsSystem This property is required. bool
Key This property is required. string
Type This property is required. string
UserAccess This property is required. string
Value This property is required. string
IsSystem This property is required. bool
Key This property is required. string
Type This property is required. string
UserAccess This property is required. string
Value This property is required. string
isSystem This property is required. Boolean
key This property is required. String
type This property is required. String
userAccess This property is required. String
value This property is required. String
isSystem This property is required. boolean
key This property is required. string
type This property is required. string
userAccess This property is required. string
value This property is required. string
is_system This property is required. bool
key This property is required. str
type This property is required. str
user_access This property is required. str
value This property is required. str
isSystem This property is required. Boolean
key This property is required. String
type This property is required. String
userAccess This property is required. String
value This property is required. String

GetVappVmNetwork

AdapterType This property is required. string
Connected This property is required. bool
Ip This property is required. string
IpAllocationMode This property is required. string
IsPrimary This property is required. bool
Mac This property is required. string
Name This property is required. string
A name for the VM, unique within the vApp
SecondaryIp This property is required. string
SecondaryIpAllocationMode This property is required. string
Type This property is required. string
AdapterType This property is required. string
Connected This property is required. bool
Ip This property is required. string
IpAllocationMode This property is required. string
IsPrimary This property is required. bool
Mac This property is required. string
Name This property is required. string
A name for the VM, unique within the vApp
SecondaryIp This property is required. string
SecondaryIpAllocationMode This property is required. string
Type This property is required. string
adapterType This property is required. String
connected This property is required. Boolean
ip This property is required. String
ipAllocationMode This property is required. String
isPrimary This property is required. Boolean
mac This property is required. String
name This property is required. String
A name for the VM, unique within the vApp
secondaryIp This property is required. String
secondaryIpAllocationMode This property is required. String
type This property is required. String
adapterType This property is required. string
connected This property is required. boolean
ip This property is required. string
ipAllocationMode This property is required. string
isPrimary This property is required. boolean
mac This property is required. string
name This property is required. string
A name for the VM, unique within the vApp
secondaryIp This property is required. string
secondaryIpAllocationMode This property is required. string
type This property is required. string
adapter_type This property is required. str
connected This property is required. bool
ip This property is required. str
ip_allocation_mode This property is required. str
is_primary This property is required. bool
mac This property is required. str
name This property is required. str
A name for the VM, unique within the vApp
secondary_ip This property is required. str
secondary_ip_allocation_mode This property is required. str
type This property is required. str
adapterType This property is required. String
connected This property is required. Boolean
ip This property is required. String
ipAllocationMode This property is required. String
isPrimary This property is required. Boolean
mac This property is required. String
name This property is required. String
A name for the VM, unique within the vApp
secondaryIp This property is required. String
secondaryIpAllocationMode This property is required. String
type This property is required. String

Package Details

Repository
vcd vmware/terraform-provider-vcd
License
Notes
This Pulumi package is based on the vcd Terraform Provider.