VastAI.list_machine - Vast.ai Documentation: Affordable GPU Cloud Marketplace

Lists a machine for rent with optional pricing and configuration parameters.

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

SLA listing parameters are not in the published Python SDK yet — prefer console Set Pricing → SLA, or REST; see SLA Offers. Volume/duration listing options are CLI-only today.

Signature

VastAI.list_machine(
    id: int,
    price_gpu: Optional[float] = None,
    price_disk: Optional[float] = None,
    price_inetu: Optional[float] = None,
    price_inetd: Optional[float] = None,
    discount_rate: Optional[float] = None,
    min_chunk: Optional[int] = None,
    end_date: Optional[str] = None,
) -> str

Parameters

int

required

Machine ID to list.

Optional[float]

GPU rental price in $/hour for active instances.

Optional[float]

Storage price in $/GB/month for inactive instances.

Optional[float]

Upload bandwidth price in $/GB.

Optional[float]

Download bandwidth price in $/GB.

Optional[float]

Max long-term prepay discount rate fraction (default 0.4).

Optional[int]

Minimum GPUs that must be rented together (GPU slicing).

Optional[str]

Offer expiration (Unix timestamp or MM/DD/YYYY).

Returns

str, Result from the API call.

Example

from vastai import VastAI

client = VastAI(api_key="YOUR_API_KEY")
# Base listing only — for SLA, use the console or REST create_asks after list_machine()
# see SLA Offers → API (for automation): /host/sla-offers#api-for-automation
result = client.list_machine(id=12345, price_gpu=3.50, end_date="01/01/2030")
print(result)

delete_machine list_machines

⌘I

​Signature

​Parameters

​Returns

​Example

Signature

Parameters

Returns

Example