Delete Machine

Delete Machine

At least one of the listed privileges is required -

Privileges	Description
MACHINE_MANAGEMENT	Caller should have permission to this privilege, on the associated access group of machine's desktop pool to delete the machine.
POOL_MANAGEMENT	Caller should have permission to this privilege, on the associated access group of machine's desktop pool to delete the machine.

Request

URI

DELETE

https://{api_host}/rest/inventory/v1/machines/{id}

COPY

Path Parameters

string

id

Required

id

Request Body

MachineDeleteData of type(s) application/json

Required

{
    "allow_delete_from_multi_desktop_pools": true,
    "archive_datastore_id": "855ea6c5-720a-41e1-96f4-958c90e6e424",
    "archive_datastore_path_id": "a219420d-4799-4517-8f78-39c74c7c4efc",
    "archive_persistent_disk": true,
    "delete_from_disk": true,
    "force_logoff_session": true
}

boolean

allow_delete_from_multi_desktop_pools

Optional

Determines whether the machines from different desktop pools can be deleted. This defaults to false in which case only machines belonging to single desktop pool can be deleted. If true, machines from different desktop pools can be deleted.

string

archive_datastore_id

Optional

Determines the datastore where the persistent user disk will be saved for future use. Both this as well as the archiveDatastorePathId need to be set. If this is unset and archivePersistentDisk is specified, the persistent disk is archived in place.

string

archive_datastore_path_id

Optional

Determines the location in the datastore where the persistent user disk will be saved for future use. If this is set, then archiveDatastoreId also needs to be specified.If this is unset and archivePersistentDisk is specified, the persistent disk is archived in place.

boolean

archive_persistent_disk

Optional

Determines whether to detach the persistent user disk and save it for future use. This can only be specified for linked-clone desktops with redirectWindowsProfile enabled, in which case it defaults to true.

boolean

delete_from_disk

Optional

Determines whether the Machine VM should be deleted from vCenter Server. This is only applicable for managed machines. This must always be true for machines in linked and instant clone desktops. This defaults to true for linked and instant clone machines and false for all other types. If this is true, then machine being deleted must not have any active user session, otherwise delete operation would fail.

boolean

force_logoff_session

Optional

Determines whether active session on the machine to be logged off before deletion. This is only applicable for managed machines. If true, active session on the machine will be logged off before Machine delete. Otherwise,it will result in an exception.

Authentication

This operation uses the following authentication methods.

Bearer

Responses

204

No Content

Operation doesn't return any data structure

400

Bad Request

Operation doesn't return any data structure

401

User is not authenticated

Operation doesn't return any data structure

403

Access to the resource is forbidden

Operation doesn't return any data structure

On This Page

Request

Path Parameters

204 Response Body

Errors

Inventory Operations

Add Custom Icon

Add Local Application Pools To GAE

Add Local Desktop Pools To GDE

Add Machines By Name

Add Rds Servers

Application Icon Bulk Associate

Application Icon Bulk Remove Association

Archive Machines

Assign Machine Aliases

Attach Persistent Disk

Cancel Agent Upgrades

Cancel Desktop Pool Task

Cancel Rds Server Agent Upgrades

Cancel Scheduled Maintenance

Cancel Scheduled Push Image

Check Application Pool Name Availability

Check Desktop Pool Name Availability

Check Farm Name Availability

Check Machine Prefix Availability

Check RDS Server Prefix Availability

Create Application Icon

Create Application Pool

Create Application Pool V2

Create Application Pool V3

Create Application Pool V5

Create Desktop Pool

Create Desktop Pool V2

Create Desktop Pool V7

Create Global Application Entitlement

Create Global Application Entitlement V3

Create Global Desktop Entitlement

Create Global Desktop Entitlement V2

Create Global Desktop Entitlement V3

Create Persistent Disk

Create Policy Overrides For Users

Delete Application Icon

Delete Application Pool

Delete Application Pools

Delete Application Pools V5

Delete Desktop Pool

Delete Desktop Pool V7

Delete Global Application Entitlement

Delete Global Application Entitlement V3

Delete Global Desktop Entitlement

Delete Global Desktop Entitlement V3

Delete Machines

Delete Persistent Disk

Delete Physical Machine

Delete Policy Overrides For Users

Delete RDS Server

Delete RDS Server V2

Desktop Pool Apply Image

Desktop Pool Promote Pending Image

Detach Persistent Disk

Disable Application Pools

Disable Desktop Pools

Disable Provisioning For Desktop Pools

Disconnect Global Sessions

Disconnect Sessions

Enable Application Pools

Enable Desktop Pools

Enable Provisioning For Desktop Pools

Enter Maintenance

Exit Maintenance

Farm Apply Image

Farm Promote Pending Image

Get Agent Installer Package

Get Agent Upgrade Task

Get Agent Upgrade Task V2

Get Application Icon

Get Application Pool

Get Application Pool V2

Get Application Pool V3

Get Application Pool V4

Get Application Pool V5

Get Desktop Pool

Get Desktop Pool Task

Get Desktop Pool V2

Get Desktop Pool V3

Get Desktop Pool V4

Get Desktop Pool V5

Get Desktop Pool V6

Get Desktop Pool V7

Get Global Application Entitlement

Get Global Application Entitlement V2

Get Global Application Entitlement V3

Get Global Desktop Entitlement

Get Global Desktop Entitlement V2

Get Global Desktop Entitlement V3

Get Persistent Disk

Get Physical Machine

Get Physical Machine V2

Get Rds Server Agent Upgrade Task

Get RDS Server V2

Get Session Info

List Agent Installer Packages

List Agent Upgrade Tasks

List Agent Upgrade Tasks V2

List Application Icons

List Application Pools

List Application Pools V2

List Application Pools V3

List Application Pools V4

List Application Pools V5

List App Volumes Applications On Farm

List Attachable Machines

List Category Folders

List Compatible Backup GA Es

List Compatible Backup GD Es

List Compatible Local Application Pools

List Compatible Local Desktop Pools

List Custom Application Icons

List Desktop Pools

List Desktop Pools V2

List Desktop Pools V3

List Desktop Pools V4

List Desktop Pools V5

List Desktop Pools V6

List Desktop Pools V7

List Desktop Pool Tasks

List Global Application Entitlements

List Global Application Entitlements V2

List Global Application Entitlements V3

List Global Desktop Entitlements

List Global Desktop Entitlements V2

List Global Desktop Entitlements V3

List Installed Applications On Desktop Pool

List Installed Applications On Farm

List Local Application Pools

List Local Desktop Pools

List Machines V2

List Machines V3

List Machines V4

List Machines V5

List Persistent Disks

List Physical Machines

List Physical Machines V2

List Policies On Desktop Pool

List Rds Server Agent Upgrade Tasks

List RDS Servers

List RDS Servers V2

List Session Info

List Unentitled Machines

List User Policies Overrides

Log Off Global Sessions

Log Off Sessions

Pause Desktop Pool Task

Query Global Sessions

Rebuild Machines

Recover Machines

Recover RDS Servers

Recreate From Persistent Disk

Register Agent Installer Package

Register Physical Machine

Register RDS Server

Remove Custom Icon

Remove Local Application Pools From GAE

Remove Local Desktop Pools From GDE

Remove Machines

Remove Rds Servers

Reset Global Sessions

Restart Global Sessions

Restart Machines

Restart Sessions

Resume Desktop Pool Task

Schedule Agent For Upgrade

Schedule Agent For Upgrade Rds Server

Schedule Agent For Upgrade V2

Schedule Maintenance

Schedule Maintenance V2

Schedule Push Image

Schedule Push Image V2

Send Message To Global Sessions

Send Message To Sessions

Unassign Machine Aliases

Unregister Agent Installer Package

Update Application Pool

Update Application Pool V2

Update Application Pool V3

Update Application Pool V5

Update Desktop Pool

Update Desktop Poolv7

Update Global Application Entitlement

Update Global Application Entitlement V3

Update Global Desktop Entitlement

Update Global Desktop Entitlement V3

Update Persistent Disk

Update Policy Overrides For Users

Update RDS Server

Update RDS Server V2

Updates Policies On Desktop Pool

Validate Installed Applications On Desktop Pool

Validate Installed Applications On Farm

Validate Specified Names