Back to top

Volumes

Volume Management (Block Storage)

Retrieve all volumes
GET
/projects/{id}/storage

Returns a list of the current projects’s volumes.

  • Parameters
  • id
    string  (required) in path

    Project UUID

    include
    string in query

    related attributes to include

    page
    integer in query

    page to display, default to 1, max 100_000

    per_page
    integer in query

    items per page, default to 10, max 1_000

  •  
  • Response Body Show Hide
  • Request URL Show Hide
  • cURL Show Hide
  • Response  200   ok
  • {
    	"volumes": [
    		{
    			"id": "string",
    			"name": "string",
    			"description": "string",
    			"size": "integer",
    			"locked": "boolean",
    			"billing_cycle": "string",
    			"state": "string",
    			"created_at": "string",
    			"updated_at": "string",
    			"project": {
    				"href": "string"
    			},
    			"facility": {
    				"href": "string"
    			},
    			"snapshot_policies": [
    				{
    					"href": "string"
    				}
    			],
    			"attachments": [
    				{
    					"href": "string"
    				}
    			],
    			"plan": {
    				"id": "string",
    				"slug": "string",
    				"name": "string",
    				"description": "string",
    				"line": "string",
    				"specs": "object",
    				"pricing": "object",
    				"available_in": [
    					{
    						"href": "string"
    					}
    				]
    			},
    			"href": "string"
    		}
    	],
    	"meta": {
    		"first": {
    			"href": "string"
    		},
    		"previous": {
    			"href": "string"
    		},
    		"self": {
    			"href": "string"
    		},
    		"next": {
    			"href": "string"
    		},
    		"last": {
    			"href": "string"
    		},
    		"total": "integer"
    	}
    }
  • Response  401   unauthorized
  • Response  403   forbidden
  • Response  404   not found
Create a volume
/projects/{id}/storage

Creates a new volume in our datacenter.

  • Parameters
  • id
    string  (required) in path

    Project UUID

    volume
     (required) in body

    Volume to create

    {
    	"description": "string",
    	"size": "integer",
    	"locked": "boolean",
    	"billing_cycle": "string",
    	"snapshot_policies": {
    		"$ref": "#\/definitions\/SnapshotPolicyInput"
    	}
    }
  • Response  201   created
  • {
    	"id": "string",
    	"name": "string",
    	"description": "string",
    	"size": "integer",
    	"locked": "boolean",
    	"billing_cycle": "string",
    	"state": "string",
    	"created_at": "string",
    	"updated_at": "string",
    	"project": {
    		"href": "string"
    	},
    	"facility": {
    		"href": "string"
    	},
    	"snapshot_policies": [
    		{
    			"href": "string"
    		}
    	],
    	"attachments": [
    		{
    			"href": "string"
    		}
    	],
    	"plan": {
    		"id": "string",
    		"slug": "string",
    		"name": "string",
    		"description": "string",
    		"line": "string",
    		"specs": "object",
    		"pricing": "object",
    		"available_in": {
    			"type": "array",
    			"items": {
    				"$ref": "#\/definitions\/Href"
    			}
    		}
    	},
    	"href": "string"
    }
  • Response  401   unauthorized
  • Response  403   forbidden
  • Response  404   not found
  • Response  422   unprocessable entity
Retrieve a volume
GET
/storage/{id}

Returns a single volume if the user has access

  • Parameters
  • id
    string  (required) in path

    Volume UUID

    include
    string in query

    related attributes to include

  •  
  • Response Body Show Hide
  • Request URL Show Hide
  • cURL Show Hide
  • Response  200   ok
  • {
    	"id": "string",
    	"name": "string",
    	"description": "string",
    	"size": "integer",
    	"locked": "boolean",
    	"billing_cycle": "string",
    	"state": "string",
    	"created_at": "string",
    	"updated_at": "string",
    	"project": {
    		"href": "string"
    	},
    	"facility": {
    		"href": "string"
    	},
    	"snapshot_policies": [
    		{
    			"href": "string"
    		}
    	],
    	"attachments": [
    		{
    			"href": "string"
    		}
    	],
    	"plan": {
    		"id": "string",
    		"slug": "string",
    		"name": "string",
    		"description": "string",
    		"line": "string",
    		"specs": "object",
    		"pricing": "object",
    		"available_in": {
    			"type": "array",
    			"items": {
    				"$ref": "#\/definitions\/Href"
    			}
    		}
    	},
    	"href": "string"
    }
  • Response  401   unauthorized
  • Response  403   forbidden
  • Response  404   not found
Update the volume
PUT
/storage/{id}

Updates the volume.

  • Parameters
  • id
    string  (required) in path

    Volume UUID

    volume
     (required) in body

    Volume to update

    {
    	"description": "string",
    	"size": "integer",
    	"locked": "boolean",
    	"billing_cycle": "string"
    }
  • Response  200   ok
  • {
    	"id": "string",
    	"name": "string",
    	"description": "string",
    	"size": "integer",
    	"locked": "boolean",
    	"billing_cycle": "string",
    	"state": "string",
    	"created_at": "string",
    	"updated_at": "string",
    	"project": {
    		"href": "string"
    	},
    	"facility": {
    		"href": "string"
    	},
    	"snapshot_policies": [
    		{
    			"href": "string"
    		}
    	],
    	"attachments": [
    		{
    			"href": "string"
    		}
    	],
    	"plan": {
    		"id": "string",
    		"slug": "string",
    		"name": "string",
    		"description": "string",
    		"line": "string",
    		"specs": "object",
    		"pricing": "object",
    		"available_in": {
    			"type": "array",
    			"items": {
    				"$ref": "#\/definitions\/Href"
    			}
    		}
    	},
    	"href": "string"
    }
  • Response  401   unauthorized
  • Response  403   forbidden
  • Response  404   not found
  • Response  422   unprocessable entity
Delete the volume
/storage/{id}

Deletes the volume.

  • Parameters
  • id
    string  (required) in path

    Volume UUID

  • Response  204   no content
  • Response  401   unauthorized
  • Response  403   forbidden
  • Response  404   not found
Restore volume
/storage/{id}/restore

Restore the volume to the given snapshot.

  • Parameters
  • id
    string  (required) in path

    Volume UUID

    restore_point
    string  (required) in query

    restore point

  • Response  200   ok
  • {
    	"id": "string",
    	"name": "string",
    	"description": "string",
    	"size": "integer",
    	"locked": "boolean",
    	"billing_cycle": "string",
    	"state": "string",
    	"created_at": "string",
    	"updated_at": "string",
    	"project": {
    		"href": "string"
    	},
    	"facility": {
    		"href": "string"
    	},
    	"snapshot_policies": [
    		{
    			"href": "string"
    		}
    	],
    	"attachments": [
    		{
    			"href": "string"
    		}
    	],
    	"plan": {
    		"id": "string",
    		"slug": "string",
    		"name": "string",
    		"description": "string",
    		"line": "string",
    		"specs": "object",
    		"pricing": "object",
    		"available_in": {
    			"type": "array",
    			"items": {
    				"$ref": "#\/definitions\/Href"
    			}
    		}
    	},
    	"href": "string"
    }
  • Response  401   unauthorized
  • Response  403   forbidden
  • Response  404   not found
  • Response  422   unprocessable entity
Clone volume/snapshot
/storage/{id}/clone

Clone your volume or snapshot into a new volume. To clone the volume, send an empty body. To promote a volume snapshot into a new volume, include the snapshot_timestamp attribute in the request body.

  • Parameters
  • id
    string  (required) in path

    Volume UUID

    snapshot_timestamp
    string in query

    snapshot timestamp

  • Response  201   created
  • {
    	"id": "string",
    	"name": "string",
    	"description": "string",
    	"size": "integer",
    	"locked": "boolean",
    	"billing_cycle": "string",
    	"state": "string",
    	"created_at": "string",
    	"updated_at": "string",
    	"project": {
    		"href": "string"
    	},
    	"facility": {
    		"href": "string"
    	},
    	"snapshot_policies": [
    		{
    			"href": "string"
    		}
    	],
    	"attachments": [
    		{
    			"href": "string"
    		}
    	],
    	"plan": {
    		"id": "string",
    		"slug": "string",
    		"name": "string",
    		"description": "string",
    		"line": "string",
    		"specs": "object",
    		"pricing": "object",
    		"available_in": {
    			"type": "array",
    			"items": {
    				"$ref": "#\/definitions\/Href"
    			}
    		}
    	},
    	"href": "string"
    }
  • Response  401   unauthorized
  • Response  403   forbidden
  • Response  404   not found
  • Response  422   unprocessable entity