Skip to content

waldur-cli openstack instance list

List openstack instances (vms).

Usage

1
waldur-cli openstack instance list [OPTIONS]
Flag Type Description
--filter KEY=VALUE repeatable Server-side filter. Valid keys: attach_volume_uuid (string), availability_zone_name (string), backend_id (string), can_manage (boolean), customer (string), customer_abbreviation (string), customer_name (string), customer_native_name (string), customer_uuid (string), description (string), external_ip (string), name (string), name_exact (string), project (string), project_name (string), project_uuid (string), query (string), runtime_state (string), service_settings_name (string), service_settings_uuid (string), state (string), tenant (string), tenant_uuid (string).
--fields FIELDS string Fetch only these fields from the server (comma-separated). Valid: access_url, action, action_details, availability_zone, availability_zone_name, backend_id, config_drive, connect_directly_to_external_network, cores, created, customer, customer_abbreviation, customer_name, customer_native_name, customer_uuid, description, disk, error_message, error_traceback, external_address, external_ips, flavor_disk, flavor_name, floating_ips, hypervisor_hostname, image_name, internal_ips, is_limit_based, is_usage_based, key_fingerprint, key_name, latitude, longitude, marketplace_category_name, marketplace_category_uuid, marketplace_offering_name, marketplace_offering_plugin_options, marketplace_offering_type, marketplace_offering_uuid, marketplace_plan_uuid, marketplace_resource_state, marketplace_resource_uuid, min_disk, min_ram, modified, name, ports, project, project_name, project_uuid, ram, rancher_cluster, resource_type, runtime_state, security_groups, server_group, service_name, service_settings, service_settings_error_message, service_settings_state, service_settings_uuid, ssh_public_key, start_time, state, tenant, tenant_uuid, url, user_data, uuid, volumes.
--order FIELDS string Sort server-side (comma-separated, - prefix for descending).
--jmespath EXPR string Reshape the already-fetched result client-side (https://jmespath.org).
--limit N integer Stop after this many items.
--format FORMAT string table, json, tsv, toon, or ndjson.

Examples

1
waldur-cli openstack instance list --filter state=OK --fields uuid,name --format json

Project just the columns you need, client-side:

1
waldur-cli openstack instance list --jmespath '[].[uuid, name]'

Smallest/first result matching a filter, sorted server-side:

1
waldur-cli openstack instance list --order uuid --limit 1

Global options

Every command also accepts --api-url, --token, --profile, --format, and --debug; mutating commands additionally accept --dry-run. See Getting started for what each does.