Check the calculation instance before deleting it¶

Check the active tasks and workflow bindings that need to be processed before deleting the compute instance.

HTTP
GET $CLOUDSIGMA_API_BASE/compute-resources/{resource_id}/preflight-delete

Before you call this API¶

Configure the regional API endpoint and authentication, and select the target workspace.

First query the computing instance details and confirm the instance to be deleted.

Set the operation-specific values used in the request:

$RESOURCE_ID: The computing instance ID to be deleted.

Deletions are not reversible and this check should always be performed first.

Request¶

Input examples

Shell
curl "$CLOUDSIGMA_API_BASE/compute-resources/$RESOURCE_ID/preflight-delete" \
  -H "X-API-Key: $CLOUDSIGMA_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID"

Parameter reference

Path parameters

Parameter	Type	Required	Description
`resource_id`	string	Yes	The ID of the computing instance to be deleted.

Successful response¶

Returns 200 on success, data lists active tasks and workflow bindings that still need to be processed.

Response example

JSON
{
  "code": "OK",
  "msg": "OK",
  "data": {
    "active_tasks": 1,
    "active_task_ids": ["task-001"],
    "bound_workflows": 1,
    "bound_workflow_details": [
      {
        "id": "wf-001",
        "name": "daily-load"
      }
    ]
  }
}

Field reference

The response fields are as follows.

Field	Type	Description
`code`	string	`OK` on success.
`msg`	string	`OK` on success.
`data.active_tasks`	integer	Number of active tasks.
`data.active_task_ids`	string[]	Active task IDs; returned when active tasks exist.
`data.bound_workflows`	integer	Number of bound workflows.
`data.bound_workflow_details`	object[]	Bound workflow details; returned when bindings exist.
`data.bound_workflow_details[].id`	string	Workflow ID.
`data.bound_workflow_details[].name`	string	Workflow name.
`data.bound_workflow_details[].node_names`	string[]	The name of the node bound to this instance; returned if there is a value.

In this document, [] after a type means an array; for example, string[] is an array of strings. In field paths, [] means each item in an array; for example, data.bound_workflow_details[].id is the id field of each item in data.bound_workflow_details.

Error response¶

Response example

JSON
{
  "code": "PREFLIGHT_FAILED",
  "msg": "Server error",
  "data": null
}

Field reference

Common HTTP errors¶

HTTP status code	error code	Common causes	Recommended actions
`401`	—	Missing or invalid access credentials.	Check the regional endpoint, API key, and workspace ID.
`403`	`ErrForbidden`	The current identity does not have permission to query or delete instances.	Use valid credentials, or contact your administrator for authorization.
`404`	`NOT_FOUND`	The instance does not exist or does not belong to the current workspace.	Check `resource_id` and workspace.
`500`	`PREFLIGHT_FAILED`	The service was unable to complete dependency checking.	Try again later; don’t skip checking before deleting.

Follow-up operations¶

Process active tasks and workflow bindings first; pre-check again after there are no dependencies, and then Delete calculation instance.

Last updated on Sep 15, 2026