MAmachines
Volumes

Create Volume

Changed on

Create a volume for a specific app using the details provided in the request body.

post/v1/apps/{app_name}/volumes

Request

  • Base URL
    https://api.machines.dev
  • URL
    https://api.machines.dev/v1/apps/{app_name}/volumes
  • Auth
    HTTP bearer

Path parameters

app_namestring required

Fly App Name

Request body

auto_backup_enabledboolean

enable scheduled automatic snapshots. Defaults to true

compute_imagestring
encryptedboolean
fstypestring
namestring
regionstring
require_unique_zoneboolean
size_gbinteger
snapshot_idstring

restore from snapshot

snapshot_retentioninteger
source_volume_idstring

fork from remote volume

unique_zone_app_wideboolean

Response

OK

attached_alloc_idstring
attached_machine_idstring
auto_backup_enabledboolean
block_sizeinteger
blocksinteger
blocks_availinteger
blocks_freeinteger
bytes_totalinteger
bytes_usedinteger
created_atstring
encryptedboolean
fstypestring
host_featuresstring[]
host_status'ok' | 'unknown' | 'unreachable'
idstring
namestring
regionstring
required_host_featuresstring[]
size_gbinteger
snapshot_retentioninteger
statestring
type'local' | 'cache'
zonestring

Changes

  • b1988c8e4bd9Revision changes
    • info

      added the new optional request property /

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • f54480c4ce7fRevision changes
    • info

      endpoint added