Configure cluster nodes responsibilities

Dynatrace Managed Documentation

This page will soon be available only on the dedicated Dynatrace Managed Documentation site. Update your bookmarks.

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	ClusterNodesConfigDto	-	body	optional

Request body objects

The `ClusterNodesConfigDto` object

Element	Type	Description	Required
clusterNodes	NodeConfigDto[]	-	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.

1{
2  "clusterNodes": [
3    {
4      "agent": true,
5      "datacenter": "string",
6      "id": 1,
7      "kubernetesRole": "string",
8      "webUI": true
9    }
10  ]
11}

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

1curl -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

1https://myManaged.cluster.com/api/v1.0/onpremise/cluster/configuration

Request body

1{
2  "clusterNodes": [
3    {
4      "id": 1,
5      "ipAddress": "10.10.4.2",
6      "webUI": false,
7      "agent": true,
8      "datacenter": "datacenter-1",
9      "kubernetesRole": ""
10    }
11  ]
12}

Response body

1{
2  "lockAcquired": true,
3  "acquirationTime": 1619771074449,
4  "notAcquiredReason": null
5}

Response code

200