vastai list machines

Host command

list machines for rent

This is a host command, used for managing machines you are renting out on Vast.ai.

Usage

vastai list machines IDs [options]

Arguments

ids · integer · required

ids of instance to list

Options

-g · number

per gpu on-demand rental price in $/hour (base price for active instances) (alias: --price_gpu)

-s · number

storage price in $/GB/month (price for inactive instances), default:$0.10/GB/month (alias: --price_disk)

-u · number

price for internet upload bandwidth in $/GB (alias: --price_inetu)

-d · number

price for internet download bandwidth in $/GB (alias: --price_inetd)

-b · number

per gpu minimum bid price floor in $/hour (alias: --price_min_bid)

-r · number

Max long term prepay discount rate fraction, default: 0.4 (alias: --discount_rate)

-m · integer

minimum amount of gpus (alias: --min_chunk)

-e · string

contract offer expiration - the available until date (optional, in unix float timestamp or MM/DD/YYYY format) (alias: --end_date)

-l · string

Updates end_date daily to be duration from current date. Cannot be combined with end_date. Format is: n days, n weeks, n months, n years, or total intended duration in seconds. (alias: --duration)

-v · integer

Size for volume contract offer. Defaults to half of available disk. Set 0 to not create a volume contract offer. (alias: --vol_size)

-z · number

Price for disk on volume contract offer. Defaults to price_disk. Invalid if vol_size is 0. (alias: --vol_price)

Description

This variant can be used to list or update the listings for multiple machines at once with the same args. You could extend the end dates of all your machines using a command combo like this: ./vast.py list machines $(./vast.py show machines -q) -e 12/31/2024 —retry 6

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)