Search for template results using custom query
Usage
vastai search templates [--help] [--api-key API_KEY] [--raw] <query>
Arguments
Search query in simple query syntax (see below)
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 somewhat reliable single RTX 3090 instances, filter out any duplicates or offers that conflict with our existing stopped instances
vastai search templates 'count_created > 100 creator_id in [38382,48982]'
Available fields:
Name Type Description
creator_id int ID of creator
created_at float time of initial template creation (UTC epoch timestamp)
count_created int #instances created (popularity)
default_tag string image default tag
docker_login_repo string image docker repository
id int template unique ID
image string image used for template
jup_direct bool supports jupyter direct
hash_id string unique hash ID of template
name string displayable name
recent_create_date float last time of instance creation (UTC epoch timestamp)
recommended_disk_space float min disk space required
recommended bool is templated on our recommended list
ssh_direct bool supports ssh direct
tag string image tag
use_ssh bool supports ssh (direct or proxy)
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) |
