Submit an administrative compute resource deletion¶
Persist the deletion intent and return an acknowledgement. Background processing continues the cleanup.
DELETE https://api.moi.matrixorigin.cn/v5/admin/compute-resources/{id}
Before you call this API¶
Prepare an identity configured as a compute specification administrator in this deployment and an accessible authentication Workspace. Workspace Owner status or a Genesis administration scope is insufficient. Replace example IDs with targets you are authorized to read or operate on. See Compute Instances.
Run the deletion preflight first. Active tasks or bound workflows block deletion by default. After acceptance, force=true rereads dependencies, cancels active tasks, removes resource bindings from affected workflows and versions, and then proceeds with permission and runtime cleanup. This changes business content; confirm its impact and recovery procedure first. A 202 response does not mean cleanup has completed.
Request parameters¶
curl -X DELETE "https://api.moi.matrixorigin.cn/v5/admin/compute-resources/cr-example" \
-H "X-API-Key: $AI_STUDIO_API_KEY" \
-H "X-Workspace-ID: $AUTH_WORKSPACE_ID"
Parameter |
Type |
Required |
Description |
|---|---|---|---|
|
string |
Yes (in this example) |
A valid personal access token for an identity configured as a compute specification administrator in this deployment. |
|
string |
Yes |
One nonempty authentication Workspace, separate from the resource’s Workspace and the workspace_id list filter. |
|
string |
Yes |
Target resource ID. The service resolves its owning workspace from the administrative repository. |
|
string (query parameter) |
No |
Only the exact string true enables this option. Omission, True, and 1 do not. There is no –force CLI flag; see SDK and CLI support. |
Successful response¶
HTTP 202。
{
"code": "OK",
"msg": "OK",
"data": {
"resource_id": "cr-example",
"status": "TERMINATING"
}
}
Field |
Type |
Description |
|---|---|---|
|
string |
OK on success. |
|
string |
OK on success. |
|
object |
Data returned by this API; see the fields below. |
|
string |
Resource ID whose deletion intent has been persisted. |
|
string |
TERMINATING; only indicates that deletion intent has been persisted. |
See Shared objects for nested objects and omission rules.
Error responses¶
{"code": "INVALID_PARAMS", "msg": "invalid compute resource request", "data": null}
HTTP / code |
Conditions and handling |
|---|---|
400 / INVALID_PARAMS |
Invalid request or classified resource parameters. |
403 / ErrForbidden |
A classified rejection of administrator eligibility, principal, or Workspace access. |
503 / ErrServiceUnavailable |
A classified shared authorization unavailability error; does not cover every directory/configuration error. |
404 / NOT_FOUND |
Target resource not found. |
409 / DELETE_CONFLICT |
Active tasks or bindings block deletion, or the deletion intent conflicts. Inspect the original request first. |
503 / DELETE_UNAVAILABLE |
The runtime service is not configured, or deletion service unavailability has been classified. |
400 / DELETE_FAILED |
Unclassified deletion failure; the current mapping is not always 500. Retain the request ID and check the actual phase. |
Field |
Type |
Description |
|---|---|---|
|
string |
Classified by the specific failure stage. |
|
string |
Error text; shared errors may be localized. |
|
null or omitted |
Direct compute errors use null. See error recovery for shared error formats. |
An error does not mean every stage was rolled back. See Errors and recovery.