Skip to main content

shared drives

Paperspace Core API reference guide for shared drives.

list​

List information about all shared drives available to either the current authenticated user or the team, if the user belongs to a team. The list method takes an optional first argument to limit the returned network objects. Only team admins are able to list shared drives.

Examples​

curl --request POST \
--header 'Authorization: Bearer edc20a51d9b2145...' \
--header 'content-type: application/json' \
--url https://api.paperspace.com/graphql \
--data '{"query":"query SharedDrives($first: Int) {\n sharedDrives(first: $first) {\n nodes {\n id\n name\n mountPoint\n size\n username\n password\n region {\n name\n }\n }\n }\n}","variables":{"first":20}}'

Parameters​

NameTypeAttributesDescription
firstnumberNumber of shared drives to list
namestringoptionalName to match on
regionstringoptionalRegion to match on

Response​

Type object

{
"data": {
"sharedDrives": {
"nodes": [
{
"id": "sdvkpg3v2v",
"name": "Datasets",
"mountPoint": "\\\\10.64.92.2\\sdvkpg3v2v",
"size": 536870912000,
"username": "********",
"password": "********",
"region": {
"name": "East Coast (NY2)"
}
}
]
}
}
}

create​

Creates a new shared drive for the current team. Only team admins are able to create shared drives.

The provided networkId must match a network in the provided region that has available IP space.

Examples​

curl --request POST \
--header 'Authorization: Bearer edc20a51d9b2145...' \
--header 'content-type: application/json' \
--url https://api.paperspace.com/graphql \
--data '{"query":"mutation CreateSharedDrive($input: CreateSharedDriveInput!) {\n createSharedDrive(input: $input) {\n sharedDrive {\n id\n name\n }\n }\n}","variables":{"input":{"name":"Models","size":1000,"regionId":"West Coast (CA1)","networkId":"n123abc"}}}'

Parameters​

NameTypeAttributesDescription
namestringName of shared drive
sizenumberDesired size in GiB
regionstringRegion for shared drive
networkIdstringNetwork for shared drive

Response​

Type object

{
"data": {
"createSharedDrive": {
"sharedDrive": {
"id": "sdlpjdhzsc",
"name": "Models"
}
}
}
}

delete​

Deletes a shared drive belonging to the current team. Only team admins are able to delete shared drives.

Examples​

curl --request POST \
--header 'Authorization: Bearer edc20a51d9b2145...' \
--header 'content-type: application/json' \
--url https://api.paperspace.com/graphql \
--data '{"query":"mutation DeleteSharedDrive($input: DeleteSharedDriveInput!) {\n deleteSharedDrive(input: $input) {\n sharedDrive {\n id\n }\n }\n}","variables":{"input":{"id":"sdlpjdhzsc"}}}'

Parameters​

NameTypeAttributesDescription
idstringID of shared drive

Response​

Type object

{
"data": {
"deleteSharedDrive": {
"sharedDrive": {
"id": "sdlpjdhzsc"
}
}
}
}