Create new Cluster token

Creates a new Dynatrace Cluster token. The response contains the newly created token.

The request consumes and produces an application/json payload.

Endpoint

/api/cluster/v2/tokens

Parameters

Parameter	Type	Description	In	Required
body	CreateToken	The JSON body of the request. Contains parameters of the new token.	body	optional

Body format

Request parametersJSON model

The CreateToken object

Element Type Description Required

name

string

Element	Type	Description	Required
name	string	The name of the token.	required
expiresIn	Duration		optional
scopes	string[]	The list of scopes to be assigned to the token. `DiagnosticExport`: DiagnosticExport. `ControlManagement`: ControlManagement. `UnattendedInstall`: UnattendedInstall. `ServiceProviderAPI`: Service Provider API. `ExternalSyntheticIntegration`: Create and read synthetic monitors, locations, and nodes. `ClusterTokenManagement`: Cluster token management. `ReadSyntheticData`: Read synthetic monitors, locations, and nodes. `Nodekeeper`: Nodekeeper access for node management. `EnvironmentTokenManagement`: "Token Management" Token creation for existing environments. `apiTokens.read`: Read API tokens. `apiTokens.write`: Write API tokens. The element can hold these values DiagnosticExport ControlManagement UnattendedInstall ServiceProviderAPI ExternalSyntheticIntegration ClusterTokenManagement ReadSyntheticData Nodekeeper EnvironmentTokenManagement apiTokens.read apiTokens.write	required

The name of the token.

required

expiresIn Duration optional

scopes

string[]

The list of scopes to be assigned to the token.

DiagnosticExport: DiagnosticExport.
ControlManagement: ControlManagement.
UnattendedInstall: UnattendedInstall.
ServiceProviderAPI: Service Provider API.
ExternalSyntheticIntegration: Create and read synthetic monitors, locations, and nodes.
ClusterTokenManagement: Cluster token management.
ReadSyntheticData: Read synthetic monitors, locations, and nodes.
Nodekeeper: Nodekeeper access for node management.
EnvironmentTokenManagement: "Token Management" Token creation for existing environments.
apiTokens.read: Read API tokens.
apiTokens.write: Write API tokens.

The element can hold these values

DiagnosticExport
ControlManagement
UnattendedInstall
ServiceProviderAPI
ExternalSyntheticIntegration
ClusterTokenManagement
ReadSyntheticData
Nodekeeper
EnvironmentTokenManagement
apiTokens.read
apiTokens.write

required

The Duration object

Defines a period of time.

Element	Type	Description	Required
value	integer	The amount of time.	required
unit	string	The unit of time. If not set, millisecond is used. The element can hold these values DAYS HOURS MILLIS MINUTES SECONDS	optional

Element

Type

Description

Required

value

integer

The amount of time.

required

unit

string

The unit of time.

If not set, millisecond is used.

The element can hold these values

DAYS
HOURS
MILLIS
MINUTES
SECONDS

optional

This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request. See the Example expandable section for working sample request.

      {
  "name": "string",
  "expiresIn": {
    "value": 1,
    "unit": "DAYS"
  },
  "scopes": [
    "DiagnosticExport"
  ]
}

Response

Response codes

Code	Description
201	Success. The token has been created. The response body contains the token itself.
400	Failed. The input is invalid. Response body provides details.

Response body

Response parametersJSON model

The Token object

Element	Type	Description
token	string	Dynatrace API authentication token.

    {
  "token": "abcdefjhij1234567890"
}

Example

In this example, the request creates a new token named Mytoken that is valid for 24 hours. With this token you will be able to perform a diagnostic export (DiagnosticExport) and unattended install (UnattendedInstall).

Curl

curl -X POST "https://myManaged.cluster.com/api/cluster/v2/tokens"
          -H "accept: application/json; charset=utf-8"
          -H "Content-Type: application/json; charset=utf-8"
          -d "{  \"name\": \"MyToken\",  \"scopes\": [    \"DiagnosticExport\",    \"UnattendedInstall\"  ],  \"expiresIn\": {    \"value\": 24,    \"unit\": \"HOURS\"  }}"

Request URL

https://myManaged.cluster.com/api/cluster/v2/tokens

Request body


        api-examples/cluster/token/post-cluster-token.json

Download

{
  "name": "MyToken",
  "scopes": [
    "DiagnosticExport",
    "UnattendedInstall"
  ],
  "expiresIn": {
    "value": 24,
    "unit": "HOURS"
  }
}

Response body

{
  "token": "abcdefjhij1234567890"
}

Response code

201