Update Virtual Machine
Updates the properties of an existing VM.
External Documentation
To learn more, visit the Nutanix Hypervisor documentation.
Parameters
| Parameter | Description |
|---|---|
| Metadata | The VM metadata. Please refer to Nutanix Hypervisor Documentation for more information regarding the metadata structure.For example: |
| Specification | A representation of a VM spec. Please refer to Nutanix Hypervisor Documentation for more information regarding the specification structure.For example: |
| Virtual Machine ID | The UUID of the VM. |
Example Output
{
"status": {
"name": "string",
"state": "string",
"availability_zone_reference": {
"kind": "availability_zone",
"name": "string",
"uuid": "string"
},
"message_list": [
{
"message": "string",
"reason": "string",
"details": {
"property1": "string",
"property2": "string"
}
}
],
"cluster_reference": {
"kind": "cluster",
"name": "string",
"uuid": "string"
},
"resources": {
"num_threads_per_core": 1,
"is_agent_vm": true,
"protection_policy_state": {
"policy_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"policy_info": {
"replication_status": "string"
},
"compliance_status": "string",
"enforcement_mode": "string",
"error_message_list": [
{
"message": "string",
"reason": "string",
"details": {
"property1": "string",
"property2": "string"
}
}
]
},
"memory_size_mib": 1,
"boot_config": {
"boot_device_order_list": [
"string"
],
"boot_device": {
"disk_address": {
"device_index": 0,
"adapter_type": "string"
},
"mac_address": "string"
},
"data_source_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"boot_type": "string"
},
"disk_list": [
{
"uuid": "string",
"is_encryption_in_progress": false,
"is_migration_in_progress": false,
"disk_size_bytes": 1,
"storage_config": {
"flash_mode": "string",
"storage_container_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
}
},
"device_properties": {
"device_type": "DISK",
"disk_address": {
"device_index": 0,
"adapter_type": "string"
}
},
"data_source_reference": {
"is_direct_attach": true,
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"disk_size_mib": 1,
"volume_group_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
}
}
],
"serial_port_list": [
{
"index": 0,
"is_connected": true
}
],
"generation_uuid": "string",
"bios_uuid": "string",
"vga_console_enabled": true,
"power_state": "string",
"recovery_plan_state_list": [
{
"policy_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"policy_info": {
"recoverability": {
"status": "string",
"reason": "string"
}
},
"compliance_status": "string",
"enforcement_mode": "string",
"error_message_list": [
{
"message": "string",
"reason": "string",
"details": {
"property1": "string",
"property2": "string"
}
}
]
}
],
"effective_storage_config": {
"compression_delay_secs": 0,
"compression_enabled": true,
"throttled_iops": 0,
"active_storage_policy_reference_list": [
{
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
}
],
"encryption_enabled": true
},
"num_vcpus_per_socket": 0,
"num_sockets": 0,
"hardware_virtualization_enabled": true,
"storage_config": {
"qos_policy": {
"throttled_iops": 0
},
"flash_mode": "string"
},
"protection_type": "string",
"gpu_list": [
{
"frame_buffer_size_mib": 0,
"vendor": "string",
"uuid": "string",
"name": "string",
"pci_address": "string",
"fraction": 0,
"mode": "string",
"num_virtual_display_heads": 0,
"guest_driver_version": "string",
"max_instances_per_vm": 0,
"device_id": 0
}
],
"machine_type": "string",
"hardware_clock_timezone": "string",
"guest_customization": {
"cloud_init": {
"meta_data": "string",
"user_data": "string",
"custom_key_values": {
"property1": "string",
"property2": "string"
}
},
"is_overridable": true,
"sysprep": {
"install_type": "PREPARED",
"unattend_xml": "string",
"custom_key_values": {
"property1": "string",
"property2": "string"
}
},
"property1": "string",
"property2": "string"
},
"power_state_mechanism": {
"guest_transition_config": {
"should_fail_on_script_failure": true,
"enable_script_exec": true
},
"mechanism": "string"
},
"is_vcpu_hard_pinned": true,
"memory_overcommit_enabled": true,
"vnuma_config": {
"num_vnuma_nodes": 0
},
"nic_list": [
{
"dns_ip_addresses_list": [
"string"
],
"nic_type": "string",
"subnet_reference": {
"kind": "subnet",
"name": "string",
"uuid": "string"
},
"uuid": "string",
"ip_endpoint_list": [
{
"ip": "string",
"type": "string",
"gateway_address_list": [
"string"
],
"prefix_length": 32,
"ip_type": "string"
}
],
"network_function_chain_reference": {
"kind": "network_function_chain",
"name": "string",
"uuid": "string"
},
"secondary_ip_address_list": [
"string"
],
"floating_ip": "string",
"mac_address": "string",
"network_function_nic_type": "string",
"vlan_mode": "string",
"num_queues": 0,
"default_gateway_address_list": [
"string"
],
"dhcp_server_ip": "string",
"model": "string",
"is_connected": true,
"trunked_vlan_list": [
0
]
}
],
"host_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"guest_os_id": "string",
"guest_tools": {
"nutanix_guest_tools": {
"available_version": "string",
"ngt_state": "string",
"iso_mount_state": "string",
"guest_os_version": "string",
"state": "string",
"version": "string",
"enabled_capability_list": [
"string"
],
"credentials": {
"username": "string",
"password": "string"
},
"vss_snapshot_capable": true,
"is_reachable": true,
"vm_mobility_drivers_installed": true
}
},
"gpu_console_enabled": true,
"vtpm_config": {
"vtpm_enabled": true,
"data_source_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"version": "string"
},
"enable_cpu_passthrough": true,
"parent_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"hypervisor_type": "string",
"disable_branding": true
},
"description": "string"
},
"spec": {
"name": "string",
"availability_zone_reference": {
"kind": "availability_zone",
"name": "string",
"uuid": "string"
},
"description": "string",
"resources": {
"num_threads_per_core": 1,
"is_agent_vm": true,
"memory_size_mib": 1,
"boot_config": {
"boot_device_order_list": [
"string"
],
"boot_device": {
"disk_address": {
"device_index": 0,
"adapter_type": "string"
},
"mac_address": "string"
},
"data_source_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"boot_type": "string"
},
"disk_list": [
{
"uuid": "string",
"disk_size_bytes": 1,
"storage_config": {
"flash_mode": "string",
"storage_container_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
}
},
"device_properties": {
"device_type": "DISK",
"disk_address": {
"device_index": 0,
"adapter_type": "string"
}
},
"data_source_reference": {
"is_direct_attach": true,
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"disk_size_mib": 1,
"volume_group_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
}
}
],
"serial_port_list": [
{
"index": 0,
"is_connected": true
}
],
"generation_uuid": "string",
"bios_uuid": "string",
"is_vcpu_hard_pinned": true,
"guest_tools": {
"nutanix_guest_tools": {
"ngt_state": "string",
"iso_mount_state": "string",
"state": "string",
"version": "string",
"enabled_capability_list": [
"string"
],
"credentials": {
"username": "string",
"password": "string"
}
}
},
"power_state": "string",
"num_vcpus_per_socket": 1,
"num_sockets": 1,
"hardware_virtualization_enabled": true,
"storage_config": {
"qos_policy": {
"throttled_iops": -1
},
"flash_mode": "string"
},
"machine_type": "string",
"hardware_clock_timezone": "string",
"guest_customization": {
"cloud_init": {
"meta_data": "string",
"user_data": "string",
"custom_key_values": {
"property1": "string",
"property2": "string"
}
},
"is_overridable": false,
"sysprep": {
"install_type": "PREPARED",
"unattend_xml": "string",
"custom_key_values": {
"property1": "string",
"property2": "string"
}
},
"property1": "string",
"property2": "string"
},
"power_state_mechanism": {
"guest_transition_config": {
"should_fail_on_script_failure": true,
"enable_script_exec": true
},
"mechanism": "string"
},
"vga_console_enabled": true,
"memory_overcommit_enabled": true,
"vnuma_config": {
"num_vnuma_nodes": 0
},
"nic_list": [
{
"nic_type": "string",
"uuid": "string",
"ip_endpoint_list": [
{
"ip": "string",
"type": "string",
"gateway_address_list": [
"string"
],
"prefix_length": 32,
"ip_type": "string"
}
],
"num_queues": 0,
"secondary_ip_address_list": [
"string"
],
"network_function_nic_type": "string",
"network_function_chain_reference": {
"kind": "network_function_chain",
"name": "string",
"uuid": "string"
},
"vlan_mode": "string",
"mac_address": "string",
"subnet_reference": {
"kind": "subnet",
"name": "string",
"uuid": "string"
},
"model": "string",
"is_connected": true,
"trunked_vlan_list": [
0
]
}
],
"guest_os_id": "string",
"gpu_list": [
{
"vendor": "string",
"mode": "string",
"device_id": 0
}
],
"gpu_console_enabled": true,
"vtpm_config": {
"vtpm_enabled": true,
"data_source_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"vtpm_secret": "string"
},
"enable_cpu_passthrough": true,
"parent_reference": {
"url": "string",
"kind": "string",
"uuid": "string",
"name": "string"
},
"disable_branding": true
},
"cluster_reference": {
"kind": "cluster",
"name": "string",
"uuid": "string"
}
},
"api_version": "3.1.0",
"metadata": {
"last_update_time": "2019-08-24T14:15:22Z",
"use_categories_mapping": false,
"kind": "vm",
"uuid": "string",
"project_reference": {
"kind": "project",
"name": "string",
"uuid": "string"
},
"creation_time": "2019-08-24T14:15:22Z",
"spec_version": 0,
"spec_hash": "string",
"categories_mapping": {
"property1": [
"string"
],
"property2": [
"string"
]
},
"should_force_translate": true,
"entity_version": "string",
"owner_reference": {
"kind": "user",
"name": "string",
"uuid": "string"
},
"categories": {
"property1": "string",
"property2": "string"
},
"name": "string"
}
}
Workflow Library Example
Update Virtual Machine with Nutanix Hypervisor and Send Results Via Email
Preview this Workflow on desktop