Get A Writable Volume By ID

Get A Writable Volume By ID

Get a Writable Volume by ID

Request
URI
GET
https://{api_host}/cv_api/writables/{id}
COPY
Path Parameters
integer
id
Required

Writable Volume ID.


Responses
200

Returns the Writable Volume.

{
    "writable": {
        "id": 0,
        "name": "SNAPVOLUMES\test_user",
        "name_html": "SNAPVOLUMES\test_user",
        "title": "SNAPVOLUMES\test_user",
        "title_html": "SNAPVOLUMES\test_user",
        "owner": "<a href=\\\"/directory#/Users/2\\\" title=\\\"test_user\\\">TESTDOMAIN\\\\test_user</a>",
        "link": "/directory#/Users/2",
        "owner_name": "TestUser",
        "owner_type": "User",
        "owner_upn": "SNAPVOLUMES\test_user",
        "owner_upn_html": "SNAPVOLUMES\test_user",
        "description": "My writable volume",
        "created_at": "2016-11-23 13:10:13 -0800",
        "created_at_human": "Nov 23 2016",
        "updated_at": "2016-11-23 13:10:13 -0800",
        "updated_at_human": "Nov 23 2016",
        "mounted_at": "2016-11-23 13:10:13 -0800",
        "mounted_at_human": "Nov 23 2016",
        "mounted_on": "Machine <DESKTOP-VM123> (#{1234567812345678})",
        "mount_count": 0,
        "attached": "string",
        "status": "enabled",
        "block_login": true,
        "error_action": "string",
        "mount_prefix": "DESKTOP",
        "defer_create": true,
        "size_mb": 0,
        "template_version": "2.10.0.709",
        "datastore_name": "SSD Disk Array RAID8",
        "machine_manager_host": "0.0.0.0",
        "machine_manager_type": "Machine Manager",
        "path": "cloudvolumes/writable",
        "filename": "snapvolumes_test_user_15.vmdk",
        "file_location": "[SSD Disk Array RAID8] cloudvolumes/writable/snapvolumes_test_user_15.vmdk",
        "template_file_name": "[SSD Disk Array RAID8] cloudvolumes/writable_templates/template_uia_only_persistent.vmdk",
        "protected": true,
        "free_mb": 0,
        "total_mb": 0,
        "percent_available": "Unknown",
        "can_expand": true,
        "storage_group": "Storage group 1",
        "storage_group_members": 2,
        "primordial_os_id": 15,
        "primordial_os_name": "Windows 8.1 (x64)",
        "oses": [
            {
                "id": 0,
                "name": "Windows 8.1 (x64)"
            }
        ],
        "busy": false,
        "state": "Moving"
    }
}
writable
Optional

writable


400

ID missing from request.

{
    "error": "Missing parameters"
}
string
error
Optional

Failure details.


403

Session expired. Create a session and make the request with the _session_id cookie.

Returns UnauthorizedError of type(s) application/json
{
    "error": "Session expired. Please login again."
}
string
error
Optional

Session expired. Create a session using and make the request with the _session_id cookie.


404

Writable Volume was not found.

Operation doesn't return any data structure

500

Server error.

Returns ServerError of type(s) application/json
{
    "error": "Server Error",
    "detail": "Unexpected server error."
}
string
error
Optional

Server Error.

string
detail
Optional

Details of error. Exact error format subject to change depending on type of error.