VastAI.show_instance

Show details of an instance.

Returns an instance object. Key status fields:

actual_status — current container state:

Value	Meaning
null	Instance is being provisioned
loading	Docker image is downloading or container is starting up
running	Container is actively executing. GPU charges apply.
stopped	Container is halted. Disk charges continue; no GPU charges.
frozen	Container is paused with memory preserved. GPU charges apply.
exited	Container process exited unexpectedly
rebooting	Container is restarting (transient)
unknown	No recent heartbeat from the host
offline	Host machine disconnected from Vast servers (computed, not stored in DB)

intended_status — user’s desired target state: running, stopped, or frozen.

cur_state — machine contract / hardware allocation state: running, stopped, or unloaded (released on destroy).

status_msg — human-readable detail on the current status.

Signature

VastAI.show_instance(id: int) -> str

Parameters

id · int · required

id

Returns

str — Result from the API call.

Example

from vastai import VastAI

client = VastAI(api_key="YOUR_API_KEY")
result = client.show_instance(id=12345)
print(result)