Project / Volumes /

Update volume

Update volume mounts and storage size

Required permission

Project > Volumes > General > Update

Path parameters

projectId
string required
ID of the project
volumeId
string required
ID of the volume

Request body

{object}

mounts
[array]
Array of mounts, containerMountPaths must be unique

{object}

volumeMountPath
string
Optionally specify the path inside this volume that should be mounted
pattern
^((?!\.\.).)*$
containerMountPath
string required
Specify the path into which the volume should be mounted
pattern
^((?!:).)*$

spec
{object}
backupSchedules
[array]

{object}

scheduling
{object} required
Schedule for the backup.

interval
string required
The interval between backups. Each addon can only have one backup schedule of each interval for each backup type.
one of
hourly, daily, weekly
minute
[array] required
An array of minutes when the backup should be performed.

integer
A minute when the backup should be performed.
min
0
max
59

hour
[array]
An array of hours in 24 hour format when the backup should be performed. At these hours, a backup will be performed at each of the minutes provided in the `minute` field. Required for `daily` and `weekly` intervals and unavailable for `hourly` intervals.

integer
An hour when the backup should be performed, in 24 hour format.
min
0
max
23

day
[array]
An array of days of the week when the backup should be performed, where `0` represents Monday and `6` represents Sunday. On these days, a backup will be performed at each of the minutes provided in the `minute` field whenever it is an hour from the `hour` field. Required for `weekly` intervals and unavailable for `hourly` and `daily` intervals.

integer
A day of the week when the backup should be performed, where `0` represents Monday and `6` represents Sunday.
min
0
max
6

retentionTime
integer required
The time the backup is retained for, in days.
min
1

Response body

{object}
Response object.

data
{object} required
Result data.

API

CLI

JS Client

POST /v1/projects/{projectId}/volumes/{volumeId}

POST /v1/teams/{teamId}/projects/{projectId}/volumes/{volumeId}

Example request

Request body

curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request POST \
  --data '{"mounts":[{"volumeMountPath":"","containerMountPath":"/container"}],"spec":{"storageSize":6144},"backupSchedules":[{"scheduling":{"interval":"weekly","minute":[30],"hour":[18],"day":[4]},"retentionTime":7}]}' \
  https://api.northflank.com/v1/projects/{projectId}/volumes/{volumeId}

Example response

200 OK

The operation was performed successfully.

JSON

{
  "data": {}
}