List virtual servers
The vServers of the account, a page at a time, optionally filtered by description or hostname.
manitu_vserver_list on https://mcp.manitu.de/mcpAnnotations as tools/list sends them
Description for the model
Lists the virtual servers (vServers) of the manitu customer account this connection works in: for each its vserver_id, the customer's description of it, hostname, status, power state (running, stopped, suspended, installing - as manitu last saw it), plan and IP addresses. total_count says how many there are in all; page with page_token = next_page_token while it is not null. For hardware, network details, rescue system, VNC and workflows still running on one vServer use manitu_vserver_get with its vserver_id. vServers this access may not see are not listed.
Arguments
page_sizeintegerHow many entries per page, default 100.
page_tokenstringnext_page_token of the previous page - with the same filters.
text_containsstringOnly vServers whose description or hostname contains this, ignoring case.
Result structuredContent, checked against the schema
vserver_listarray of objectrequiredvserver_list[].vserver_idintegerrequiredThe id of the vServer - what manitu_vserver_get and every route on it take (the same number as service_id).
vserver_list[].service_idintegerrequiredThe id of the service instance - the same number as the id its own routes take (e.g. vserver_id).
vserver_list[].service_typestringrequiredThe kind of service, e.g. vserver - its own data is under the key of that name.
vserver_list[].descriptionstring | nullrequiredWhat the customer wrote about it (his description), null if nothing - not its name or user name.
vserver_list[].statusstringrequiredIts state as a service, e.g. active.
vserver_list[].is_configurablebooleanrequiredIt can be changed right now - false e.g. while suspended.
vserver_list[].planstring | nullrequiredThe plan, e.g. "vServer M".
vserver_list[].vserverobjectrequiredWhat is the vServer's own.
vserver_list[].vserver.hostnamestring | nullrequiredIts hostname as manitu keeps it, if set.
vserver_list[].vserver.power_statestring | nullrequirede.g. running or stopped - as manitu last saw it: updated with every workflow on the server and once a day, so a shutdown from inside the server may not show yet; null if unknown.
vserver_list[].vserver.ipv4_addressstring | nullrequiredIts IPv4 address.
vserver_list[].vserver.ipv6_addressstring | nullrequiredIts IPv6 address.
total_countintegerrequiredHow many entries match, on all pages together.
next_page_tokenstring | nullrequiredPass as page_token for the next page; null on the last.
Authentication
One of X-API-Key, Authorization: Bearer … - never more than one in a request. More
Request body JSON; unknown fields are refused
page_sizeintegerHow many entries per page, default 100.
page_tokenstringnext_page_token of the previous page - with the same filters.
text_containsstringOnly vServers whose description or hostname contains this, ignoring case.
Response in data; the rest of the body as on every call
vserver_listarray of objectrequiredvserver_list[].vserver_idintegerrequiredThe id of the vServer - what manitu_vserver_get and every route on it take (the same number as service_id).
vserver_list[].service_idintegerrequiredThe id of the service instance - the same number as the id its own routes take (e.g. vserver_id).
vserver_list[].service_typestringrequiredThe kind of service, e.g. vserver - its own data is under the key of that name.
vserver_list[].descriptionstring | nullrequiredWhat the customer wrote about it (his description), null if nothing - not its name or user name.
vserver_list[].statusstringrequiredIts state as a service, e.g. active.
vserver_list[].is_configurablebooleanrequiredIt can be changed right now - false e.g. while suspended.
vserver_list[].planstring | nullrequiredThe plan, e.g. "vServer M".
vserver_list[].vserverobjectrequiredWhat is the vServer's own.
vserver_list[].vserver.hostnamestring | nullrequiredIts hostname as manitu keeps it, if set.
vserver_list[].vserver.power_statestring | nullrequirede.g. running or stopped - as manitu last saw it: updated with every workflow on the server and once a day, so a shutdown from inside the server may not show yet; null if unknown.
vserver_list[].vserver.ipv4_addressstring | nullrequiredIts IPv4 address.
vserver_list[].vserver.ipv6_addressstring | nullrequiredIts IPv6 address.
total_countintegerrequiredHow many entries match, on all pages together.
next_page_tokenstring | nullrequiredPass as page_token for the next page; null on the last.
Statuses
200Success.400The request does not match the declared input schema.401No credential was presented, or it was not recognised.403The credential is not permitted to use this operation.500The server failed. Nothing about the request was wrong. Whether a change took effect is not known - check before trying it again.503The channel this operation forwards through is unavailable.