Call the CreateHpcCluster operation to create an HPC cluster. You can use the HPC cluster feature to logically isolate HPC-optimized instances. Learn more.

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: CreateHpcCluster

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

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. The client can automatically generate a token, but you need to ensure that it is unique across 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.

Description string Optional Sample value: HPC cluster for testing.

The HPC cluster description. Default value: empty string.

Start with a letter or a Chinese character only.

Only Chinese, letters, numbers, underscores and hyphens are allowed.

The length limit is 0 to 255 characters.

Name string required Sample value: hpcCluster-01

The name of the HPC cluster.

Start with a letter or a Chinese character only.

Only Chinese, letters, numbers, underscores and hyphens are allowed.

The length limit is 1 to 128 characters.

ProjectName string Optional Sample value: project_a

The project to which the resource belongs. A resource can only belong to one project.

Only letters, digits, underscores (_), hyphens (-), and dots (.) are allowed.

The length is limited to 64 characters.

Tags.N.Key string[] required Sample value: Tags.1.Key=k1&Tags.2.Key=k2

The tag key of the user tag.

Argument - N: specifies the serial number of the tag key. Valid range: 1–20.

Separate multiple keys with ampersands (&).

Naming rules:

It cannot start with volc: or sys: in any case form.

It can contain only language characters, digits, spaces, and English symbols of " _", ".", ":", "/", "=", "+", "-", and "@".

It must be 1 to 128 characters in length.

tip

Keys of the same resource must be unique.

Tags.N.Value string[] Optional Sample value: Tags.1.Value=v1&Tags.2.Value=v2

The tag value of the user tag.

Argument - N: specifies the serial number of the tag value. Valid range: 1–20.

Separate multiple tag values with ampersands (&).

Naming rules:

Only language characters, digits, spaces, and English symbols of "_", ".", ":", "/", "=", "+", "-", and "@" are allowed.

It must be 0 to 256 characters in length.

tip

To pass in this parameter, pass in Tags.N.Key first.

ZoneId string required Sample value: cn-beijing-a

The ID of the availability zone where the HPC cluster is deployed.

You can call the DescribeZones operation to query the availability zones in the same region.

Response parameters

Only the response parameters specific to this operation are listed below. For more information, refer to the response structure.

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

The HPC cluster ID.

Sample request

Sample response

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	InvalidHpcClusterDescription.Malformed	The specified HpcClusterDescription is malformed.	The specified HPC cluster description is invalid.
400	InvalidHpcClusterName.Malformed	The specified HpcClusterName is malformed.	The specified HPC cluster name is invalid.
400	MissingParameter.HpcClusterName	The required parameter HpcClusterName is not supplied.	The name of the HPC cluster cannot be empty.
400	MissingParameter.HpcClusterZoneId	The required parameter HpcClusterZoneId is not supplied.	The ID of the availability zone where the HPC cluster is deployed cannot be empty.
404	InvalidZone.NotFound	The specified zone does not exist.	The specified availability zone does not exist.

Elastic Compute Service