Changing the Values of Configuration Parameters of a Node Pool

Function

This API is used to change the values of parameter configurations of a node pool in the CCE cluster.

Calling Method

For details, see Calling APIs.

URI

PUT /api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools/{nodepool_id}/configuration

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Details: Project ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints: None Options: Project IDs of the account Default value: N/A
cluster_id	Yes	String	Details: Cluster ID. For details about how to obtain the value, see How to Obtain Parameters in the API URI. Constraints: None Options: Cluster IDs Default value: N/A
nodepool_id	Yes	String	Details: Node pool ID. For details about how to obtain the ID, see How to Obtain Parameters in the API URI. Constraints: None Options: Cluster IDs Default value: N/A

Request Parameters

**Table 2** 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

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
apiVersion	Yes	String	Definition: API version. The value is fixed at v3. Constraints: The value is fixed. Range: v3 Default Value: v3
kind	Yes	String	Definition: API type. The value is fixed at Configuration. Constraints: The value is fixed. Range: Configuration Default Value: Configuration
metadata	Yes	ConfigurationMetadata object	Definition: Metadata of Configuration Constraints: N/A Range: N/A Default Value: N/A
spec	Yes	ClusterConfigurationsSpec object	Definition: Spec of Configuration Constraints: N/A Range: N/A Default Value: N/A

**Table 4** ConfigurationMetadata
Parameter	Mandatory	Type	Description
name	Yes	String	Definition: Configuration name Constraints: N/A Range: N/A Default Value: N/A
labels	No	Map<String,String>	Definition: A configuration label in a key-value pair. Key: The key must contain a maximum of 63 characters that start with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. A DNS subdomain can be prefixed to a key, for example, example.com/my-key, and contain a maximum of 253 characters. Value: The value can be left empty or contain a maximum of 63 characters that start and end with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. Example: "foo": "bar" Constraints: N/A Range: N/A Default Value: N/A

**Table 5** ClusterConfigurationsSpec
Parameter	Mandatory	Type	Description
packages	Yes	Array of packages objects	Definition: Component configuration item list Constraints: N/A Range: N/A Default Value: N/A

**Table 6** packages
Parameter	Mandatory	Type	Description
name	No	String	Definition: Component name Constraints: N/A Range: N/A Default Value: N/A
configurations	No	Array of ConfigurationItem objects	Definition: Details about component configuration items Constraints: N/A Range: N/A Default Value: N/A

**Table 7** ConfigurationItem
Parameter	Mandatory	Type	Description
name	No	String	Definition: Component configuration parameters. Constraints: If you specify a component or parameter that is not supported, the configuration item will be ignored. Options: N/A Default value: N/A
value	No	Object	Definition: Values of component configuration parameters. Constraints: If you specify a component or parameter that is not supported, the configuration item will be ignored. Options: N/A Default value: N/A

Response Parameters

Status code: 200

**Table 8** Response body parameters
Parameter	Type	Description
apiVersion	String	Definition: API version. The value is fixed at v3. Range: v3
kind	String	Definition: API type. The value is fixed at Configuration. Range: Configuration
metadata	ConfigurationMetadata object	Definition: Metadata of Configuration Range: N/A
spec	ClusterConfigurationsSpec object	Definition: Spec of Configuration Range: N/A
status	Object	Definition: Status of Configuration Range: N/A

**Table 9** ConfigurationMetadata
Parameter	Type	Description
name	String	Definition: Configuration name Range: N/A
labels	Map<String,String>	Definition: A configuration label in a key-value pair. Key: The key must contain a maximum of 63 characters that start with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. A DNS subdomain can be prefixed to a key, for example, example.com/my-key, and contain a maximum of 253 characters. Value: The value can be left empty or contain a maximum of 63 characters that start and end with a letter or digit. Only letters, digits, hyphens (-), underscores (_), and periods (.) are allowed. Example: "foo": "bar" Range: N/A

**Table 10** ClusterConfigurationsSpec
Parameter	Type	Description
packages	Array of packages objects	Definition: Component configuration item list Range: N/A

**Table 11** packages
Parameter	Type	Description
name	String	Definition: Component name Range: N/A
configurations	Array of ConfigurationItem objects	Definition: Details about component configuration items Range: N/A

**Table 12** ConfigurationItem
Parameter	Type	Description
name	String	Definition: Component configuration parameters. Options: N/A Default value: N/A
value	Object	Definition: Values of component configuration parameters. Options: N/A Default value: N/A

Example Requests

The following example describes how to update the system-reserved-mem and kube-reserved-mem parameters in kubelet.

/api/v3/projects/{project_id}/clusters/{cluster_id}/nodepools/{nodepool_id}/configuration

{
  "kind" : "Configuration",
  "apiVersion" : "v3",
  "metadata" : {
    "name" : "configuration"
  },
  "spec" : {
    "packages" : [ {
      "name" : "kubelet",
      "configurations" : [ {
        "name" : "system-reserved-mem",
        "value" : 600
      }, {
        "name" : "kube-reserved-mem",
        "value" : 800
      } ]
    } ]
  }
}

Example Responses

Status code: 200

{
  "kind" : "Configuration",
  "apiVersion" : "v3",
  "metadata" : {
    "name" : "configuration",
    "labels" : {
      "nodepool_id" : "61de338d-a1f9-11ed-8891-0255ac100036"
    }
  },
  "spec" : {
    "packages" : [ {
      "name" : "kube-apiserver",
      "configurations" : [ {
        "name" : "event-rate-limit-qps",
        "value" : 200
      }, {
        "name" : "support-overload",
        "value" : false
      } ]
    }, {
      "name" : "kube-scheduler",
      "configurations" : [ {
        "name" : "kube-api-qps",
        "value" : 100
      }, {
        "name" : "default-scheduler",
        "value" : "kube-scheduler"
      } ]
    } ]
  },
  "status" : { }
}