Skip to main content

Increase Root Storage

Grows the node's root disk to the requested size. Root disk expansion is online (no reboot required) but the filesystem may need to be resized inside the OS after the action completes.

PUT/api/v1/nodes/{node_id}/root-storage-upgrade/

Path parameters

  • node_idPathstringrequired

    Path parameter node_id.

Query parameters

  • project_idQuerystringoptional

    Identifier of the project to scope the request to. Optional; if omitted, the account's default project is used.

    • optional
    • if omitted, the request is applied to the default project
    example{{project_id}}
  • apikeyQuerystringoptional

    API key used to authenticate the request

    • required
    • must be a valid API key string
    example{{api_key}}
  • locationQuerystringoptional

    Region of the node whose root storage is being increased.

    • must be a non-empty string
    • should be a valid location identifier (e.g., region code)
    example{{location}}

Request body

application/json

object
disk_sizeintegerrequired

New root disk size in gigabytes. Must be strictly greater than the current root disk size. Root disk shrinking is not supported.

example125
  • required
  • positive integer
  • must be greater than the node's current root disk size

Responses

200Successful response
object
codeinteger

HTTP status code of the increase-root-storage operation.

example200
  • integer between 100 and 599
dataobject
errorsobject
messagestring

Status message for the root storage increase.

exampleRoot disk size upgrade in progress.
  • non-empty string
  • maximum length 256 characters