Detach Persistent Disk

Detach Persistent Disk

At least one of the listed privileges is required -

Privileges	Description
UDD_MANAGEMENT	Caller should have permission to this privilege, on the associated access group of persistent disk and machine to perform detach operation.
MACHINE_MANAGEMENT	Caller should have permission to this privilege, on the associated access group of machine to perform detach operation if detaching a primary disk.

Request

URI

POST

https://{api_host}/rest/inventory/v1/machines/{id}/action/detach-persistent-disk

COPY

Path Parameters

string

id

Required

ID of the machine

Request Body

MachinePersistentDiskDetachSpec of type(s) application/json

Required

{
    "archive_datastore_id": "datastore-44",
    "archive_datastore_path_id": "bd3ff8fc-b09a-47f7-917c-cc15c7301db6",
    "persistent_disk_id": "73560ad0-93d1-4a5b-bdf6-3fddc4b5fb1d"
}

string

archive_datastore_id

Optional

Datastore to which the persistent disk is to be archived.
If this is set, archive_datastore_path_id must also be set.
If unset, the persistent disk will be archived in place.

string

archive_datastore_path_id

Optional

Datastore path to which the persistent disk is to be archived.
If this is set, archive_datastore_id must also be set.
If unset, the persistent disk will be archived in place.

string

persistent_disk_id

Required

ID of persistent disk to be detached from the machine.

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

404

Not Found

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