Preflight compute resource deletion¶
Read current active tasks and workflow bindings before deletion.
GET https://api.moi.matrixorigin.cn/v5/admin/compute-resources/{id}/preflight-delete
Before you call this API¶
Prepare a compute specification administrator identity configured for the current deployment and an accessible authentication workspace. Workspace Owner privileges or Genesis administrative scopes do not substitute for this identity. Replace example IDs with targets you are authorized to read or operate on. See Compute Instances.
Results describe dependencies observed at read time. They neither reserve the resource nor grant deletion privileges. Workflow-level and node-level bindings are deduplicated by workflow ID. Some draft DSLs that cannot be parsed are skipped; version JSON parse failures return errors. Zero counts do not prove there will be no new bindings or external workloads later.
Query parameters¶
curl --get "https://api.moi.matrixorigin.cn/v5/admin/compute-resources/cr-example/preflight-delete" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $AUTH_WORKSPACE_ID"
Parameter |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes (example) |
Valid personal access token for a compute specification administrator configured in this deployment. |
|
string |
Yes |
Exactly one nonempty authentication workspace, separate from the target resource workspace and the workspace_id list filter. |
|
string |
Yes |
Target resource ID. The service resolves its owning workspace from the administrative repository. |
Successful response¶
HTTP 200。
{
"code": "OK",
"msg": "OK",
"data": {
"active_tasks": 0,
"bound_workflows": 0
}
}
Field |
Type |
Description |
|---|---|---|
|
string |
OK on success. |
|
string |
OK on success. |
|
object |
Data returned by this API; see the fields below. |
|
integer |
Number of active tasks collected at this time. |
|
string (array of strings), optional |
Optional active task IDs; omitted when empty. |
|
integer |
Number of bound workflows, deduplicated by workflow ID. |
|
object (array of objects), optional |
Optional bound workflow details; omitted when empty. |
See Common objects for nested objects and omission rules.
Error response¶
{"code": "INVALID_PARAMS", "msg": "invalid compute resource request", "data": null}
HTTP / code |
Conditions and recovery |
|---|---|
400 / INVALID_PARAMS |
Missing principal, authentication workspace, or resource ID. |
403 / ErrForbidden |
Classified denial of administrator eligibility, principal, or workspace access. |
503 / ErrServiceUnavailable |
Classified shared authorization unavailability; does not cover every catalog or configuration error. |
404 / NOT_FOUND |
Resource does not exist or has been excluded from the administrative read set. |
500 / ErrServer |
Unclassified service error while reading facts, parsing versions, or similar operations. |
Field |
Type |
Description |
|---|---|---|
|
string |
Classified by the failure stage. |
|
string |
Error text; shared errors may be localized. |
|
null or omitted |
Direct compute errors use null. See error recovery for shared error shapes. |
An error does not mean every stage was rolled back. See Errors and recovery.