Gets an existing VM.

External Documentation

To learn more, visit the Nutanix Hypervisor documentation.

​
Parameters

ParameterDescription
Virtual Machine IDThe 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

Get Virtual Machine with Nutanix Hypervisor and Send Results Via Email

Preview this Workflow on desktop

Was this page helpful?

Get TaskList Alerts