VastAI.list_machines

List multiple machines for rent.

Signature

VastAI.list_machines(
    ids: Any,
    price_gpu: Optional[float] = None,
    price_disk: Optional[float] = None,
    price_inetu: Optional[float] = None,
    price_inetd: Optional[float] = None,
    price_min_bid: Optional[float] = None,
    discount_rate: Optional[float] = None,
    min_chunk: Optional[int] = 1,
    end_date: Optional[str] = None,
    duration: Optional[str] = None,
    vol_size: Optional[int] = None,
    vol_price: Optional[float] = None
) -> list[dict]

Parameters

ids · Any · required

ids of machines to list

price_gpu · Optional[float]

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

price_disk · Optional[float]

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

price_inetu · Optional[float]

price for internet upload bandwidth in $/GB

price_inetd · Optional[float]

price for internet download bandwidth in $/GB

price_min_bid · Optional[float]

per gpu minimum bid price floor in $/hour

discount_rate · Optional[float]

Max long term prepay discount rate fraction, default: 0.4

min_chunk · Optional[int] · default: "1"

minimum amount of gpus (default: 1)

end_date · Optional[str]

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

duration · Optional[str]

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 · Optional[int]

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

vol_price · Optional[float]

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

Returns

list[dict]

Example

from vastai import VastAI

client = VastAI(api_key="YOUR_API_KEY")
result = client.list_machines(ids="value")
print(result)