vastai search network-volumes

Search for network volume offers using custom query

Usage

vastai search network volumes [--help] [--api-key API_KEY] [--raw] <query>

Arguments

query · string · required

Query to search for. default: ‘external=false verified=true disk_space>=1’, pass -n to ignore default

Options

-n · boolean

Disable default query (alias: --no-default)

--limit · integer

--storage · number · default: "1.0"

Amount of storage to use for pricing, in GiB. default=1.0GiB

-o · string · default: "score-"

Comma-separated list of fields to sort on. postfix field with - to sort desc. ex: -o ‘disk_space,inet_up-’. default=‘score-’ (alias: --order)

Description

Query syntax:

query = comparison comparison… comparison = field op value field = <name of a field> op = one of: <, <=, ==, !=, >=, >, in, notin value = <bool, int, float, string> | ‘any’ | [value0, value1, …] bool: True, False

note: to pass ’>’ and ’<’ on the command line, make sure to use quotes note: to encode a string query value (ie for gpu_name), replace any spaces ’ ’ with underscore ’_‘

Examples

# search for volumes with greater than 50GB of available storage and greater than 500 Mb/s upload and download speed
    vastai search volumes "disk_space>50 inet_up>500 inet_down>500"

Available fields:

      Name                  Type       Description
    duration:               float     max rental duration in days
    geolocation:            string    Two letter country code. Works with operators =, !=, in, notin (e.g. geolocation not in ['XV','XZ'])
    id:                     int       volume offer unique ID
    inet_down:              float     internet download speed in Mb/s
    inet_up:                float     internet upload speed in Mb/s
    reliability:            float     machine reliability score (see FAQ for explanation)
    storage_cost:           float     storage cost in $/GB/month
    verified:               bool      is the machine verified

Global Options

The following options are available for all commands:

Option	Description
--url URL	Server REST API URL
--retry N	Retry limit
--raw	Output machine-readable JSON
--explain	Verbose explanation of API calls
--api-key KEY	API key (defaults to ~/.config/vastai/vast_api_key)