CloudHub 1.0 — Deployments API returns "TERMINATED" instance status during a successful deployment

SYMPTOM

While deploying a CloudHub 1.0 application via the Anypoint REST API, polling the deployments endpoint:

GET /cloudhub/api/v2/applications/{domain}/deployments

returns an instance with status: "TERMINATED", even though:

• The application continues to deploy and ultimately reaches a running state.
• No errors appear in the application logs.
• A subsequent call to the same endpoint after deployment finishes shows STARTED.

CAUSE

The TERMINATED instance reflects an initial worker (EC2) provisioning attempt that failed on the underlying cloud infrastructure. CloudHub's self-healing deployment logic automatically provisions a replacement worker within the same deployment cycle, which is why the application still deploys successfully. The /deployments endpoint surfaces every worker instance involved in the deployment, including ones that were terminated and replaced — so a transient TERMINATED entry during an otherwise successful deployment is expected.

SOLUTION

Do not use the /deployments endpoint to track in-progress deployment status — it reflects per-instance lifecycle, not overall deployment progress. Instead, poll the application details endpoint:

GET /cloudhub/api/v2/applications/{domain}

and monitor the deploymentUpdateStatus field in the JSON response:

1. "deploymentUpdateStatus": "DEPLOYING" — the deployment is actively in progress.
2. "deploymentUpdateStatus": "DEPLOY_FAILED" — the deployment encountered an error and failed.
3. Field is absent / not returned — the deployment completed successfully. The deploymentUpdateStatus key is omitted from the response once the deployment finishes.

Once deploymentUpdateStatus is no longer present, you can call GET /cloudhub/api/v2/applications/{domain}/deployments to confirm the final instance status as STARTED.

Note: The deploymentUpdateStatus field is not currently included in the sample response shown in the Exchange portal documentation, but it is returned by the API at runtime during deployments.

References

CloudHub API — GET /applications/{domain} (Exchange)