VastAI.update_workergroup

Update an existing autoscale worker group.

Signature

VastAI.update_workergroup(
    id: int,
    min_load: Optional[float] = None,
    target_util: Optional[float] = None,
    cold_mult: Optional[float] = None,
    cold_workers: Optional[int] = None,
    test_workers: Optional[int] = None,
    gpu_ram: Optional[float] = None,
    template_hash: Optional[str] = None,
    template_id: Optional[int] = None,
    search_params: Optional[str] = None,
    no_default: bool = False,
    launch_args: Optional[str] = None,
    endpoint_name: Optional[str] = None,
    endpoint_id: Optional[int] = None
) -> str

Parameters

id · int · required

ID of the worker group to update.

min_load · Optional[float]

Minimum load (requests/sec) below which idle workers are scaled down.

target_util · Optional[float]

Target worker utilization ratio (0.0-1.0).

cold_mult · Optional[float]

Multiplier applied to warm worker count for pre-warming cold workers.

cold_workers · Optional[int]

Number of pre-warmed (cold) workers to keep ready.

test_workers · Optional[int]

Number of test workers to spin up during scaling evaluation.

gpu_ram · Optional[float]

Minimum GPU RAM in GiB required per worker.

template_hash · Optional[str]

Hash of the instance template to use for workers.

template_id · Optional[int]

ID of the instance template to use for workers.

search_params · Optional[str]

Query string for filtering available GPU offers.

no_default · bool · default: "False"

Disable the default search query filters when finding offers.

launch_args · Optional[str]

Additional CLI arguments passed when launching worker instances.

endpoint_name · Optional[str]

Human-readable name for the endpoint.

endpoint_id · Optional[int]

ID of the endpoint this worker group belongs to.

Returns

str, Result from the API call.

Example

from vastai import VastAI

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