cloud_insts_ls
List cloud instances in a specified project and region, with filters for name, status, IP address, tags, and other criteria.
Instructions
List all instances in the specified project and region.
Results can be filtered by various parameters like name, status, and IP address.
Args: project_id: Project ID
region_id: Region ID
available_floating: Only show instances which are able to handle floating address
changes_before: Filters the instances by a date and time stamp when the instances last changed.
changes_since: Filters the instances by a date and time stamp when the instances last changed status.
exclude_flavor_prefix: Exclude instances with specified flavor prefix
exclude_secgroup: Exclude instances with specified security group name
flavor_id: Filter out instances by flavor_id. Flavor id must match exactly.
flavor_prefix: Filter out instances by flavor_prefix.
include_ai: Include GPU clusters' servers
include_baremetal: Include bare metal servers. Please, use GET /v1/bminstances/ instead
include_k8s: Include managed k8s worker nodes
ip: An IPv4 address to filter results by. Note: partial matches are allowed. For example, searching for 192.168.0.1 will return 192.168.0.1, 192.168.0.10, 192.168.0.110, and so on.
limit: Optional. Limit the number of returned items
name: Filter instances by name. You can provide a full or partial name, instances with matching names will be returned. For example, entering 'test' will return all instances that contain 'test' in their name.
offset: Optional. Offset value is used to exclude the first set of records from the result
only_isolated: Include only isolated instances
only_with_fixed_external_ip: Return bare metals only with external fixed IP addresses.
order_by: Order by field and direction.
profile_name: Filter result by ddos protection profile name. Effective only with with_ddos
set to true.
protection_status: Filter result by DDoS protection_status. if parameter is provided. Effective
only with with_ddos set to true. (Active, Queued or Error)
status: Filters instances by status.
tag_key_value: Optional. Filter by tag key-value pairs.
tag_value: Optional. Filter by tag values. ?tag_value=value1&tag_value=value2
type_ddos_profile: Return bare metals either only with advanced or only basic DDoS protection.
Effective only with with_ddos set to true. (advanced or basic)
uuid: Filter the server list result by the UUID of the server. Allowed UUID part
with_ddos: Include DDoS profile information in the response when set to true. Otherwise,
the ddos_profile field in the response is null by default.
with_interfaces_name: Include interface_name in the addresses
extra_headers: Send extra headers
extra_query: Add additional query parameters to the request
extra_body: Add additional JSON properties to the request
timeout: Override the client-level default timeout for this request, in seconds
Note: Pass the numeric project_id. When a project name is provided, resolve it via cloud.projects.list/cloud.projects.get. If nothing is specified, fetch the account's default project first and use that ID. Pass the numeric region_id. Resolve region names with cloud.regions.list or cloud.regions.get. If no region is mentioned, obtain the default region ID before calling this tool.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| project_id | Yes | ||
| region_id | Yes | ||
| available_floating | No | ||
| changes_before | No | ||
| changes_since | No | ||
| exclude_flavor_prefix | No | ||
| exclude_secgroup | No | ||
| flavor_id | No | ||
| flavor_prefix | No | ||
| include_ai | No | ||
| include_baremetal | No | ||
| include_k8s | No | ||
| ip | No | ||
| limit | No | ||
| name | No | ||
| offset | No | ||
| only_isolated | No | ||
| only_with_fixed_external_ip | No | ||
| order_by | No | ||
| profile_name | No | ||
| protection_status | No | ||
| status | No | ||
| tag_key_value | No | ||
| tag_value | No | ||
| type_ddos_profile | No | ||
| uuid | No | ||
| with_ddos | No | ||
| with_interfaces_name | No | ||
| extra_headers | No | ||
| extra_query | No | ||
| extra_body | No | ||
| timeout | No |