Docs

Elastic Compute Service

HPC clusters

DeleteHpcCluster - Deletes HPC clusters

Call the DeleteHpcCluster operation to delete an HPC cluster. HPC clusters within which ECS instances are deployed cannot be deleted.

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

Only the request parameters specific to this operation and some common parameters are listed below. For more information, refer to Common parameters.

Action string required Sample value: DeleteHpcCluster

The action that you want to perform. Value: DeleteHpcCluster.

Version string required Sample value: 2020-04-01

The version of the API. Valid value: 2020-04-01.

ClientToken string Optional Sample value: 333456899ff****

The ClientToken is used to ensure the request idempotency. You can use the client to automatically generate a token, but you must make sure that the token is unique among different requests. This prevents duplicate operations caused by multiple retries when the API request times out or an internal server error occurs. Value: Only ASCII characters are supported. The length is no more than 64 ASCII characters.

HpcClusterId string required Sample value: hpcCluster-ybowdcxqb1f80nqm****

The HPC cluster ID. You can call DescribeHpcClusters to query the HPC cluster ID.

Response parameters

This operation has no specific response parameters. For more information, refer to Response structure.

Sample request

GET /?Action=DeleteHpcCluster&Version=2020-04-01&HpcClusterId=hpcCluster-ybowdcxqb1f80nqm**** HTTP/1.1​
Host: ecs.cn-beijing.volcengineapi.com​
Region: cn-beijing​
Service: ecs​

Sample response

{​
    "ResponseMetadata": {​
        "RequestId": "202205181726250102121620311E4C****",​
        "Action": "DeleteHpcCluster",​
        "Version": "2020-04-01",​
        "Service": "ecs",​
        "Region": "cn-beijing"​
    },​
    "Result": {}​
}​

Error codes

The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.

Status code	Error code	Error message	Description
400	IdempotentParameterMismatch	The request uses the same client token as a previous, but non-identical request. Do not reuse a client token with different requests, unless the requests are identical.	The idempotent parameters are inconsistent.
400	InvalidClientToken.Malformed	The specified ClientToken is malformed.	The specified ClientToken is invalid.
412	IdempotentProcessing	The request uses the same client token as a previous one that is still in process.	The previous idempotent request is still being processed. Please try again later.

Last updated: 2026.06.18 17:48:27