HomeGuidesAPI Reference
CommunityWebsiteDocumentationExchangeSupportDeveloper
API Reference

Transfers Storage Volume Ownership

Transfers ownership of an unattached storage volume to a target tenant.

This operation requires the caller to be a master-tenant user holding the
admin-accounts permission with Full access. Lacking this is the most common
cause of a 403 Access Denied.

The target tenant may be specified using any one of the equivalent fields
tenant.id, account.id, owner.id, or accountId. The tenant.id form is
the canonical/preferred representation.

Behavior and constraints:

  • The volume must be unattached (status: "unattached" and not attached to any
    host or instance).
  • The volume's backing datastore must be accessible to the target tenant.
  • Transferring to the volume's current tenant is a no-op and returns success.

Related tenant-awareness changes apply to the storage volume list
(MORPH-12454) and get (MORPH-12455) endpoints.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
required

The id or uuid to identify the storage volume record.


The id of the storage volume record.

Body Params
storageVolume
object
required

Provide the target tenant using exactly one of the equivalent
fields below. tenant.id is the preferred form.

Responses

GET /api/storage-volumes/{id}), reflecting the new account/owner.

admin-accounts
permission at Full access.

Language
Credentials
Bearer
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json