Vm APIs

Vm APIs

The vcenter vm package provides services for managing virtual machines.

API Categories
DataSets

The DataSets service provides operations for sharing information between a virtual machine and its guest operating system. Information is grouped into data sets, each of which contains key-value entries comprising the data. It's expected that each application using the service will have at least one unique data set in which to store its data to avoid conflict with other applications. Each data set has attributes defining its size limitations, access control and interoperability configuration.

It's not recommended that sensitive data (for example, passwords or private keys) be stored in plain-text. The data will be visible to other applications, running both on the management network and within the guest. The data can also be exposed by backups or templates.

Data set support requires the the virtual machine be at virtual hardware version XXX or later.

Data sets should only be modified by the application that creates them. Otherwise the application may stop working. . Warning: This service is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Hardware

The Hardware service provides operations for configuring the virtual hardware of a virtual machine.

Identity

The Identity service provides operations for managing the identity of a virtual machine.

LibraryItem

The LibraryItem service provides operations to identify virtual machines managed by Content Library.

Power

The Power service provides operations for managing the power state of a virtual machine.

Tags

The Tags service provides operations to manage tag associations of a virtual machine. Warning: This service is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented. Note: This service is restricted for VMware internal use only.

Tools

The Tools service provides operations for managing VMware Tools in the guest operating system.

Policies

The Policies service provides operations to query the status of policies on virtual machines in VMware Cloud on AWS. Usage beyond VMware Cloud on AWS is not supported. Warning: This service is available as Technology Preview. These are early access APIs provided to test, automate and provide feedback on the feature. Since this can change based on feedback, VMware does not guarantee backwards compatibility and recommends against using them in production environments. Some Technology Preview APIs might only be applicable to specific environments.

Tickets

The Tickets service provides operations for managing the virtual machine console tickets.

Entries

The Entries service provides operations for manipulating entries in a data set. Warning: This service is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Customization

The Customization service provides operations to apply a customization specification to a virtual machine.

Environment

The Environment service provides operations to manage environment variables in the guest operating system. Warning: This service is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Identity

The Identity service provides operations for retrieving guest operating system identification information.

LocalFilesystem

The LocalFilesystem service provides operations for retrieving information about the guest operating system local file systems.

Networking

The Networking service provides operations for retrieving guest operating system network information.

Operations

Status of operations in the guest OS. Warning: This service is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Power

The Power service provides operations for managing the guest operating system power state of a virtual machine.

Processes

The Processes service provides operations to manage processes in the guest operating system. Warning: This service is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Directories

The Directories service provides operations to manage directories in the guest filesystem. Warning: This service is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Files

The Files service provides operations to manage the files in the guest filesystem. Warning: This service is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Transfers

The Transfers service provides operations to copy files into and out of the guest file system. Warning: This service is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Interfaces

The Interfaces service provides operations for retrieving guest operating system network interface information.

Routes

The Routes service provides operations for retrieving guest operating system network routing information.

Boot

The Boot service provides operations for configuring the settings used when booting a virtual machine.

Cdrom

The Cdrom service provides operations for configuring the virtual CD-ROM devices of a virtual machine.

Cpu

The Cpu service provides operations for configuring the CPU settings of a virtual machine.

Disk

The Disk service provides operations for configuring the virtual disks of a virtual machine. A virtual disk has a backing such as a VMDK file. The backing has an independent lifecycle from the virtual machine when it is detached from the virtual machine. The Disk.create operation provides the ability to create a new virtual disk. When creating a virtual disk, a new VMDK file may be created or an existing VMDK file may used as a backing. Once a VMDK file is associated with a virtual machine, its lifecycle will be bound to the virtual machine. In other words, it will be deleted when the virtual machine is deleted. The Disk.delete operation provides the ability to detach a VMDK file from the virtual machine. The Disk.delete operation does not delete the VMDK file that backs the virtual disk. Once detached, the VMDK file will not be destroyed when the virtual machine to which it was associated is deleted.

Ethernet

The Ethernet service provides operations for configuring the virtual Ethernet adapters of a virtual machine.

Floppy

The Floppy service provides operations for configuring the virtual floppy drives of a virtual machine.

Memory

The Memory service provides operations for configuring the memory settings of a virtual machine.

Parallel

The Parallel service provides operations for configuring the virtual parallel ports of a virtual machine.

Serial

The Serial service provides operations for configuring the virtual serial ports of a virtual machine.

Nvme

The Nvme service provides operations for configuring the virtual NVMe adapters of a virtual machine. Warning: This service is part of a new feature in development. It may be changed at any time and may not have all supported functionality implemented.

Sata

The Sata service provides operations for configuring the virtual SATA adapters of a virtual machine.

Scsi

The Scsi service provides operations for configuring the virtual SCSI adapters of a virtual machine.

Device

The Device service provides operations for configuring the device order used when booting a virtual machine. The boot order may be specified using a mixture of device classes and device instances, chosen from among the following:

  • CDROM: Boot from a virtual CD-ROM drive; the device instance(s) will be chosen by the BIOS subsystem.
  • FLOPPY: Boot from a virtual floppy drive; the device instance(s) will be chosen by the BIOS subsystem.
  • DISK: Boot from a virtual disk device; the device instance is specified explicitly in Device.Entry.disks list, and multiple instances may be specified in the list.
  • ETHERNET: Boot from a virtual Ethernet adapter; the device instance is specified explicitly as Device.Entry.nic, and multiple adapters may be specified in the boot order list.

Policy

The Policy service provides operations to configure the storage policies associated with the virtual machine home and/or its virtual disks.

Compliance

The Compliance service provides operations that return the compliance status of virtual machine entities(virtual machine home directory and virtual disks) that specify storage policy requirements.

Installer

The Installer (@term service} provides operations to install VMware Tools in the guest operating system.