Set Machine Listing
set_machine_listingLists or unlists a hosted machine to control new pod placement: listed=true allows scheduling, while listed=false blocks it and requires confirmation.
Instructions
List a hosted machine (listed=true) so new pods can be placed on it, or unlist it (listed=false), like the
console's listing switch. machine is the machine_id from the machines tool.
Listing needs no confirmation. It is checked first: a machine that can't be listed yet is refused with the
console's reason (listing_refused), and nothing changes.
Unlisting stops new pods from being placed on the machine, and stopped pods can't start on it again until it is
listed; running pods keep running. With listed=false and confirm=false (default) it only says how many pods run
on it and changes nothing; call again with confirm=true after the user agreed.
Every write requires operation_id. Reuse the ID returned by the preview, or generate a UUID before the first call. Keep it for confirmation and all retries; a new ID means a new operation. After a timeout, check operation_status and resource state before retrying.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"machine": "<machine>",
"listed": "<listed>"
},
"name": "set_machine_listing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| listed | Yes | ||
| confirm | No | ||
| machine | Yes | ||
| operation_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||