vcenter vm template library items: hardware customization spec

The hardware_customization_spec structure defines the hardware customization options that are applied to the deployed virtual machine. This structure was added in vSphere API 6.8.

Representation:

{
    "cpu_update"{
        "num_cpus"1,
        "num_cores_per_socket"1
    },
    "memory_update"{
        "memory"1
    },
    "nics"{
        "obj-103"{
            "network""obj-103"
        }
    },
    "disks_to_remove"[
        "obj-103",
        "obj-103"
    ],
    "disks_to_update"{
        "obj-103"{
            "capacity"1
        }
    }
}
{
    "cpu_update"{
        "num_cpus"1,
        "num_cores_per_socket"1
    },
    "memory_update"{
        "memory"1
    },
    "nics"[
        {
            "value"{
                "network""obj-103"
            },
            "key""obj-103"
        }
    ],
    "disks_to_remove"[
        "obj-103",
        "obj-103"
    ],
    "disks_to_update"[
        {
            "value"{
                "capacity"1
            },
            "key""obj-103"
        }
    ]
}

Attributes:

Name Type Description
Required
-.nics.* ethernet_update_spec
-.disks_to_update.* disk_update_spec
-.disks_to_update.*.capacity long Updated capacity of the virtual disk backing in bytes. This value has to be larger than the original capacity of the disk. This attribute was added in vSphere API 6.8.

Optional
-.nics object Map of Ethernet network adapters to update. This attribute was added in vSphere API 6.8.

Optional. If unset, all Ethernet adapters will remain connected to the same network as they were in the source virtual machine template. An Ethernet adapter with a MacAddressType of MANUAL will not change. An Ethernet adapter with a MacAddressType of GENERATED or ASSIGNED will receive a new address.When clients pass a value of this structure as a parameter, the key in the field key/value pairs must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet. When operations return a value of this structure as a result, the key in the field key/value pairs will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Ethernet.

-.nics.*.network string Identifier of the network backing the virtual Ethernet adapter. This attribute was added in vSphere API 6.8.

Optional. This field is currently required.

If unset, the virtual Ethernet adapter will be connected to same network as it was in the source virtual machine template.

. When clients pass a value of this structure as a parameter, the field must be an identifier for the resource type: Network. When operations return a value of this structure as a result, the field will be an identifier for the resource type: Network.
-.disks_to_remove string[] Idenfiers of disks to remove from the deployed virtual machine. This attribute was added in vSphere API 6.8.

Optional. If unset, all disks will be copied.When clients pass a value of this structure as a parameter, the field must contain identifiers for the resource type: com.vmware.vcenter.vm.hardware.Disk. When operations return a value of this structure as a result, the field will contain identifiers for the resource type: com.vmware.vcenter.vm.hardware.Disk.

-.disks_to_update object Disk update specification for individual disks in the deployed virtual machine. This attribute was added in vSphere API 6.8.

Optional. If unset, disks in the deployed virtual machine will have the same settings as the corresponding disks in the source virtual machine template contained in the library item.When clients pass a value of this structure as a parameter, the key in the field key/value pairs must be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Disk. When operations return a value of this structure as a result, the key in the field key/value pairs will be an identifier for the resource type: com.vmware.vcenter.vm.hardware.Disk.

-.cpu_update cpu_update_spec CPU update specification for the deployed virtual machine. This attribute was added in vSphere API 6.8.

Optional. If {@term.unset}, the deployed virtual machine has the same CPU settings as the source virtual machine template contained in the library item.

-.cpu_update.num_cpus long Number of virtual processors in the deployed virtual machine. This attribute was added in vSphere API 6.8.

Optional. If {@term.unset}, the deployed virtual machine has the same CPU count as the source virtual machine template contained in the library item.

-.cpu_update.num_cores_per_socket long Number of cores among which to distribute CPUs in the deployed virtual machine. This attribute was added in vSphere API 6.8.

Optional. If {@term.unset}, the deployed virtual machine has the same number of cores per socket as the source virtual machine template contained in the library item.

-.memory_update memory_update_spec Memory update specification for the deployed virtual machine. This attribute was added in vSphere API 6.8.

Optional. If {@term.unset}, the deployed virtual machine has the same memory settings as the source virtual machine template contained in the library item.

-.memory_update.memory long Size of a virtual machine's memory in MB. This attribute was added in vSphere API 6.8.

Optional. If {@term.unset}, the deployed virtual machine has the same memory size as the source virtual machine template.