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
This property is required. string - A name for the VM, unique within the vApp
- Vapp
Name This property is required. 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
This property is required. string - A name for the VM, unique within the vApp
- Vapp
Name This property is required. 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
This property is required. String - A name for the VM, unique within the vApp
- vapp
Name This property is required. 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
This property is required. string - A name for the VM, unique within the vApp
- vapp
Name This property is required. 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
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_ 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
This property is required. String - A name for the VM, unique within the vApp
- vapp
Name This property is required. 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 This property is required. double - Boot
Retry Delay This property is required. double - 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
- Boot
Delay This property is required. float64 - Boot
Retry Delay This property is required. float64 - 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
- boot
Delay This property is required. Double - boot
Retry Delay This property is required. Double - boot
Retry Enabled This property is required. Boolean - efi
Secure Boot This property is required. Boolean - enter
Bios Setup On Next Boot This property is required. Boolean
- boot
Delay This property is required. number - boot
Retry Delay This property is required. number - boot
Retry Enabled This property is required. boolean - efi
Secure Boot This property is required. boolean - enter
Bios Setup On Next Boot 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
- boot
Delay This property is required. Number - boot
Retry Delay This property is required. Number - boot
Retry Enabled This property is required. Boolean - efi
Secure Boot This property is required. Boolean - enter
Bios Setup On Next Boot This property is required. Boolean
GetVappVmCustomization
- Admin
Password This property is required. string - 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. string - Join
Domain This property is required. bool - Join
Domain Account Ou This property is required. string - Join
Domain Name This property is required. string - Join
Domain Password This property is required. string - Join
Domain User This property is required. string - 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. double
- Admin
Password This property is required. string - 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. string - Join
Domain This property is required. bool - Join
Domain Account Ou This property is required. string - Join
Domain Name This property is required. string - Join
Domain Password This property is required. string - Join
Domain User This property is required. string - 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. float64
- admin
Password This property is required. String - allow
Local Admin Password This property is required. Boolean - auto
Generate Password This property is required. Boolean - change
Sid This property is required. Boolean - enabled
This property is required. Boolean - force
This property is required. Boolean - initscript
This property is required. String - join
Domain This property is required. Boolean - join
Domain Account Ou This property is required. String - join
Domain Name This property is required. String - join
Domain Password This property is required. String - join
Domain User This property is required. String - join
Org Domain This property is required. Boolean - must
Change Password On First Login This property is required. Boolean - number
Of Auto Logons This property is required. Double
- admin
Password This property is required. string - allow
Local Admin Password This property is required. boolean - auto
Generate Password This property is required. boolean - change
Sid This property is required. boolean - enabled
This property is required. boolean - force
This property is required. boolean - initscript
This property is required. string - join
Domain This property is required. boolean - join
Domain Account Ou This property is required. string - join
Domain Name This property is required. string - join
Domain Password This property is required. string - join
Domain User This property is required. string - join
Org Domain This property is required. boolean - must
Change Password On First Login This property is required. boolean - number
Of Auto Logons 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
- admin
Password This property is required. String - allow
Local Admin Password This property is required. Boolean - auto
Generate Password This property is required. Boolean - change
Sid This property is required. Boolean - enabled
This property is required. Boolean - force
This property is required. Boolean - initscript
This property is required. String - join
Domain This property is required. Boolean - join
Domain Account Ou This property is required. String - join
Domain Name This property is required. String - join
Domain Password This property is required. String - join
Domain User This property is required. String - join
Org Domain This property is required. Boolean - must
Change Password On First Login This property is required. Boolean - number
Of Auto Logons This property is required. Number
GetVappVmDisk
- Bus
Number This property is required. string - Name
This property is required. string - A name for the VM, unique within the vApp
- Size
In Mb This property is required. double - Unit
Number This property is required. string
- Bus
Number This property is required. string - Name
This property is required. string - A name for the VM, unique within the vApp
- Size
In Mb This property is required. float64 - Unit
Number This property is required. string
- bus
Number This property is required. String - name
This property is required. String - A name for the VM, unique within the vApp
- size
In Mb This property is required. Double - unit
Number This property is required. String
- bus
Number This property is required. string - name
This property is required. string - A name for the VM, unique within the vApp
- size
In Mb This property is required. number - unit
Number 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
- bus
Number This property is required. String - name
This property is required. String - A name for the VM, unique within the vApp
- size
In Mb This property is required. Number - unit
Number This property is required. String
GetVappVmExtraConfig
GetVappVmInternalDisk
- Bus
Number This property is required. double - Bus
Type This property is required. string - Disk
Id This property is required. string - Iops
This property is required. double - Size
In Mb This property is required. double - Storage
Profile This property is required. string - Thin
Provisioned This property is required. bool - Unit
Number This property is required. double
- Bus
Number This property is required. float64 - Bus
Type This property is required. string - Disk
Id This property is required. string - Iops
This property is required. float64 - Size
In Mb This property is required. float64 - Storage
Profile This property is required. string - Thin
Provisioned This property is required. bool - Unit
Number This property is required. float64
- bus
Number This property is required. Double - bus
Type This property is required. String - disk
Id This property is required. String - iops
This property is required. Double - size
In Mb This property is required. Double - storage
Profile This property is required. String - thin
Provisioned This property is required. Boolean - unit
Number This property is required. Double
- bus
Number This property is required. number - bus
Type This property is required. string - disk
Id This property is required. string - iops
This property is required. number - size
In Mb This property is required. number - storage
Profile This property is required. string - thin
Provisioned This property is required. boolean - unit
Number 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
- bus
Number This property is required. Number - bus
Type This property is required. String - disk
Id This property is required. String - iops
This property is required. Number - size
In Mb This property is required. Number - storage
Profile This property is required. String - thin
Provisioned This property is required. Boolean - unit
Number This property is required. Number
GetVappVmMetadataEntry
- Is
System This property is required. bool - Key
This property is required. string - Type
This property is required. string - User
Access This property is required. string - Value
This property is required. string
- Is
System This property is required. bool - Key
This property is required. string - Type
This property is required. string - User
Access This property is required. string - Value
This property is required. string
- is
System This property is required. Boolean - key
This property is required. String - type
This property is required. String - user
Access This property is required. String - value
This property is required. String
- is
System This property is required. boolean - key
This property is required. string - type
This property is required. string - user
Access 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
- is
System This property is required. Boolean - key
This property is required. String - type
This property is required. String - user
Access This property is required. String - value
This property is required. String
GetVappVmNetwork
- Adapter
Type This property is required. string - Connected
This property is required. bool - Ip
This property is required. string - Ip
Allocation Mode This property is required. string - Is
Primary 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
- Secondary
Ip This property is required. string - Secondary
Ip Allocation Mode This property is required. string - Type
This property is required. string
- Adapter
Type This property is required. string - Connected
This property is required. bool - Ip
This property is required. string - Ip
Allocation Mode This property is required. string - Is
Primary 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
- Secondary
Ip This property is required. string - Secondary
Ip Allocation Mode This property is required. string - Type
This property is required. string
- adapter
Type This property is required. String - connected
This property is required. Boolean - ip
This property is required. String - ip
Allocation Mode This property is required. String - is
Primary 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
- secondary
Ip This property is required. String - secondary
Ip Allocation Mode This property is required. String - type
This property is required. String
- adapter
Type This property is required. string - connected
This property is required. boolean - ip
This property is required. string - ip
Allocation Mode This property is required. string - is
Primary 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
- secondary
Ip This property is required. string - secondary
Ip Allocation Mode 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
- adapter
Type This property is required. String - connected
This property is required. Boolean - ip
This property is required. String - ip
Allocation Mode This property is required. String - is
Primary 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
- secondary
Ip This property is required. String - secondary
Ip Allocation Mode 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.