Command Reference

Complete command tree for the AceCloud CLI v1.4.2-beta.

v1.4.2-beta changes (block-by-block trust-rebuild sweep):

Setup & auth

• ace config list / ace config ls added as aliases for ace config show.

• ace config get/set now accept project_id and api_base_url as aliases for project and api_url.

• ace auth me -o json|yaml slimmed to 4 fields (name, email, country, currency) — no longer dumps the full account payload.

Networking

• ace vpc update — new command to rename / re-describe a VPC.

• ace floating-ip get — new command, looks up a single floating IP by ID or by IP address.

• ace floating-ip associate / disassociate now do pre-flight checks and surface clearer errors.

• ace security-group rule-add treats backend "already exists" as a friendly notice instead of an error.

Compute

• ace key-pair create --public-key body field now key (was public_key). Imported public keys must be ≥100 characters.

• ace instance logs, batch shutoff, and FIP-attach paths now show actionable error messages instead of raw backend strings.

Storage

• ace snapshot get and ace snapshot delete — new commands (single + bulk).

• ace volume update --description now pre-fetches the current name (no need to pass --name redundantly).

• ace volume extend runs a state pre-check first.

Load Balancer

• LB listener/pool create now polls back by name after the async 202 response, so the created ID is surfaced in the output reliably.

Kubernetes

• ace k8s cluster nodepool scale --count is now the target node count (kubectl-style). Legacy add/remove-delta semantics remain available via --delta.

• ace k8s cluster nodepool create auto-fetches secGroupId from the cluster; volume-size is now int.

• ace k8s cluster nodes table view drops empty columns (ID/IP/AGE) for a cleaner read; full payload remains in -o json.

• ace k8s cluster kubeconfig -o json now wraps the YAML in {"kubeconfig": "<yaml>"} for automation; table / yaml emit raw YAML for direct redirection.

CaaS / general

• Deployment lifecycle verified end-to-end against the latest backend (the xForwardedFor regression fixed in npc-api is now confirmed working from CLI).

• 401 from the API surfaces as a clean "authentication failed — run ace auth login" with exit 1; "Invalid Route" translated to a region-availability hint.

v1.4.0 changes:

• New ace api-key command group — long-lived programmatic credentials (recommended for automation/CI).

• New ace auth login-api-key — log in with an API key instead of JWT (no 24h refresh dance).

• New ace configure — aws configure-style interactive setup with masked defaults; also configure set/get/list for scripted use.

• Managed-resource hide filter now applies uniformly to JSON, YAML, and table output (was table-only in v1.3.0).

• Pre-flight on delete commands: refuses to touch api-gateway / ace-deployment tagged resources client-side with a clear error.

• Bug fixes: security-group update --description (alone), load-balancer listener/pool create async response, get-all -o json no longer leaks managed resources.

v1.3.0 changes:

• All delete commands now prompt for confirmation interactively, and require --yes when stdin is not a TTY (CI/scripts).

• ace instance snapshot now pre-checks instance state and requires the instance to be SHUTOFF (use --force to bypass).

• -o yaml now produces real YAML on every command.

• Unknown subcommands exit with status 1 instead of 0.

Full Command Tree

ace
├── auth
│   ├── login              Login with email/password
│   ├── login-token        Login with developer token (JWT)
│   ├── login-api-key      Login with an API key (recommended for automation)
│   ├── logout             Logout (clears all credentials)
│   ├── me                 Current user info
│   ├── projects           List projects
│   └── status             Account status
│
├── api-key (aliases: apikey, ak)
│   ├── create             Create a new API key (secret shown only once)
│   ├── list               List your API keys
│   ├── get                Get details for a single key
│   ├── update             Update name/description/enabled
│   ├── enable             Enable an API key
│   ├── disable            Disable an API key (without deleting)
│   ├── revive             Regenerate the secret (old secret stops working)
│   └── delete             Delete one or more keys
│
├── configure
│   ├── (interactive)      Walk through region/project/auth setup
│   ├── set                Set a single config value (script style)
│   ├── get                Print a single config value
│   └── list               Show all config (secrets masked)
│
├── config
│   ├── set                Set config value (region, project_id, api_base_url, …)
│   ├── get                Get config value
│   ├── show               Show all config (aliases: list, ls)
│   └── use-project        Switch project (interactive)
│
├── instance (aliases: i, vm)
│   ├── list               List all instances
│   ├── get                Get full instance details
│   ├── create             Create a new instance
│   ├── update             Update instance name/description
│   ├── delete             Delete instance(s)
│   ├── summary            Show instance count
│   ├── start              Start an instance
│   ├── stop               Stop an instance
│   ├── reboot             Reboot (--hard for hard reboot)
│   ├── suspend            Suspend an instance
│   ├── unsuspend          Resume suspended instance
│   ├── lock               Lock an instance
│   ├── unlock             Unlock an instance
│   ├── recovery           Toggle recovery mode (--on/--off)
│   ├── batch-shutoff      Shutoff/start multiple instances
│   ├── resize             Resize to new flavor
│   ├── resize-confirm     Confirm pending resize
│   ├── resize-revert      Revert pending resize
│   ├── rebuild            Rebuild with new image
│   ├── snapshot           Create snapshot
│   ├── save-image         Save as image
│   ├── console            Get console URL
│   ├── logs               View instance logs
│   ├── action-logs        View action history
│   ├── interfaces         List network interfaces
│   ├── security-groups    List security groups
│   ├── volumes            List attached volumes
│   ├── attach-volume      Attach a volume
│   ├── detach-volume      Detach a volume
│   ├── attach-interface   Attach network interface
│   └── detach-interface   Detach network interface
│
├── volume (alias: vol)
│   ├── list               List volumes (--status filter)
│   ├── get                Get volume details
│   ├── create             Create volume (--name, --size, --type)
│   ├── update             Update volume name
│   ├── delete             Delete volume(s)
│   ├── extend             Extend volume size
│   └── types              List volume types with pricing
│
├── snapshot (alias: snap)
│   ├── list               List snapshots
│   ├── get                Get snapshot details (alias: show)
│   └── delete             Delete snapshot(s) (alias: rm)
│
├── vpc (alias: network)
│   ├── list               List VPCs
│   ├── get                Get VPC details
│   ├── create             Create VPC with subnet
│   ├── update             Rename / re-describe a VPC
│   ├── delete             Delete VPC(s)
│   ├── subnet-create      Create subnet in VPC
│   ├── subnet-delete      Delete subnet(s)
│   └── router
│       ├── list           List routers
│       ├── get            Get router details
│       ├── create         Create router
│       ├── delete         Delete router(s)
│       ├── set-gateway    Attach external gateway
│       ├── remove-gateway Detach external gateway
│       ├── add-interface  Attach subnet to router
│       ├── remove-interface Detach subnet/interface
│       └── interfaces     List router interfaces
│
├── security-group (alias: sg)
│   ├── list               List security groups
│   ├── get                Get SG details + rules
│   ├── create             Create security group
│   ├── update             Update SG name/description
│   ├── delete             Delete SG(s)
│   ├── rule-add           Add firewall rule
│   └── rule-delete        Delete rule(s)
│
├── floating-ip (alias: fip)
│   ├── list               List floating IPs
│   ├── get                Get floating IP details (by id or by ip address)
│   ├── create             Allocate floating IP
│   ├── associate          Assign to instance (with pre-flight checks)
│   ├── disassociate       Remove from instance (with pre-flight checks)
│   └── delete             Release floating IP(s)
│
├── load-balancer (alias: lb)
│   ├── list               List load balancers
│   ├── get                Get LB details
│   ├── create             Create LB (--type ALB/NLB)
│   ├── update             Update LB
│   ├── delete             Delete LB (--cascade)
│   ├── listener
│   │   ├── list           List listeners (--lb filter)
│   │   ├── get            Get listener details
│   │   ├── create         Create listener
│   │   └── delete         Delete listener(s)
│   └── pool
│       ├── list           List pools
│       ├── get            Get pool details
│       ├── create         Create pool
│       └── delete         Delete pool(s)
│
├── k8s (alias: kubernetes)
│   └── cluster (alias: cl)
│       ├── list           List clusters
│       ├── get            Get cluster details (alias: show)
│       ├── create         Create cluster (17 flags)
│       ├── delete         Delete cluster
│       ├── versions       List K8s versions
│       ├── kubeconfig     Get kubeconfig
│       ├── nodes          List nodes (--pool filter)
│       └── nodepool (alias: np)
│           ├── list       List node pools
│           ├── get        Get pool details (alias: show)
│           ├── create     Create node pool
│           ├── scale      Scale pool — `--count` is target count (kubectl-style); `--delta` for legacy add/remove mode
│           └── delete     Delete node pool
│
├── deployment (aliases: deploy, caas)
│   ├── list               List deployments
│   ├── get                Get deployment details
│   ├── create             Create deployment (shared/dedicated)
│   ├── update             Update deployment
│   ├── delete             Delete deployment(s)
│   ├── restart            Restart deployment
│   └── replicas           Show replicas/pods
│
├── registry (aliases: reg, craas)
│   ├── status             Registry info
│   ├── create             Create registry
│   ├── delete             Delete registry
│   ├── credentials        Docker login credentials
│   ├── push-commands      Show push instructions
│   ├── repo
│   │   ├── list           List repositories
│   │   └── delete         Delete repository
│   └── artifact (alias: artifacts)
│       ├── list             List artifacts
│       ├── tags             List tags for an artifact
│       ├── add-tag          Add a tag to an artifact
│       ├── remove-tag       Remove a tag from an artifact
│       ├── scan             Start or stop a vulnerability scan
│       ├── vulnerabilities  Show vulnerability details for an artifact
│       └── delete           Delete an artifact
│
├── flavor (aliases: size, machine-type)
│   ├── list               List flavors (--cpu, --gpu filters)
│   └── get                Get flavor details
│
├── image
│   ├── list               List images (--os filter)
│   ├── get                Get image details
│   ├── delete             Delete image(s)
│   └── categories         List image categories
│
├── key-pair (aliases: kp, keypair)
│   ├── list               List key pairs
│   ├── get                Get key pair details
│   ├── create             Create/import key pair
│   └── delete             Delete key pair(s)
│
├── pricing (alias: price)  View resource pricing (--currency)
├── quota
│   ├── all                All quotas
│   ├── compute            Compute quotas
│   ├── storage            Storage quotas
│   └── network            Network quotas
│
├── get-all (aliases: all, status)  Resource dashboard
├── update                  Self-update CLI
├── init                    Interactive setup wizard
└── completion             Shell completion setup

Aliases Quick Reference

Full Command	Short Alias
ace instance	ace i, ace vm
ace volume	ace vol
ace security-group	ace sg
ace floating-ip	ace fip
ace load-balancer	ace lb
ace k8s cluster	ace k8s cl
ace k8s cluster nodepool	ace k8s cluster np
ace deployment	ace deploy, ace caas
ace registry	ace reg, ace craas
ace key-pair	ace kp, ace keypair
ace get-all	ace all, ace status