Function
This API is used to create an empty cluster, which has only master nodes but do not have worker nodes. After creating a cluster by calling this API, you can add nodes to the cluster. For details, see Creating a Node.
-
- The URL for cluster management is in the format of https://Endpoint/uri. In the URL, uri indicates the resource path, that is, the path for API access.
- Info collect agent (ICAgent) is an O&M data collection agent. It runs on each server to collect data from probes in real time. When this API is called to create a cluster, ICAgent is not installed by default. To automatically install ICAgent during cluster creation, add "cluster.install.addons.external/install": "[{\"addonTemplateName\":\"icagent\"}]" to the annotations field in the request body.
- Before creating a cluster, Creating a VPC and Subnet. If a VPC and subnet already exists, you do not need to create them again.
- By default, an account can create a maximum of five clusters in each region.
- The URL for cluster management is in the format of https://Endpoint/uri. In the URL, uri indicates the resource path, that is, the path for API access.
- Before creating a cluster, Creating a VPC and Subnet. If a VPC and subnet already exists, you do not need to create them again.
- By default, an account can create a maximum of five clusters in each region.
- By default, ICAgent is not installed when you call this API to create a cluster. If you need to install ICAgent, add "cluster.install.addons.external/install":"[{"addonTemplateName":"icagent"}]" to annotations in the request body. ICAgent will be automatically installed during cluster creation. ICAgent is an O&M data collection agent used by Application Performance Management (APM). It runs on each server to collect data from probes in real time. ICAgent is the prerequisite for achieving application O&M. If ICAgent is not installed, the application O&M functions cannot be used.
URI
POST /api/v3/projects/{project_id}/clusters
@@ -238,11 +238,23 @@String
Cluster version, which mirrors the baseline version of the Kubernetes community. The latest version is recommended.
-You can create clusters of two latest versions on the CCE console. To learn which cluster versions are available, choose Dashboard > Create Cluster on the CCE console and check the Version parameter.
-You can call APIs to create clusters of other versions. However, these clusters will be gradually brought offline. For details about the offline policy, see the official CCE announcement.
-If this parameter is not set, the cluster of the latest version is created by default.
-Details:
+Cluster version, which mirrors the baseline version of the Kubernetes community. The latest commercial version is recommended.
+You can create clusters of the latest three versions on the CCE console. To learn which cluster versions are available, log in to the CCE console, create a cluster, and check the supported cluster versions.
+You can call APIs to create clusters of other versions. However, these cluster versions will be gradually terminated. For details about the support policy, see the CCE announcement.
+Constraints:
+The value must be in the format of vX.Y[.Z[-rN]], for example, v1.30, v1.30.0, or v1.30.0-r0. Specifying either of these values will create a cluster of version 1.30.
+- +
- +
- +
- +
Options:
+N/A
+Default value:
+platformVersion
@@ -251,9 +263,33 @@String
Version of the CCE cluster platform, which is for viewing only and cannot be specified during cluster creation. The latest platform version corresponding to the cluster version is automatically selected during cluster creation.
-- X indicates the quarterly or regularly feature version number, starting from 1.
- Y indicates the patch version of the cluster, starting from 0 (feature version). Other values indicate later patch versions after the feature version is released.
Details:
+CCE cluster platform version, which is an internal version under the cluster version (version). Platform versions are used to trace iterations in a major cluster version. They are unique within a major cluster version and recounted when the major cluster version changes.
+Constraints:
+This parameter cannot be customized, and when you create a cluster, the latest corresponding platform version is selected automatically.
+Options:
+The format of platformVersion is cce.X.Y.
+X: internal feature version, which indicates changes in features, patches, or OS support in the cluster version. The value starts from 1 and increases monotonically.
+Y: patch version of an internal feature version. It is used only for software package update after the feature version is released. No other modification is involved. The value starts from 0 and increases monotonically.
+
Default value:
+N/A
+legacyVersion
+No
+String
+Details:
+(Deprecated) Outdated version of CCE clusters, which serves no practical purpose and is only used to showcase the cluster version and platform version combination. The version number is globally unique. For example, if the cluster version is va.b and the platformVersion is cce.X.Y, the value of legacyVersion is va.b.X-rY.
+Constraints:
+None
+Options:
+N/A
+Default value:
+N/A
description
@@ -1114,6 +1150,20 @@legacyVersion
+String
+Details:
+(Deprecated) Outdated version of CCE clusters, which serves no practical purpose and is only used to showcase the cluster version and platform version combination. The version number is globally unique. For example, if the cluster version is va.b and the platformVersion is cce.X.Y, the value of legacyVersion is va.b.X-rY.
+Constraints:
+None
+Options:
+N/A
+Default value:
+N/A
+description
String
@@ -1606,12 +1656,12 @@ "name" : "support-overload", "value" : true } ] - },{ - "name": "eni", - "configurations": [ { - "name": "dataplane-v2", - "value": true - } ] + },{ + "name": "eni", + "configurations": [ { + "name": "dataplane-v2", + "value": true + } ] } ], "hostNetwork" : { "vpc" : "0538a5d0-9a65-4c1d-a8bf-e9acee237980", diff --git a/docs/cce/api-ref/cce_02_0238.html b/docs/cce/api-ref/cce_02_0238.html index 99a288317..67ef32153 100644 --- a/docs/cce/api-ref/cce_02_0238.html +++ b/docs/cce/api-ref/cce_02_0238.html @@ -154,16 +154,40 @@String
Cluster's baseline Kubernetes version. The latest version is recommended.
+Details:
+Cluster version, which mirrors the baseline version of the Kubernetes community. The latest commercial version is recommended.
+You can create clusters of the latest three versions on the CCE console. To learn which cluster versions are available, log in to the CCE console, create a cluster, and check the supported cluster versions.
+You can call APIs to create clusters of other versions. However, these cluster versions will be gradually terminated. For details about the support policy, see the CCE announcement.
+Constraints:
+The value must be in the format of vX.Y[.Z[-rN]], for example, v1.30, v1.30.0, or v1.30.0-r0. Specifying either of these values will create a cluster of version 1.30.
+- +
- +
- +
- +
Options:
+N/A
+Default value:
+platformVersion
String
Version of the CCE cluster platform, which is for viewing only and cannot be specified during cluster creation. The latest platform version corresponding to the cluster version is automatically selected during cluster creation.
-- X indicates the quarterly or regularly feature version number, starting from 1.
- Y indicates the patch version of the cluster, starting from 0 (feature version). Other values indicate later patch versions after the feature version is released.
Details:
+CCE cluster platform version, which is an internal version under the cluster version (version). Platform versions are used to trace iterations in a major cluster version. They are unique within a major cluster version and recounted when the major cluster version changes.
+Constraints:
+This parameter cannot be customized, and when you create a cluster, the latest corresponding platform version is selected automatically.
+Options:
+The format of platformVersion is cce.X.Y.
+X: internal feature version, which indicates changes in features, patches, or OS support in the cluster version. The value starts from 1 and increases monotonically.
+Y: patch version of an internal feature version. It is used only for software package update after the feature version is released. No other modification is involved. The value starts from 0 and increases monotonically.
+
Default value:
+N/A
az
diff --git a/docs/cce/api-ref/cce_02_0273.html b/docs/cce/api-ref/cce_02_0273.html index f14b2cb07..67bac2925 100644 --- a/docs/cce/api-ref/cce_02_0273.html +++ b/docs/cce/api-ref/cce_02_0273.html @@ -8,7 +8,19 @@2026-03-03
+2026-03-25
+Update:
+- Updated Creating a Cluster.
2026-03-11
+Update:
+Updated the version and platformVersion parameter description in Creating a Cluster.
+2026-03-03
Add:
Added the deletionProtection parameter in Creating a Cluster.