Configure cluster nodes responsibilities
This API request configures cluster nodes responsibilities.
Authentication
To execute this request, you need the Service Provider API (ServiceProviderAPI
) permission assigned to your API token. Generate your API token via Cluster Management Console (CMC). To learn how to obtain and use it, see Cluster API - Authentication.
Endpoint
/api/v1.0/onpremise/cluster/configuration
Parameter
Parameter | Type | Description | In | Required |
---|---|---|---|---|
body | Cluster | - | body | optional |
Request body objects
The ClusterNodesConfigDto
object
Element | Type | Description | Required |
---|---|---|---|
clusterNodes | Node | - | optional |
The NodeConfigDto
object
Element | Type | Description | Required |
---|---|---|---|
agent | boolean | - | optional |
datacenter | string | - | optional |
id | integer | - | optional |
kubernetesRole | string | - | optional |
webUI | boolean | - | optional |
Request body JSON model
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{
"clusterNodes": [
{
"agent": true,
"datacenter": "string",
"id": 1,
"kubernetesRole": "string",
"webUI": true
}
]
}
Response
Response codes
Code | Description |
---|---|
200 | Success |
Example
In this example, we disable Web UI traffic at a node 1. You can check the status of the operation with the Get cluster nodes configuration current status API call.
Curl
curl -X POST "https://myManaged.cluster.com/api/v1.0/onpremise/cluster/configuration" -H "accept: */*" -H "Content-Type: application/json" -d "{\"clusterNodes\":[{\"id\":1,\"ipAddress\":\"10.10.4.2\",\"webUI\":false,\"agent\":true,\"datacenter\":\"datacenter-1\",\"kubernetesRole\":\"\"}]}"
Request URL
https://myManaged.cluster.com/api/v1.0/onpremise/cluster/configuration
Request body
{
"clusterNodes": [
{
"id": 1,
"ipAddress": "10.10.4.2",
"webUI": false,
"agent": true,
"datacenter": "datacenter-1",
"kubernetesRole": ""
}
]
}
Response body
{
"lockAcquired": true,
"acquirationTime": 1619771074449,
"notAcquiredReason": null
}
Response code
200