API Reference

Vast API Gatekeeper

Resources & Endpoints

Update a volume

Update the specified valume's settings.

PATCH
https://aker.infra.katapult.io/v1/volumes/{volume}

If successful, this endpoint will return a 200 OK status.

Arguments

The following arguments are supported for this endpoint.

Name Type Default Value

volume Required

Volume Lookup None

allowed_hosts

Array of IPv4 addresses which are allowed to access the volume.

 IPv4Address Array None

size_limit

Hard size limit for volume in bytes.

 Integer None

inode_limit

Hard limit for number of inodes volume can use.

 Integer None

posix_acl

Should volume use POSIX ACL permissions?

 Boolean None

Potential Errors

The following errors may occur during this request.

Details HTTP status

vast_error

Received an unexpected response from VAST API

 500 Internal Server Error

vast_error

Received an unexpected response from VAST API

 500 Internal Server Error

vast_timeout

Request to Vast API timed out

 504 Gateway Timeout

vast_timeout

Request to Vast API timed out

 504 Gateway Timeout

Returned Object

When the request is successful, you can expect an object matching the specification below to be returned.

{
    volume: Volume {
        id: VolumeId
        path: String?
        allowed_hosts: [ IPv4Address? ]
        posix_acl: Boolean?
        size_limit: Integer?
        inode_limit: Integer?
        used_bytes: Integer?
        used_inodes: Integer?
        quota_state: String?
    }
}