vastai list machine

[Host] list a machine for rent

Usage

vastai list machine ID [options]

Arguments

id · integer · required

id of machine to list

Options

--price_gpu · number

per gpu rental price in $/hour (price for active instances)

--price_disk · number

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

--price_inetu · number

price for internet upload bandwidth in $/GB

--price_inetd · number

price for internet download bandwidth in $/GB

--price_min_bid · number

per gpu minimum bid price floor in $/hour

--discount_rate · number

Max long term prepay discount rate fraction, default: 0.4

--min_chunk · integer · default: "1"

minimum amount of gpus (default: 1)

--end_date · string

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

--duration · 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.

--vol_size · integer

Size for volume contract offer. Defaults to half of available disk. Set 0 to not create a volume contract offer.

--vol_price · number

Price for disk on volume contract offer. Defaults to price_disk. Invalid if vol_size is 0.

Description

Performs the same action as pressing the “LIST” button on the site https://cloud.vast.ai/host/machines. On the end date the listing will expire and your machine will unlist. However any existing client jobs will still remain until ended by their owners. Once you list your machine and it is rented, it is extremely important that you don’t interfere with the machine in any way. If your machine has an active client job and then goes offline, crashes, or has performance problems, this could permanently lower your reliability rating. We strongly recommend you test the machine first and only list when ready.

Raising any resource price above the current contract price writes a pending row to pending_price_increases for each affected client. Clients review and accept those rows via the console or vastai show pending-price-increases; auto-extend stops at the old price until they accept.

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)