Updated on 2026-09-08 GMT+08:00

Obtaining the Configuration of Cluster Upgrade Feature Gates

Function

This API is used to obtain the configuration of cluster upgrade feature gates.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.

URI

GET /api/v3/clusterupgradefeaturegates

Request Parameters

**Table 1** Request header parameters
Parameter	Mandatory	Type	Description
Content-Type	Yes	String	Definition: Type (or format) of the request body. The default value is application/json. Other values of this field will be provided for specific APIs, if any. Constraints: GET requests are not validated. Range: N/A Default Value: N/A
X-Auth-Token	Yes	String	Details: Requests for calling an API can be authenticated using either a token or AK/SK. If token-based authentication is used, this parameter is mandatory and must be set to a user token. For details, see Obtaining a User Token. Constraints: None Options: N/A Default value: N/A

Response Parameters

Status code: 200

**Table 2** Response body parameters
Parameter	Type	Description
apiVersion	String	Definition: API version Range: N/A
kind	String	Definition: Resource type. Range: N/A
metadata	Metadata object	Definition: Basic information. Metadata is a collection of attributes. Range: N/A
upgradeFeatureGates	Map<String,String>	Definition: Feature gates, which are in the format of key-value pairs. Key: can be DisplayPreCheckDetail (displaying details about all cluster check items before an upgrade), EvsSnapshot (using EVS snapshots to back up clusters), LabelForSkippedNode (labeling the nodes skipped during a cluster upgrade), or UpgradeStrategy (specifying cluster upgrade policies). Value: can be Support, Disable, or Default, which is determined by default CCE rules. Range: N/A

**Table 3** Metadata
Parameter	Type	Description
uid	String	Definition Unique ID Range N/A
name	String	Definition Resource name Range N/A
labels	Map<String,String>	Definition Resource labels in key-value pairs. This is a reserved field. Inputting values will not work. Range N/A
annotations	Map<String,String>	Definition Resource annotations in the format of key-value pairs Range N/A
updateTimestamp	String	Definition Update time Range N/A
creationTimestamp	String	Definition Creation time Range N/A

Example Requests

None

Example Responses

Status code: 200

The cluster upgrade path is obtained.

{
  "kind" : "ClusterUpgradeFeatureGates",
  "apiVersion" : "v3",
  "metadata" : { },
  "upgradeFeatureGates" : {
    "DisplayPreCheckDetail" : "Support",
    "EvsSnapshot" : "Support",
    "LabelForSkippedNode" : "Support",
    "UpgradeStrategy" : "Support"
  }
}

Status Codes

Status Code	Description
200	The cluster upgrade path is obtained.

Error Codes

See Error Codes.

Parent Topic: Cluster Upgrade