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;
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)
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
})
}
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,
};
});
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));
}
}
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}
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 toSYSTEM
, false if it belongs toGENERAL
.
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>
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]
func LookupVappVm(ctx *Context, args *LookupVappVmArgs, opts ...InvokeOption) (*LookupVappVmResult, error)
func LookupVappVmOutput(ctx *Context, args *LookupVappVmOutputArgs, opts ...InvokeOption) LookupVappVmResultOutput
> 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)
}
public static CompletableFuture<GetVappVmResult> getVappVm(GetVappVmArgs args, InvokeOptions options)
public static Output<GetVappVmResult> getVappVm(GetVappVmArgs args, InvokeOptions options)
fn::invoke:
function: vcd:index/getVappVm:getVappVm
arguments:
# arguments dictionary
The following arguments are supported:
- Name string
- A name for the VM, unique within the vApp
- Vapp
Name string - The vApp this VM belongs to.
- Id string
- Network
Dhcp doubleWait Seconds - 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
- Placement
Policy stringId - (v3.8+) VM placement policy ID.
- Sizing
Policy stringId - (v3.0+, vCD 10.0+) VM sizing policy ID.
- Vdc string
- The name of VDC to use, optional if defined at provider level
- Name string
- A name for the VM, unique within the vApp
- Vapp
Name string - The vApp this VM belongs to.
- Id string
- Network
Dhcp float64Wait Seconds - 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
- Placement
Policy stringId - (v3.8+) VM placement policy ID.
- Sizing
Policy stringId - (v3.0+, vCD 10.0+) VM sizing policy ID.
- Vdc string
- The name of VDC to use, optional if defined at provider level
- name String
- A name for the VM, unique within the vApp
- vapp
Name String - The vApp this VM belongs to.
- id String
- network
Dhcp DoubleWait Seconds - 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
- placement
Policy StringId - (v3.8+) VM placement policy ID.
- sizing
Policy StringId - (v3.0+, vCD 10.0+) VM sizing policy ID.
- vdc String
- The name of VDC to use, optional if defined at provider level
- name string
- A name for the VM, unique within the vApp
- vapp
Name string - The vApp this VM belongs to.
- id string
- network
Dhcp numberWait Seconds - 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
- placement
Policy stringId - (v3.8+) VM placement policy ID.
- sizing
Policy stringId - (v3.0+, vCD 10.0+) VM sizing policy ID.
- vdc string
- The name of VDC to use, optional if defined at provider level
- name str
- A name for the VM, unique within the vApp
- vapp_
name str - The vApp this VM belongs to.
- id str
- network_
dhcp_ floatwait_ seconds - 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_ strid - (v3.8+) VM placement policy ID.
- sizing_
policy_ strid - (v3.0+, vCD 10.0+) VM sizing policy ID.
- vdc str
- The name of VDC to use, optional if defined at provider level
- name String
- A name for the VM, unique within the vApp
- vapp
Name String - The vApp this VM belongs to.
- id String
- network
Dhcp NumberWait Seconds - 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
- placement
Policy StringId - (v3.8+) VM placement policy ID.
- sizing
Policy StringId - (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:
- Boot
Options List<GetVapp Vm Boot Option> - Computer
Name string - Computer name to assign to this virtual machine.
- Cpu
Cores double - The number of cores per socket
- Cpu
Hot boolAdd Enabled - Cpu
Limit double - The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure.
-1
value for unlimited. - Cpu
Priority 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
andCUSTOM
- Cpu
Reservation double - The amount of MHz reservation on the underlying virtualization infrastructure
- double
- Custom priority for the resource in MHz
- Cpus double
- The number of virtual CPUs allocated to the VM
- Customizations
List<Get
Vapp Vm Customization> - 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<Get
Vapp Vm Disk> - Independent disk attachment configuration.
- Expose
Hardware boolVirtualization - Expose hardware-assisted CPU virtualization to guest OS
- Extra
Configs List<GetVapp Vm Extra Config> - Firmware string
- Guest
Properties Dictionary<string, string> - Key value map of guest properties
- Hardware
Version string - (v2.9+) Virtual Hardware Version (e.g.
vmx-14
,vmx-13
,vmx-12
, etc.). - Href string
- Id string
- Inherited
Metadata 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
). - Internal
Disks List<GetVapp Vm Internal Disk> - (v2.7+) A block providing internal disk of VM details
- Memory double
- The amount of RAM (in MB) allocated to the VM
- Memory
Hot boolAdd Enabled - Memory
Limit double - The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure.
-1
value for unlimited. - Memory
Priority 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
andCUSTOM
- Memory
Reservation double - The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
- 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 - Metadata
Entries List<GetVapp Vm Metadata Entry> - A set of metadata entries assigned to this VM. See Metadata section for details
- Name string
- Networks
List<Get
Vapp Vm Network> - A block defining a network interface. Multiple can be used.
- Os
Type string - (v2.9+) Operating System type.
- Placement
Policy stringId - (v3.8+) VM placement policy ID.
- List<string>
- (v3.9+) Set of security tags assigned to this VM.
- Sizing
Policy stringId - (v3.0+, vCD 10.0+) VM sizing policy ID.
- Status double
- (v3.8+) The vApp status as a numeric code.
- Status
Text string - (v3.8+) The vApp status as text.
- Storage
Profile string - Vapp
Id string - Vapp
Name string - Vm
Type string - (3.2+) - type of the VM (either
vcd.VappVm
orvcd.Vm
) - Network
Dhcp doubleWait Seconds - Org string
- Vdc string
- Boot
Options []GetVapp Vm Boot Option - Computer
Name string - Computer name to assign to this virtual machine.
- Cpu
Cores float64 - The number of cores per socket
- Cpu
Hot boolAdd Enabled - Cpu
Limit float64 - The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure.
-1
value for unlimited. - Cpu
Priority 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
andCUSTOM
- Cpu
Reservation float64 - The amount of MHz reservation on the underlying virtualization infrastructure
- float64
- Custom priority for the resource in MHz
- Cpus float64
- The number of virtual CPUs allocated to the VM
- Customizations
[]Get
Vapp Vm Customization - 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
[]Get
Vapp Vm Disk - Independent disk attachment configuration.
- Expose
Hardware boolVirtualization - Expose hardware-assisted CPU virtualization to guest OS
- Extra
Configs []GetVapp Vm Extra Config - Firmware string
- Guest
Properties map[string]string - Key value map of guest properties
- Hardware
Version string - (v2.9+) Virtual Hardware Version (e.g.
vmx-14
,vmx-13
,vmx-12
, etc.). - Href string
- Id string
- Inherited
Metadata 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
). - Internal
Disks []GetVapp Vm Internal Disk - (v2.7+) A block providing internal disk of VM details
- Memory float64
- The amount of RAM (in MB) allocated to the VM
- Memory
Hot boolAdd Enabled - Memory
Limit float64 - The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure.
-1
value for unlimited. - Memory
Priority 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
andCUSTOM
- Memory
Reservation float64 - The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
- 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 - Metadata
Entries []GetVapp Vm Metadata Entry - A set of metadata entries assigned to this VM. See Metadata section for details
- Name string
- Networks
[]Get
Vapp Vm Network - A block defining a network interface. Multiple can be used.
- Os
Type string - (v2.9+) Operating System type.
- Placement
Policy stringId - (v3.8+) VM placement policy ID.
- []string
- (v3.9+) Set of security tags assigned to this VM.
- Sizing
Policy stringId - (v3.0+, vCD 10.0+) VM sizing policy ID.
- Status float64
- (v3.8+) The vApp status as a numeric code.
- Status
Text string - (v3.8+) The vApp status as text.
- Storage
Profile string - Vapp
Id string - Vapp
Name string - Vm
Type string - (3.2+) - type of the VM (either
vcd.VappVm
orvcd.Vm
) - Network
Dhcp float64Wait Seconds - Org string
- Vdc string
- boot
Options List<GetVapp Vm Boot Option> - computer
Name String - Computer name to assign to this virtual machine.
- cpu
Cores Double - The number of cores per socket
- cpu
Hot BooleanAdd Enabled - cpu
Limit Double - The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure.
-1
value for unlimited. - cpu
Priority 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
andCUSTOM
- cpu
Reservation Double - The amount of MHz reservation on the underlying virtualization infrastructure
- Double
- Custom priority for the resource in MHz
- cpus Double
- The number of virtual CPUs allocated to the VM
- customizations
List<Get
Vapp Vm Customization> - 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<Get
Vapp Vm Disk> - Independent disk attachment configuration.
- expose
Hardware BooleanVirtualization - Expose hardware-assisted CPU virtualization to guest OS
- extra
Configs List<GetVapp Vm Extra Config> - firmware String
- guest
Properties Map<String,String> - Key value map of guest properties
- hardware
Version String - (v2.9+) Virtual Hardware Version (e.g.
vmx-14
,vmx-13
,vmx-12
, etc.). - href String
- id String
- inherited
Metadata 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
). - internal
Disks List<GetVapp Vm Internal Disk> - (v2.7+) A block providing internal disk of VM details
- memory Double
- The amount of RAM (in MB) allocated to the VM
- memory
Hot BooleanAdd Enabled - memory
Limit Double - The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure.
-1
value for unlimited. - memory
Priority 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
andCUSTOM
- memory
Reservation Double - The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
- 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 - metadata
Entries List<GetVapp Vm Metadata Entry> - A set of metadata entries assigned to this VM. See Metadata section for details
- name String
- networks
List<Get
Vapp Vm Network> - A block defining a network interface. Multiple can be used.
- os
Type String - (v2.9+) Operating System type.
- placement
Policy StringId - (v3.8+) VM placement policy ID.
- List<String>
- (v3.9+) Set of security tags assigned to this VM.
- sizing
Policy StringId - (v3.0+, vCD 10.0+) VM sizing policy ID.
- status Double
- (v3.8+) The vApp status as a numeric code.
- status
Text String - (v3.8+) The vApp status as text.
- storage
Profile String - vapp
Id String - vapp
Name String - vm
Type String - (3.2+) - type of the VM (either
vcd.VappVm
orvcd.Vm
) - network
Dhcp DoubleWait Seconds - org String
- vdc String
- boot
Options GetVapp Vm Boot Option[] - computer
Name string - Computer name to assign to this virtual machine.
- cpu
Cores number - The number of cores per socket
- cpu
Hot booleanAdd Enabled - cpu
Limit number - The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure.
-1
value for unlimited. - cpu
Priority 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
andCUSTOM
- cpu
Reservation number - The amount of MHz reservation on the underlying virtualization infrastructure
- number
- Custom priority for the resource in MHz
- cpus number
- The number of virtual CPUs allocated to the VM
- customizations
Get
Vapp Vm Customization[] - 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
Get
Vapp Vm Disk[] - Independent disk attachment configuration.
- expose
Hardware booleanVirtualization - Expose hardware-assisted CPU virtualization to guest OS
- extra
Configs GetVapp Vm Extra Config[] - firmware string
- guest
Properties {[key: string]: string} - Key value map of guest properties
- hardware
Version string - (v2.9+) Virtual Hardware Version (e.g.
vmx-14
,vmx-13
,vmx-12
, etc.). - href string
- id string
- inherited
Metadata {[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
). - internal
Disks GetVapp Vm Internal Disk[] - (v2.7+) A block providing internal disk of VM details
- memory number
- The amount of RAM (in MB) allocated to the VM
- memory
Hot booleanAdd Enabled - memory
Limit number - The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure.
-1
value for unlimited. - memory
Priority 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
andCUSTOM
- memory
Reservation number - The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
- 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 - metadata
Entries GetVapp Vm Metadata Entry[] - A set of metadata entries assigned to this VM. See Metadata section for details
- name string
- networks
Get
Vapp Vm Network[] - A block defining a network interface. Multiple can be used.
- os
Type string - (v2.9+) Operating System type.
- placement
Policy stringId - (v3.8+) VM placement policy ID.
- string[]
- (v3.9+) Set of security tags assigned to this VM.
- sizing
Policy stringId - (v3.0+, vCD 10.0+) VM sizing policy ID.
- status number
- (v3.8+) The vApp status as a numeric code.
- status
Text string - (v3.8+) The vApp status as text.
- storage
Profile string - vapp
Id string - vapp
Name string - vm
Type string - (3.2+) - type of the VM (either
vcd.VappVm
orvcd.Vm
) - network
Dhcp numberWait Seconds - org string
- vdc string
- boot_
options Sequence[GetVapp Vm Boot Option] - computer_
name str - Computer name to assign to this virtual machine.
- cpu_
cores float - The number of cores per socket
- cpu_
hot_ booladd_ enabled - 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
andCUSTOM
- cpu_
reservation float - The amount of MHz reservation on the underlying virtualization infrastructure
- float
- Custom priority for the resource in MHz
- cpus float
- The number of virtual CPUs allocated to the VM
- customizations
Sequence[Get
Vapp Vm Customization] - 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[Get
Vapp Vm Disk] - Independent disk attachment configuration.
- expose_
hardware_ boolvirtualization - Expose hardware-assisted CPU virtualization to guest OS
- extra_
configs Sequence[GetVapp Vm Extra Config] - 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[GetVapp Vm Internal Disk] - (v2.7+) A block providing internal disk of VM details
- memory float
- The amount of RAM (in MB) allocated to the VM
- memory_
hot_ booladd_ enabled - 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
andCUSTOM
- memory_
reservation float - The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
- 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 - metadata_
entries Sequence[GetVapp Vm Metadata Entry] - A set of metadata entries assigned to this VM. See Metadata section for details
- name str
- networks
Sequence[Get
Vapp Vm Network] - A block defining a network interface. Multiple can be used.
- os_
type str - (v2.9+) Operating System type.
- placement_
policy_ strid - (v3.8+) VM placement policy ID.
- Sequence[str]
- (v3.9+) Set of security tags assigned to this VM.
- sizing_
policy_ strid - (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
orvcd.Vm
) - network_
dhcp_ floatwait_ seconds - org str
- vdc str
- boot
Options List<Property Map> - computer
Name String - Computer name to assign to this virtual machine.
- cpu
Cores Number - The number of cores per socket
- cpu
Hot BooleanAdd Enabled - cpu
Limit Number - The limit (in MHz) for how much of CPU can be consumed on the underlying virtualization infrastructure.
-1
value for unlimited. - cpu
Priority 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
andCUSTOM
- cpu
Reservation Number - The amount of MHz reservation on the underlying virtualization infrastructure
- 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.
- expose
Hardware BooleanVirtualization - Expose hardware-assisted CPU virtualization to guest OS
- extra
Configs List<Property Map> - firmware String
- guest
Properties Map<String> - Key value map of guest properties
- hardware
Version String - (v2.9+) Virtual Hardware Version (e.g.
vmx-14
,vmx-13
,vmx-12
, etc.). - href String
- id String
- inherited
Metadata 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
). - internal
Disks 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
- memory
Hot BooleanAdd Enabled - memory
Limit Number - The limit (in MB) for how much of memory can be consumed on the underlying virtualization infrastructure.
-1
value for unlimited. - memory
Priority 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
andCUSTOM
- memory
Reservation Number - The amount of RAM (in MB) reservation on the underlying virtualization infrastructure
- 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 - metadata
Entries 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.
- os
Type String - (v2.9+) Operating System type.
- placement
Policy StringId - (v3.8+) VM placement policy ID.
- List<String>
- (v3.9+) Set of security tags assigned to this VM.
- sizing
Policy StringId - (v3.0+, vCD 10.0+) VM sizing policy ID.
- status Number
- (v3.8+) The vApp status as a numeric code.
- status
Text String - (v3.8+) The vApp status as text.
- storage
Profile String - vapp
Id String - vapp
Name String - vm
Type String - (3.2+) - type of the VM (either
vcd.VappVm
orvcd.Vm
) - network
Dhcp NumberWait Seconds - org String
- vdc String
Supporting Types
GetVappVmBootOption
- Boot
Delay double - Boot
Retry doubleDelay - Boot
Retry boolEnabled - Efi
Secure boolBoot - Enter
Bios boolSetup On Next Boot
- Boot
Delay float64 - Boot
Retry float64Delay - Boot
Retry boolEnabled - Efi
Secure boolBoot - Enter
Bios boolSetup On Next Boot
- boot
Delay Double - boot
Retry DoubleDelay - boot
Retry BooleanEnabled - efi
Secure BooleanBoot - enter
Bios BooleanSetup On Next Boot
- boot
Delay number - boot
Retry numberDelay - boot
Retry booleanEnabled - efi
Secure booleanBoot - enter
Bios booleanSetup On Next Boot
- boot_
delay float - boot_
retry_ floatdelay - boot_
retry_ boolenabled - efi_
secure_ boolboot - enter_
bios_ boolsetup_ on_ next_ boot
- boot
Delay Number - boot
Retry NumberDelay - boot
Retry BooleanEnabled - efi
Secure BooleanBoot - enter
Bios BooleanSetup On Next Boot
GetVappVmCustomization
- Admin
Password string - Allow
Local boolAdmin Password - Auto
Generate boolPassword - Change
Sid bool - Enabled bool
- Force bool
- Initscript string
- Join
Domain bool - Join
Domain stringAccount Ou - Join
Domain stringName - Join
Domain stringPassword - Join
Domain stringUser - Join
Org boolDomain - Must
Change boolPassword On First Login - Number
Of doubleAuto Logons
- Admin
Password string - Allow
Local boolAdmin Password - Auto
Generate boolPassword - Change
Sid bool - Enabled bool
- Force bool
- Initscript string
- Join
Domain bool - Join
Domain stringAccount Ou - Join
Domain stringName - Join
Domain stringPassword - Join
Domain stringUser - Join
Org boolDomain - Must
Change boolPassword On First Login - Number
Of float64Auto Logons
- admin
Password String - allow
Local BooleanAdmin Password - auto
Generate BooleanPassword - change
Sid Boolean - enabled Boolean
- force Boolean
- initscript String
- join
Domain Boolean - join
Domain StringAccount Ou - join
Domain StringName - join
Domain StringPassword - join
Domain StringUser - join
Org BooleanDomain - must
Change BooleanPassword On First Login - number
Of DoubleAuto Logons
- admin
Password string - allow
Local booleanAdmin Password - auto
Generate booleanPassword - change
Sid boolean - enabled boolean
- force boolean
- initscript string
- join
Domain boolean - join
Domain stringAccount Ou - join
Domain stringName - join
Domain stringPassword - join
Domain stringUser - join
Org booleanDomain - must
Change booleanPassword On First Login - number
Of numberAuto Logons
- admin_
password str - allow_
local_ booladmin_ password - auto_
generate_ boolpassword - change_
sid bool - enabled bool
- force bool
- initscript str
- join_
domain bool - join_
domain_ straccount_ ou - join_
domain_ strname - join_
domain_ strpassword - join_
domain_ struser - join_
org_ booldomain - must_
change_ boolpassword_ on_ first_ login - number_
of_ floatauto_ logons
- admin
Password String - allow
Local BooleanAdmin Password - auto
Generate BooleanPassword - change
Sid Boolean - enabled Boolean
- force Boolean
- initscript String
- join
Domain Boolean - join
Domain StringAccount Ou - join
Domain StringName - join
Domain StringPassword - join
Domain StringUser - join
Org BooleanDomain - must
Change BooleanPassword On First Login - number
Of NumberAuto Logons
GetVappVmDisk
- Bus
Number string - Name string
- A name for the VM, unique within the vApp
- Size
In doubleMb - Unit
Number string
- Bus
Number string - Name string
- A name for the VM, unique within the vApp
- Size
In float64Mb - Unit
Number string
- bus
Number String - name String
- A name for the VM, unique within the vApp
- size
In DoubleMb - unit
Number String
- bus
Number string - name string
- A name for the VM, unique within the vApp
- size
In numberMb - unit
Number string
- bus_
number str - name str
- A name for the VM, unique within the vApp
- size_
in_ floatmb - unit_
number str
- bus
Number String - name String
- A name for the VM, unique within the vApp
- size
In NumberMb - unit
Number String
GetVappVmExtraConfig
GetVappVmInternalDisk
- Bus
Number double - Bus
Type string - Disk
Id string - Iops double
- Size
In doubleMb - Storage
Profile string - Thin
Provisioned bool - Unit
Number double
- Bus
Number float64 - Bus
Type string - Disk
Id string - Iops float64
- Size
In float64Mb - Storage
Profile string - Thin
Provisioned bool - Unit
Number float64
- bus
Number Double - bus
Type String - disk
Id String - iops Double
- size
In DoubleMb - storage
Profile String - thin
Provisioned Boolean - unit
Number Double
- bus
Number number - bus
Type string - disk
Id string - iops number
- size
In numberMb - storage
Profile string - thin
Provisioned boolean - unit
Number number
- bus_
number float - bus_
type str - disk_
id str - iops float
- size_
in_ floatmb - storage_
profile str - thin_
provisioned bool - unit_
number float
- bus
Number Number - bus
Type String - disk
Id String - iops Number
- size
In NumberMb - storage
Profile String - thin
Provisioned Boolean - unit
Number Number
GetVappVmMetadataEntry
- Is
System bool - Key string
- Type string
- User
Access string - Value string
- Is
System bool - Key string
- Type string
- User
Access string - Value string
- is
System Boolean - key String
- type String
- user
Access String - value String
- is
System boolean - key string
- type string
- user
Access string - value string
- is_
system bool - key str
- type str
- user_
access str - value str
- is
System Boolean - key String
- type String
- user
Access String - value String
GetVappVmNetwork
- Adapter
Type string - Connected bool
- Ip string
- Ip
Allocation stringMode - Is
Primary bool - Mac string
- Name string
- A name for the VM, unique within the vApp
- Secondary
Ip string - Secondary
Ip stringAllocation Mode - Type string
- Adapter
Type string - Connected bool
- Ip string
- Ip
Allocation stringMode - Is
Primary bool - Mac string
- Name string
- A name for the VM, unique within the vApp
- Secondary
Ip string - Secondary
Ip stringAllocation Mode - Type string
- adapter
Type String - connected Boolean
- ip String
- ip
Allocation StringMode - is
Primary Boolean - mac String
- name String
- A name for the VM, unique within the vApp
- secondary
Ip String - secondary
Ip StringAllocation Mode - type String
- adapter
Type string - connected boolean
- ip string
- ip
Allocation stringMode - is
Primary boolean - mac string
- name string
- A name for the VM, unique within the vApp
- secondary
Ip string - secondary
Ip stringAllocation Mode - type string
- adapter_
type str - connected bool
- ip str
- ip_
allocation_ strmode - is_
primary bool - mac str
- name str
- A name for the VM, unique within the vApp
- secondary_
ip str - secondary_
ip_ strallocation_ mode - type str
- adapter
Type String - connected Boolean
- ip String
- ip
Allocation StringMode - is
Primary Boolean - mac String
- name String
- A name for the VM, unique within the vApp
- secondary
Ip String - secondary
Ip StringAllocation Mode - type String
Package Details
- Repository
- vcd vmware/terraform-provider-vcd
- License
- Notes
- This Pulumi package is based on the
vcd
Terraform Provider.