Vcenter REST APIs Operations Index
All available Vcenter REST APIs Operations
Certificate Management Vcenter
Tls
GET
Get Certificate Management Tls
Returns the rhttpproxy TLS certificate. if you do not have all of the privileges described as follows: - Operation execution requires System.Read.
PUT
Set Certificate Management Tls
Replaces the rhttpproxy TLS certificate with the specified certificate. This operation can be used in three scenarios : 1. When the CSR is created and the private key is already stored, this operation can replace the certificate. The Tls.Spec.cert (but not Tls.Spec.key and Tls.Spec.root-cert) must be provided as input. 2. When the certificate is signed by a third party certificate authority/VMCA and the root certificate of the third party certificate authority/VMCA is already one of the trusted roots in the trust store, this operation can replace the certificate and private key. The Tls.Spec.cert and Tls.Spec.key (but not Tls.Spec.root-cert) must be provided as input. 3. When the certificate is signed by a third party certificate authority and the root certificate of the third party certificate authority is not one of the trusted roots in the trust store, this operation can replace the certificate, private key and root CA certificate. The Tls.Spec.cert,Tls.Spec.key and Tls.Spec.root-cert must be provided as input. After this operation completes, the services using the certificate will be restarted for the new certificate to take effect. The above three scenarios are only supported from vsphere 7.0 onwards. if you do not have all of the privileges described as follows: - Operation execution requires CertificateManagement.Administer.
POST
Renew Tls
Renews the TLS certificate for the given duration period. After this operation completes, the services using the certificate will be restarted for the new certificate to take effect. if you do not have all of the privileges described as follows: - Operation execution requires CertificateManagement.Administer.
POST
Replace Vmca Signed Tls
Replace MACHINE SSL with VMCA signed one with the given Spec.The system will go for restart. After this operation completes, the services using the certificate will be restarted for the new certificate to take effect. if you do not have all of the privileges described as follows: - Operation execution requires CertificateManagement.Administer.
Trusted Root Chains
POST
Create Certificate Management Trusted Root Chains
Creates a new trusted root certificate chain from the CreateSpec. if you do not have all of the privileges described as follows: - Operation execution requires CertificateManagement.Manage and CertificateManagement.Administer.
GET
List Certificate Management Trusted Root Chains
Returns summary information for each trusted root certificate chain. if you do not have all of the privileges described as follows: - Operation execution requires System.Read.
DELETE
Delete Chain Certificate Management Trusted Root Chains
Deletes trusted root certificate chain for a given identifier. if you do not have all of the privileges described as follows: - Operation execution requires CertificateManagement.Manage and CertificateManagement.Administer.
GET
Get Chain Certificate Management Trusted Root Chains
Retrieve a trusted root certificate chain for a given identifier. if you do not have all of the privileges described as follows: - Operation execution requires System.Read.
Compute
Policies
Policies Capabilities
Policies Tag Usage
Content Registries
Harbor
POST
Create Content Registries Harbor
Creates a Harbor registry in the cluster.
GET
List Content Registries Harbor
Returns basic information of all Harbor registries.
DELETE
Delete Registry Registries Harbor
Delete the Harbor registry in the cluster. All Harbor projects, repositories and images will be deleted upon Harbor registry deletion.
GET
Get Registry Registries Harbor
Get detailed information of the Harbor registry.
Content Registries Harbor
Projects
POST
Create Registry Harbor Projects
Creates a project in a Harbor registry using the supplied specification. In vSphere 7.0, a Harbor registry is deployed in a vSphere cluster with vSphere namespaces enabled. When a namespace is created, a project with same name as the namespace is created in the Harbor registry, so this operation should not be called.
GET
List Registry Harbor Projects
Returns basic information of all projects in a Harbor registry.
DELETE
Delete Registry Project Harbor
Deletes the specified project from Harbor registry. Repositories and images in the project will be removed upon project deletion. Storage space of deleted images in the project will be reclaimed through next scheduled Harbor registry garbage collection. In vSphere 7.0, a Harbor registry is deployed in a vSphere cluster with vSphere namespaces enabled. When a namespace is deleted, a project with same name as the namespace is deleted from the Harbor registry, so this operation should not be called.
GET
Get Registry Project Harbor
Returns detailed information about the specified Harbor project.
POST
Purge Registry Project
Remove all repositories, images and members in the project. Storage space of deleted images in the project will be reclaimed through next scheduled Harbor registry garbage collection.
Datastore
Deployment
Import History
POST
Cancel Deployment History
Cancels the task for importing vCenter historical data.
GET
Get Deployment History
Get the current status of the vCenter historical data import.
POST
Pause Deployment History
Pauses the task for importing vCenter historical data.
POST
Resume Deployment History
Resumes the task for importing vCenter historical data.
POST
Start Deployment History
Creates and starts task for importing vCenter historical data.
Install
POST
Cancel Deployment Install
Cancel the appliance installation that is in progress.
POST
Check Deployment Install
Run sanity checks using the InstallSpec parameters passed.
GET
Get Deployment Install
Get the parameters used to configure the ongoing appliance installation.
POST
Start Deployment Install
Start the appliance installation.
Migrate
POST
Cancel Deployment Migrate
Cancel the appliance migration that is in progress.
POST
Check Deployment Migrate
Run sanity checks using the MigrateSpec parameters passed.
GET
Get Deployment Migrate
Get the MigrateSpec parameters used to configure the ongoing appliance migration.
POST
Start Deployment Migrate
Start the appliance migration.
Question
POST
Answer Deployment Question
Supply answer to the raised question.
GET
Get Deployment Question
Get the question that was raised during the configuration.
Upgrade
POST
Cancel Deployment Upgrade
Cancel the appliance upgrade that is in progress.
POST
Check Deployment Upgrade
Run sanity checks using the UpgradeSpec parameters passed.
GET
Get Deployment Upgrade
Get the UpgradeSpec parameters used to configure the ongoing appliance upgrade.
POST
Start Deployment Upgrade
Start the appliance installation.
Install Remote Psc
POST
Check Install Remote Psc
Checks whether the remote PSC is reachable and the deployed vCenter Server can be registered with the remote PSC.
Install Initial Config Remote Psc Thumbprint
GET
Get Initial Config Remote Psc Thumbprint
Gets the SHA1 thumbprint of the remote PSC.
Install Psc Replicated
POST
Check Psc Replicated
Checks whether the provided remote PSC is reachable and can be replicated.
Guest
Customization Specs
POST
Create Guest Customization Specs
Creates a customization specification.
GET
List Guest Customization Specs
Returns information about at most 1000 visible (subject to permission checks) guest customization specifications in vCenter matching the CustomizationSpecs.FilterSpec.
DELETE
Delete Name Guest Customization Specs
Deletes a customization specification with the specified identifier.
GET
Get Name Guest Customization Specs
Returns the guest customization specification from vCenter with the specified identifier.
POST
Create Name Guest Customization Specs
Sets an existing specification, possibly after retrieving (by using CustomizationSpecs.get) and editing it.
POST
Export Name Customization Specs
Returns the content of the customization specification in the specified format. Note that any passwords in the customization specification will be set to blank values during the export operation.
POST
Import Guest Customization Specs
Converts a well formatted string to a CustomizationSpecs.CreateSpec. The resulting object can be passed to CustomizationSpecs.create operation.
Hvc
Links
POST
Create Hvc Links
Creates a new hybrid link between the local and foreign PSC. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation 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.
GET
List Hvc Links
Enumerates the list of registered hybrid links. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation 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.
DELETE
Delete Link Hvc
Deletes an existing hybrid link. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation 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.
Links Sync Providers
GET
Get Link Provider Sync
Gets Sync information for a sync provider. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation 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.
GET
List Link Hvc Sync Providers
Enumerates the sync providers. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation 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.
POST
Start Link Provider
Initiates synchronization between the local and remote replicas for the sync provider. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation 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.
Management Administrators
POST
Add Management Administrators
Add the local sso group with the new group. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation 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.
GET
Get Hvc Management Administrators
Enumerates the set of all the groups in the local sso group. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation 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.
PUT
Set Hvc Management Administrators
Sets the groups in the local sso group. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation 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.
POST
Remove Management Administrators
Remove the group from the local sso group. Usage beyond VMware Cloud on AWS is not supported. Warning: This operation 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.
Identity
Providers
POST
Create Identity Providers
Create a vCenter Server identity provider. if you do not have all of the privileges described as follows: - Operation execution requires VcIdentityProviders.Create and VcIdentityProviders.Manage.
GET
List Identity Providers
Retrieve all identity providers. if you do not have all of the privileges described as follows: - Operation execution requires VcIdentityProviders.Read and VcIdentityProviders.Manage.
DELETE
Delete Provider Identity
Delete a vCenter Server identity provider. if you do not have all of the privileges described as follows: - Operation execution requires VcIdentityProviders.Manage.
GET
Get Provider Identity
Retrieve detailed information of the specified identity provider. if you do not have all of the privileges described as follows: - Operation execution requires VcIdentityProviders.Read and VcIdentityProviders.Manage.
PATCH
Update Provider Identity
Update a vCenter Server identity provider. if you do not have all of the privileges described as follows: - Operation execution requires VcIdentityProviders.Manage.
Inventory
Iso
Image
POST
Mount Library Item
Mounts an ISO image from a content library on a virtual machine. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Config.AddRemoveDevice. - The resource com.vmware.content.library.Item referenced by the parameter libraryItem requires ContentLibrary.DownloadSession.
POST
Unmount Vm
Unmounts a previously mounted CD-ROM using an ISO image as a backing. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Config.AddRemoveDevice. - The resource com.vmware.vcenter.vm.hardware.Cdrom referenced by the parameter cdrom requires System.Read.
Lcm
Reports
Discovery Associated Products
Discovery Interop Report
Discovery Product Catalog
Update Pending
Update Precheck Report
Namespace Management
Cluster Available Versions
Cluster Compatibility
Cluster Size Info
Clusters
Distributed Switch Compatibility
Edge Cluster Compatibility
Hosts Config
Load Balancers
Namespace Resource Options
Networks
Support Bundle
Software Clusters
Stats Time Series
Namespaces
Access
Instances
User Instances
Ovf
Library Item
POST
Create Ovf Library Item
Creates a library item in content library from a virtual machine or virtual appliance. This operation creates a library item in content library whose content is an OVF package derived from a source virtual machine or virtual appliance, using the supplied create specification. The OVF package may be stored as in a newly created library item or in an in an existing library item. For an existing library item whose content is updated by this operation, the original content is overwritten. Meta data such as name and description is not updated for the exisitng library item. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource null or null referenced by the attribute LibraryItem.DeployableIdentity.id requires VApp.Export. - The resource com.vmware.content.Library referenced by the attribute LibraryItem.CreateTarget.library-id requires ContentLibrary.AddLibraryItem. - The resource com.vmware.content.library.Item referenced by the attribute LibraryItem.CreateTarget.library-item-id requires System.Read.
POST
Deploy Ovf Library Item Id
Deploys an OVF package stored in content library to a newly created virtual machine or virtual appliance. This operation deploys an OVF package which is stored in the library item specified by ovfLibraryItemId. It uses the deployment specification in deploymentSpec to deploy the OVF package to the location specified by target. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter ovfLibraryItemId requires System.Read. - The resource HostSystem referenced by the attribute LibraryItem.DeploymentTarget.host-id requires System.Read. - The resource Network referenced by the map value of attribute LibraryItem.ResourcePoolDeploymentSpec.network-mappings requires System.Read. - The resource StorageProfile referenced by the attribute LibraryItem.ResourcePoolDeploymentSpec.storage-profile-id requires System.Read. - The resource Datastore referenced by the attribute LibraryItem.ResourcePoolDeploymentSpec.default-datastore-id requires System.Read. - The resource ResourcePool referenced by the attribute LibraryItem.DeploymentTarget.resource-pool-id requires VApp.Import. - The resource Folder referenced by the attribute LibraryItem.DeploymentTarget.folder-id requires VApp.Import.
POST
Filter Ovf Library Item Id
Queries an OVF package stored in content library to retrieve information to use when deploying the package. See LibraryItem.deploy. This operation retrieves information from the descriptor of the OVF package stored in the library item specified by ovfLibraryItemId. The information returned by the operation can be used to populate the deployment specification (see LibraryItem.ResourcePoolDeploymentSpec when deploying the OVF package to the deployment target specified by target. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter ovfLibraryItemId requires System.Read. - The resource ResourcePool referenced by the attribute LibraryItem.DeploymentTarget.resource-pool-id requires System.Read. - The resource HostSystem referenced by the attribute LibraryItem.DeploymentTarget.host-id requires System.Read. - The resource Folder referenced by the attribute LibraryItem.DeploymentTarget.folder-id requires System.Read.
Services
Storage
Policies
POST
Check Compatibility Policy Policies
Returns datastore compatibility summary about a specific storage policy.
GET
List Storage Policies
Returns information about at most 1024 visible (subject to permission checks) storage solicies availabe in vCenter. These storage policies can be used for provisioning virtual machines or disks.
System Config
Tagging
Associations
Tokenservice
Topology
Nodes
GET
Get Node Topology
Retrieve details for a given identifier of the vCenter or Platform Services Controller node. if you do not have all of the privileges described as follows: - Operation execution requires System.Read.
GET
List Topology Nodes
Returns information about all vCenter and Platform Services Controller nodes matching the Nodes.FilterSpec. if you do not have all of the privileges described as follows: - Operation execution requires System.Read.
Trusted Infrastructure
Principal
Trust Authority Clusters
Attestation Services
Kms Services
Trust Authority Clusters Consumer Principals
Trust Authority Clusters Attestation Service Status
Trust Authority Clusters Attestation Os Esx Base Images
Trust Authority Clusters Attestation Tpm2 Ca Certificates
Trust Authority Clusters Attestation Tpm2 Endorsement Keys
Trust Authority Clusters Attestation Tpm2 Settings
Trust Authority Clusters Kms Providers
Trust Authority Clusters Kms Service Status
Trust Authority Clusters Kms Providers Client Certificate
Trust Authority Clusters Kms Providers Credential
Trust Authority Clusters Kms Providers Current Peer Certificates
Trust Authority Clusters Kms Providers Trusted Peer Certificates
Trust Authority Clusters Kms Providers Client Certificate Csr
Trust Authority Hosts Attestation
Trust Authority Hosts Kms
Trusted Clusters Services Applied Config
Trusted Clusters Attestation Services
Trusted Clusters Attestation Services Applied Config
Trusted Clusters Kms Services
Trusted Clusters Kms Services Applied Config
Vcenter
VM
POST
Clone Vm
Creates a virtual machine from an existing virtual machine. if you do not have all of the privileges described as follows: - The resource Datastore referenced by the attribute VM.DiskCloneSpec.datastore requires Datastore.AllocateSpace. - The resource Datastore referenced by the attribute VM.ClonePlacementSpec.datastore requires Datastore.AllocateSpace. - The resource Folder referenced by the attribute VM.ClonePlacementSpec.folder requires VirtualMachine.Inventory.CreateFromExisting. - The resource ResourcePool referenced by the attribute VM.ClonePlacementSpec.resource-pool requires Resource.AssignVMToPool. - The resource VirtualMachine referenced by the attribute VM.CloneSpec.source requires VirtualMachine.Provisioning.Clone.
POST
Clone Vm Async
Creates a virtual machine from an existing virtual machine. if you do not have all of the privileges described as follows: - The resource Datastore referenced by the attribute VM.DiskCloneSpec.datastore requires Datastore.AllocateSpace. - The resource Datastore referenced by the attribute VM.ClonePlacementSpec.datastore requires Datastore.AllocateSpace. - The resource Folder referenced by the attribute VM.ClonePlacementSpec.folder requires VirtualMachine.Inventory.CreateFromExisting. - The resource ResourcePool referenced by the attribute VM.ClonePlacementSpec.resource-pool requires Resource.AssignVMToPool. - The resource VirtualMachine referenced by the attribute VM.CloneSpec.source requires VirtualMachine.Provisioning.Clone.
POST
Create Vm
Creates a virtual machine. if you do not have all of the privileges described as follows: - The resource Folder referenced by the attribute VM.InventoryPlacementSpec.folder requires VirtualMachine.Inventory.Create. - The resource ResourcePool referenced by the attribute VM.ComputePlacementSpec.resource-pool requires Resource.AssignVMToPool. - The resource Datastore referenced by the attribute VM.StoragePlacementSpec.datastore requires Datastore.AllocateSpace. - The resource Network referenced by the attribute Ethernet.BackingSpec.network requires Network.Assign.
GET
List Vm
Returns information about at most 4000 visible (subject to permission checks) virtual machines in vCenter matching the VM.FilterSpec.
DELETE
Delete Vm
Deletes a virtual machine. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Inventory.Delete.
GET
Get Vm
Returns information about a virtual machine. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the parameter vm requires System.Read.
POST
Instant Clone Vm
Create an instant clone of an existing virtual machine. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the attribute VM.InstantCloneSpec.source requires VirtualMachine.Provisioning.Clone and VirtualMachine.Inventory.CreateFromExisting. - The resource Folder referenced by the attribute VM.InstantClonePlacementSpec.folder requires VirtualMachine.Interact.PowerOn. - The resource ResourcePool referenced by the attribute VM.InstantClonePlacementSpec.resource-pool requires Resource.AssignVMToPool. - The resource Datastore referenced by the attribute VM.InstantClonePlacementSpec.datastore requires Datastore.AllocateSpace. - The resource Network referenced by the attribute Ethernet.BackingSpec.network requires Network.Assign.
POST
Register Vm
Creates a virtual machine from existing virtual machine files on storage. if you do not have all of the privileges described as follows: - The resource Datastore referenced by the attribute VM.RegisterSpec.datastore requires System.Read. - The resource Folder referenced by the attribute VM.InventoryPlacementSpec.folder requires VirtualMachine.Inventory.Register. - The resource ResourcePool referenced by the attribute VM.ComputePlacementSpec.resource-pool requires Resource.AssignVMToPool.
POST
Relocate Vm
Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the parameter vm requires Resource.ColdMigrate. - The resource ResourcePool referenced by the attribute VM.RelocatePlacementSpec.resource-pool requires Resource.AssignVMToPool.
POST
Relocate Vm Async
Relocates a virtual machine based on the specification. The parts of the virtual machine that can move are: FOLDER, RESOURCE_POOL, HOST, CLUSTER and DATASTORE of home of the virtual machine and disks. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the parameter vm requires Resource.ColdMigrate. - The resource ResourcePool referenced by the attribute VM.RelocatePlacementSpec.resource-pool requires Resource.AssignVMToPool.
POST
Unregister Vm
Removes the virtual machine corresponding to vm from the vCenter inventory without removing any of the virtual machine's files from storage. All high-level information stored with the management server (ESXi or vCenter) is removed, including information such as statistics, resource pool association, permissions, and alarms. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Inventory.Unregister.
Cluster
GET
Get Cluster
Retrieves information about the cluster corresponding to cluster.
GET
List Cluster
Returns information about at most 1000 visible (subject to permission checks) clusters in vCenter matching the Cluster.FilterSpec.
Datacenter
POST
Create Datacenter
Create a new datacenter in the vCenter inventory
GET
List Datacenter
Returns information about at most 1000 visible (subject to permission checks) datacenters in vCenter matching the Datacenter.FilterSpec.
DELETE
Delete Datacenter
Delete an empty datacenter from the vCenter Server
GET
Get Datacenter
Retrieves information about the datacenter corresponding to datacenter.
Datastore
GET
Get Datastore
Retrieves information about the datastore indicated by datastore.
GET
List Datastore
Returns information about at most 2500 visible (subject to permission checks) datastores in vCenter matching the Datastore.FilterSpec.
Deployment
GET
Get Deployment
Get the current status of the appliance deployment.
POST
Rollback Deployment
Rollback a failed appliance so it can be configured once again.
Host
POST
Create Host Connect
Connect to the host corresponding to host previously added to the vCenter server.
POST
Create Host
Add a new standalone host in the vCenter inventory. The newly connected host will be in connected state. The vCenter Server will verify the SSL certificate before adding the host to its inventory. In the case where the SSL certificate cannot be verified because the Certificate Authority is not recognized or the certificate is self signed, the vCenter Server will fall back to thumbprint verification mode as defined by Host.CreateSpec.ThumbprintVerification.
GET
List Host
Returns information about at most 2500 visible (subject to permission checks) hosts in vCenter matching the Host.FilterSpec.
DELETE
Delete Host
Remove a standalone host from the vCenter Server.
POST
Create Host Disconnect
Disconnect the host corresponding to host from the vCenter server
Resource Pool
POST
Create Resource Pool
Creates a resource pool. if you do not have all of the privileges described as follows: - The resource ResourcePool referenced by the attribute ResourcePool.CreateSpec.parent requires Resource.CreatePool.
GET
List Resource Pool
Returns information about at most 1000 visible (subject to permission checks) resource pools in vCenter matching the ResourcePool.FilterSpec.
DELETE
Delete Resource Pool
Deletes a resource pool.
GET
Get Resource Pool
Retrieves information about the resource pool indicated by resourcePool. if you do not have all of the privileges described as follows: - The resource ResourcePool referenced by the parameter resourcePool requires System.Read.
PATCH
Update Resource Pool
Updates the configuration of a resource pool. if you do not have all of the privileges described as follows: - The resource ResourcePool referenced by the parameter resourcePool requires Resource.EditPool.
Vcha
Cluster
POST
Deploy Vcha Cluster Async
Prepares, clones, and configures a VCHA cluster.
POST
Failover Vcha Cluster Async
Initiates failover from the active vCenter node to the passive node. For forced failover, Active node immediately initiates a failover. This may result into a data loss after failover. For planned failover, Active node flushes all the state to the Passive node, waits for the flush to complete before causing a failover. After the failover, Passive node starts without any data loss. A failover is allowed only in the following cases: 1. Cluster's mode is enabled and all cluster members are present. 2. Cluster's mode is maintenance and all cluster members are present.
POST
Get Vcha Cluster
Retrieves the status of a VCHA cluster.
POST
Undeploy Vcha Cluster Async
Destroys the VCHA cluster and removes all VCHA specific information from the VCVA appliance. Optionally, the passive and witness node virtual machines will be deleted only if VCHA was deployed using automatic deployment. The active node in the cluster continues to run as a standalone VCVA appliance after the destroy operation has been performed. If the VCHA cluster is in a transition state and not configured, then the VCHA cluster specific information is removed.
Operations
GET
Get Vcha Operations
Retrieves the current active and disabled operations of a VCHA cluster.
Cluster Active
POST
Get Cluster Active
Retrieves information about the active node of a VCHA cluster.
Cluster Deployment Type
GET
Get Vcha Cluster Deployment Type
Retrieves the deployment type of a VCHA cluster.
Cluster Mode
GET
Get Vcha Cluster Mode
Retrieves the current mode of a VCHA cluster.
PUT
Set Cluster Mode Async
Manipulates the mode of a VCHA Cluster. Following mode transitions are allowed: enabled -> disabled - Allowed only in healthy and degraded states. enabled -> maintenance - Allowed only in healthy state. disabled -> enabled - Allowed only in healthy state. maintenance -> enabled - Allowed only in healthy state with all nodes are running the same version. maintenance -> disabled - Allowed only in healthy state with all nodes are running the same version. All other transitions are not allowed. VCHA Cluster configuration remains intact in any of the cluster modes.
Vm
Hardware
GET
Get Vm Hardware
Returns the virtual hardware settings of a virtual machine.
PATCH
Update Vm Hardware
Updates the virtual hardware settings of a virtual machine.
POST
Create Vm Hardware Action Upgrade
Upgrades the virtual machine to a newer virtual hardware version.
Identity
Library Item
GET
Get Vm Library Item
Returns the information about the library item associated with the virtual machine.
Power
GET
Get Vm Power
Returns the power state information of a virtual machine. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the parameter vm requires System.Read.
POST
Create Vm Power Reset
Resets a powered-on virtual machine. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Interact.Reset.
POST
Create Vm Power Start
Powers on a powered-off or suspended virtual machine. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Interact.PowerOn.
POST
Create Vm Power Stop
Powers off a powered-on or suspended virtual machine. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Interact.PowerOff.
POST
Create Vm Power Suspend
Suspends a powered-on virtual machine. if you do not have all of the privileges described as follows: - The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Interact.Suspend.
Tools
GET
Get Vm Tools
Get the properties of VMware Tools.
PATCH
Update Vm Tools
Update the properties of VMware Tools.
POST
Upgrade Vm Tools
Begins the Tools upgrade process. To monitor the status of the Tools upgrade, clients should check the Tools status by calling Tools.get and examining Tools.Info.version-status and Tools.Info.run-state.
Compute Policies
Guest Local Filesystem
GET
Get Vm Guest Local Filesystem
Returns details of the local file systems in the guest operating system.
Guest Networking
GET
Get Vm Guest Networking
Returns information about the network configuration in the guest operating system.
Guest Power
GET
Get Vm Guest Power
Returns information about the guest operating system power state.
POST
Reboot Vm Guest Power
Issues a request to the guest operating system asking it to perform a reboot. This request returns immediately and does not wait for the guest operating system to complete the operation.
POST
Shutdown Vm Guest Power
Issues a request to the guest operating system asking it to perform a clean shutdown of all services. This request returns immediately and does not wait for the guest operating system to complete the operation.
POST
Standby Vm Guest Power
Issues a request to the guest operating system asking it to perform a suspend operation.
Guest Networking Interfaces
GET
List Vm Guest Networking Interfaces
Returns information about the networking interfaces in the guest operating system.
Guest Networking Routes
GET
List Vm Guest Networking Routes
Returns information about network routing in the guest operating system.
Hardware Boot
GET
Get Vm Hardware Boot
Returns the boot-related settings of a virtual machine.
PATCH
Update Vm Hardware Boot
Updates the boot-related settings of a virtual machine.
Hardware Cdrom
POST
Create Vm Cdrom Hardware Connect
Connects a virtual CD-ROM device of a powered-on virtual machine to its backing. Connecting the virtual device makes the backing accessible from the perspective of the guest operating system. For a powered-off virtual machine, the Cdrom.update operation may be used to configure the virtual CD-ROM device to start in the connected state when the virtual machine is powered on.
POST
Create Vm Hardware Cdrom
Adds a virtual CD-ROM device to the virtual machine.
GET
List Vm Hardware Cdrom
Returns commonly used information about the virtual CD-ROM devices belonging to the virtual machine.
DELETE
Delete Vm Cdrom Hardware
Removes a virtual CD-ROM device from the virtual machine.
GET
Get Vm Cdrom Hardware
Returns information about a virtual CD-ROM device.
PATCH
Update Vm Cdrom Hardware
Updates the configuration of a virtual CD-ROM device.
POST
Create Vm Cdrom Hardware Disconnect
Disconnects a virtual CD-ROM device of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the CD-ROM device is not connected to its backing resource. For a powered-off virtual machine, the Cdrom.update operation may be used to configure the virtual CD-ROM device to start in the disconnected state when the virtual machine is powered on.
Hardware Cpu
GET
Get Vm Hardware Cpu
Returns the CPU-related settings of a virtual machine.
PATCH
Update Vm Hardware Cpu
Updates the CPU-related settings of a virtual machine.
Hardware Disk
POST
Create Vm Hardware Disk
Adds a virtual disk to the virtual machine. While adding the virtual disk, a new VMDK file may be created or an existing VMDK file may be used to back the virtual disk.
GET
List Vm Hardware Disk
Returns commonly used information about the virtual disks belonging to the virtual machine.
DELETE
Delete Vm Disk Hardware
Removes a virtual disk from the virtual machine. This operation does not destroy the VMDK file that backs the virtual disk. It only detaches the VMDK file from the virtual machine. Once detached, the VMDK file will not be destroyed when the virtual machine to which it was associated is deleted.
GET
Get Vm Disk Hardware
Returns information about a virtual disk.
PATCH
Update Vm Disk Hardware
Updates the configuration of a virtual disk. An update operation can be used to detach the existing VMDK file and attach another VMDK file to the virtual machine.
Hardware Ethernet
POST
Create Vm Nic Ethernet Connect
Connects a virtual Ethernet adapter of a powered-on virtual machine to its backing. Connecting the virtual device makes the backing accessible from the perspective of the guest operating system. For a powered-off virtual machine, the Ethernet.update operation may be used to configure the virtual Ethernet adapter to start in the connected state when the virtual machine is powered on.
POST
Create Vm Hardware Ethernet
Adds a virtual Ethernet adapter to the virtual machine.
GET
List Vm Hardware Ethernet
Returns commonly used information about the virtual Ethernet adapters belonging to the virtual machine.
DELETE
Delete Vm Nic Hardware Ethernet
Removes a virtual Ethernet adapter from the virtual machine.
GET
Get Vm Nic Hardware Ethernet
Returns information about a virtual Ethernet adapter.
PATCH
Update Vm Nic Hardware Ethernet
Updates the configuration of a virtual Ethernet adapter.
POST
Create Vm Nic Ethernet Disconnect
Disconnects a virtual Ethernet adapter of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the Ethernet adapter is not connected to its backing resource. For a powered-off virtual machine, the Ethernet.update operation may be used to configure the virtual Ethernet adapter to start in the disconnected state when the virtual machine is powered on.
Hardware Floppy
POST
Create Vm Floppy Hardware Connect
Connects a virtual floppy drive of a powered-on virtual machine to its backing. Connecting the virtual device makes the backing accessible from the perspective of the guest operating system. For a powered-off virtual machine, the Floppy.update operation may be used to configure the virtual floppy drive to start in the connected state when the virtual machine is powered on.
POST
Create Vm Hardware Floppy
Adds a virtual floppy drive to the virtual machine.
GET
List Vm Hardware Floppy
Returns commonly used information about the virtual floppy drives belonging to the virtual machine.
DELETE
Delete Vm Floppy Hardware
Removes a virtual floppy drive from the virtual machine.
GET
Get Vm Floppy Hardware
Returns information about a virtual floppy drive.
PATCH
Update Vm Floppy Hardware
Updates the configuration of a virtual floppy drive.
POST
Create Vm Floppy Hardware Disconnect
Disconnects a virtual floppy drive of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the floppy drive is not connected to its backing resource. For a powered-off virtual machine, the Floppy.update operation may be used to configure the virtual floppy floppy to start in the disconnected state when the virtual machine is powered on.
Hardware Memory
GET
Get Vm Hardware Memory
Returns the memory-related settings of a virtual machine.
PATCH
Update Vm Hardware Memory
Updates the memory-related settings of a virtual machine.
Hardware Parallel
POST
Create Vm Port Parallel Connect
Connects a virtual parallel port of a powered-on virtual machine to its backing. Connecting the virtual device makes the backing accessible from the perspective of the guest operating system. For a powered-off virtual machine, the Parallel.update operation may be used to configure the virtual parallel port to start in the connected state when the virtual machine is powered on.
POST
Create Vm Hardware Parallel
Adds a virtual parallel port to the virtual machine.
GET
List Vm Hardware Parallel
Returns commonly used information about the virtual parallel ports belonging to the virtual machine.
DELETE
Delete Vm Port Hardware Parallel
Removes a virtual parallel port from the virtual machine.
GET
Get Vm Port Hardware Parallel
Returns information about a virtual parallel port.
PATCH
Update Vm Port Hardware Parallel
Updates the configuration of a virtual parallel port.
POST
Create Vm Port Parallel Disconnect
Disconnects a virtual parallel port of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the parallel port is not connected to its backing. For a powered-off virtual machine, the Parallel.update operation may be used to configure the virtual parallel port to start in the disconnected state when the virtual machine is powered on.
Hardware Serial
POST
Create Vm Port Serial Connect
Connects a virtual serial port of a powered-on virtual machine to its backing. Connecting the virtual device makes the backing accessible from the perspective of the guest operating system. For a powered-off virtual machine, the Serial.update operation may be used to configure the virtual serial port to start in the connected state when the virtual machine is powered on.
POST
Create Vm Hardware Serial
Adds a virtual serial port to the virtual machine.
GET
List Vm Hardware Serial
Returns commonly used information about the virtual serial ports belonging to the virtual machine.
DELETE
Delete Vm Port Hardware Serial
Removes a virtual serial port from the virtual machine.
GET
Get Vm Port Hardware Serial
Returns information about a virtual serial port.
PATCH
Update Vm Port Hardware Serial
Updates the configuration of a virtual serial port.
POST
Create Vm Port Serial Disconnect
Disconnects a virtual serial port of a powered-on virtual machine from its backing. The virtual device is still present and its backing configuration is unchanged, but from the perspective of the guest operating system, the serial port is not connected to its backing. For a powered-off virtual machine, the Serial.update operation may be used to configure the virtual serial port to start in the disconnected state when the virtual machine is powered on.
Hardware Adapter Sata
POST
Create Vm Hardware Adapter Sata
Adds a virtual SATA adapter to the virtual machine.
GET
List Vm Hardware Adapter Sata
Returns commonly used information about the virtual SATA adapters belonging to the virtual machine.
DELETE
Delete Vm Adapter Hardware Sata
Removes a virtual SATA adapter from the virtual machine.
GET
Get Vm Adapter Hardware Sata
Returns information about a virtual SATA adapter.
Hardware Adapter Scsi
POST
Create Vm Hardware Adapter Scsi
Adds a virtual SCSI adapter to the virtual machine.
GET
List Vm Hardware Adapter Scsi
Returns commonly used information about the virtual SCSI adapters belonging to the virtual machine.
DELETE
Delete Vm Adapter Hardware Scsi
Removes a virtual SCSI adapter from the virtual machine.
GET
Get Vm Adapter Hardware Scsi
Returns information about a virtual SCSI adapter.
PATCH
Update Vm Adapter Hardware Scsi
Updates the configuration of a virtual SCSI adapter.
Hardware Boot Device
GET
Get Vm Hardware Boot Device
Returns an ordered list of boot devices for the virtual machine. If the list is empty, the virtual machine uses a default boot sequence.
PUT
Set Vm Hardware Boot Device
Sets the virtual devices that will be used to boot the virtual machine. The virtual machine will check the devices in order, attempting to boot from each, until the virtual machine boots successfully. If the list is empty, the virtual machine will use a default boot sequence. There should be no more than one instance of Device.Entry for a given device type except ETHERNET in the list.
Storage Policy
GET
Get Vm Storage Policy
Returns Information about Storage Policy associated with a virtual machine's home directory and/or its virtual hard disks.
PATCH
Update Vm Storage Policy
Updates the storage policy configuration of a virtual machine and/or its associated virtual hard disks.
Storage Policy Compliance
POST
Check Vm Policy Compliance
Returns the storage policy Compliance Compliance.Info of a virtual machine after explicitly re-computing compliance check.
GET
Get Vm Storage Policy Compliance
Returns the cached storage policy compliance information of a virtual machine.
Tools Installer
POST
Connect Vm Tools Installer
Connects the VMware Tools CD installer as a CD-ROM for the guest operating system. On Windows guest operating systems with autorun, this should cause the installer to initiate the Tools installation which will need user input to complete. On other (non-Windows) guest operating systems this will make the Tools installation available, and a a user will need to do guest-specific actions. On Linux, this includes opening an archive and running the installer. To monitor the status of the Tools install, clients should check the Tools.Info.version-status and Tools.Info.run-state from Tools.get
POST
Disconnect Vm Tools Installer
Disconnect the VMware Tools installer CD image.
GET
Get Vm Tools Installer
Get information about the VMware Tools installer.
Vm Template
Library Items
POST
Create Vm Template Library Items
Creates a library item in content library from a virtual machine. This operation creates a library item in content library whose content is a virtual machine template created from the source virtual machine, using the supplied create specification. The virtual machine template is stored in a newly created library item. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.Library referenced by the attribute LibraryItems.CreateSpec.library requires ContentLibrary.AddLibraryItem. - The resource VirtualMachine referenced by the attribute LibraryItems.CreateSpec.source-vm requires System.Read. - The resource Datastore referenced by the attribute LibraryItems.CreateSpecVmHomeStorage.datastore requires System.Read. - The resource com.vmware.spbm.StorageProfile referenced by the attribute LibraryItems.CreateSpecVmHomeStoragePolicy.policy requires System.Read. - The resource Datastore referenced by the attribute LibraryItems.CreateSpecDiskStorage.datastore requires System.Read. - The resource com.vmware.spbm.StorageProfile referenced by the attribute LibraryItems.CreateSpecDiskStoragePolicy.policy requires System.Read. - The resource com.vmware.vcenter.vm.hardware.Disk referenced by the map key of attribute LibraryItems.CreateSpec.disk-storage-overrides requires System.Read. - The resource Folder referenced by the attribute LibraryItems.CreatePlacementSpec.folder requires System.Read. - The resource ResourcePool referenced by the attribute LibraryItems.CreatePlacementSpec.resource-pool requires System.Read. - The resource HostSystem referenced by the attribute LibraryItems.CreatePlacementSpec.host requires System.Read. - The resource ClusterComputeResource referenced by the attribute LibraryItems.CreatePlacementSpec.cluster requires System.Read.
POST
Deploy Template Library Item Library Items
Deploys a virtual machine as a copy of the source virtual machine template contained in the library item specified by templateLibraryItem. It uses the deployment specification in spec. If LibraryItems.DeploySpec.powered-on and/or LibraryItems.DeploySpec.guest-customization are specified, the server triggers the power on and/or guest customization operations, which are executed asynchronously. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires VirtualMachine.Provisioning.DeployTemplate. - The resource Datastore referenced by the attribute LibraryItems.DeploySpecVmHomeStorage.datastore requires System.Read. - The resource com.vmware.spbm.StorageProfile referenced by the attribute LibraryItems.DeploySpecVmHomeStoragePolicy.policy requires System.Read. - The resource Datastore referenced by the attribute LibraryItems.DeploySpecDiskStorage.datastore requires System.Read. - The resource com.vmware.spbm.StorageProfile referenced by the attribute LibraryItems.DeploySpecDiskStoragePolicy.policy requires System.Read. - The resource com.vmware.vcenter.vm.hardware.Disk referenced by the map key of attribute LibraryItems.DeploySpec.disk-storage-overrides requires System.Read. - The resource Folder referenced by the attribute LibraryItems.DeployPlacementSpec.folder requires System.Read. - The resource ResourcePool referenced by the attribute LibraryItems.DeployPlacementSpec.resource-pool requires System.Read. - The resource HostSystem referenced by the attribute LibraryItems.DeployPlacementSpec.host requires System.Read. - The resource ClusterComputeResource referenced by the attribute LibraryItems.DeployPlacementSpec.cluster requires System.Read. - The resource com.vmware.vcenter.vm.hardware.Ethernet referenced by the map key of attribute LibraryItems.HardwareCustomizationSpec.nics requires System.Read. - The resource Network referenced by the attribute LibraryItems.EthernetUpdateSpec.network requires System.Read. - The resource com.vmware.vcenter.vm.hardware.Disk referenced by the attribute LibraryItems.HardwareCustomizationSpec.disks-to-remove requires System.Read. - The resource com.vmware.vcenter.vm.hardware.Disk referenced by the map key of attribute LibraryItems.HardwareCustomizationSpec.disks-to-update requires System.Read.
GET
Get Template Library Item Vm Template
Returns information about a virtual machine template contained in the library item specified by templateLibraryItem if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires System.Read.
Library Items Check Outs
POST
Check In Template Library Item Vm Check Outs
Checks in a virtual machine into the library item. This operation updates the library item to contain the virtual machine being checked in as a template. This template becomes the latest version of the library item. The previous virtual machine template contained in the library item is available as a backup and its information can be queried using the Versions service. At most one previous version of a virtual machine template is retained in the library item. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires ContentLibrary.CheckInTemplate. - The resource VirtualMachine referenced by the parameter vm requires System.Read.
POST
Check Out Template Library Item Check Outs
Checks out a library item containing a virtual machine template. This operation makes a copy of the source virtual machine template contained in the library item as a virtual machine. The virtual machine is copied with the same storage specification as the source virtual machine template. Changes to the checked out virtual machine do not affect the virtual machine template contained in the library item. To save these changes back into the library item, CheckOuts.check-in the virtual machine. To discard the changes, CheckOuts.delete the virtual machine. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires ContentLibrary.CheckOutTemplate. - The resource Folder referenced by the attribute CheckOuts.PlacementSpec.folder requires System.Read. - The resource ResourcePool referenced by the attribute CheckOuts.PlacementSpec.resource-pool requires System.Read. - The resource HostSystem referenced by the attribute CheckOuts.PlacementSpec.host requires System.Read. - The resource ClusterComputeResource referenced by the attribute CheckOuts.PlacementSpec.cluster requires System.Read.
DELETE
Delete Template Library Item Vm Vm Template Check Outs
Deletes the checked out virtual machine. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource VirtualMachine referenced by the parameter vm requires VirtualMachine.Inventory.Delete. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires System.Read.
GET
Get Template Library Item Vm Vm Template Check Outs
Returns the information about a checked out virtual machine. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires System.Read. - The resource VirtualMachine referenced by the parameter vm requires System.Read.
GET
List Template Library Item Vm Template Check Outs
Returns commonly used information about the virtual machines that are checked out of the library item. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires System.Read.
Library Items Versions
DELETE
Delete Template Library Item Version Vm Template
Deletes the virtual machine template contained in the library item at the specified version. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires ContentLibrary.DeleteLibraryItem. - The resource com.vmware.content.library.item.Version referenced by the parameter version requires System.Read.
GET
Get Template Library Item Version Vm Template
Returns information about the live version of a library item containing a virtual machine template. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires System.Read. - The resource com.vmware.content.library.item.Version referenced by the parameter version requires System.Read.
GET
List Template Library Item Vm Template Versions
Returns commonly used information about the live versions of a virtual machine template library item. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires System.Read.
POST
Rollback Template Library Item Version
Rollbacks a library item containing a virtual machine template to a previous version. The virtual machine template at the specified version becomes the latest virtual machine template with a new version identifier. if you do not have all of the privileges described as follows: - Operation execution requires System.Read. - The resource com.vmware.content.library.Item referenced by the parameter templateLibraryItem requires ContentLibrary.CheckInTemplate. - The resource com.vmware.content.library.item.Version referenced by the parameter version requires System.Read.