vastai search templates

Search for template results using custom query

Usage

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

Arguments

query · string · required

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

• Wrap > and < in quotes on the command line
• For string values (e.g. gpu_name), replace spaces with underscores: RTX_3090 not RTX 3090

Examples

vastai search templates 'count_created > 100  creator_id in [38382,48982]'

Available Fields

Field	Type	Description
creator_id	int	ID of creator
created_at	float	time of initial template creation (UTC epoch timestamp)
count_created	int	number of 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 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)