CLI & API Exit Codes
Complete reference for CloudNexus command-line interface and system exit codes. Use these codes for scripting, automation, and debugging deployments.
Core
0
Success
The command executed successfully. No errors or warnings were encountered during execution.
Action: Proceed with workflow. Logs are available in ~/.cloudnexus/logs/
General
1
General Error
An unspecified or unexpected failure occurred. Check the full log output for detailed stack traces.
Action: Run with
--verbose flag and open a support ticket if unresolved.
CLI
2
Invalid Usage
Incorrect CLI arguments, missing required flags, or malformed command syntax provided.
Action: Run
cnx command --help to review valid parameters.
Auth
3
Authentication Failed
Invalid API key, expired OAuth token, or missing authentication credentials in request headers.
Action: Re-authenticate using
cnx auth login or rotate your API key.
RBAC
4
Permission Denied
The authenticated user lacks the required role or scope to perform this action on the target resource.
Action: Verify IAM policies in Console or request elevated access from admin.
Resource
5
Resource Not Found
The specified instance ID, volume, network, or project does not exist in the requested region.
Action: Verify resource IDs and region flags. Use
cnx list to validate.
Rate Limit
10
Rate Limit Exceeded
Too many requests sent within the allocated time window. CloudNexus API throttling triggered.
Action: Implement exponential backoff. Check
X-RateLimit-Reset header.
Limits
11
Quota Exceeded
Account-level or project-level resource limits have been reached (e.g., max VMs, storage, bandwidth).
Action: Delete unused resources or submit a quota increase request in Console.
Network
20
Network Unreachable
Failed to establish connection to CloudNexus control plane or regional edge nodes.
Action: Check local DNS/firewall. Verify internet connectivity and proxy settings.
Network
21
Request Timeout
Operation exceeded the maximum allowed execution time. Common during large deployments or database migrations.
Action: Increase
--timeout flag value or optimize payload size.
Payload
30
Invalid Payload
Malformed request body, unsupported data format, or missing required schema fields.
Action: Validate JSON/YAML against CloudNexus OpenAPI spec.
Deploy
40
Deployment Failed
Application or container failed readiness/liveness health checks during rollout.
Action: Review container logs via
cnx logs --tail=100 and verify ports/env vars.
Platform
50
Internal Service Error
CloudNexus backend encountered an unexpected state or infrastructure fault.
Action: Retry after 60s. If persistent, contact support with request ID from headers.
🔍
No exit codes found
Try adjusting your search or filter criteria.