Mission Control API
To get authenticated to use the Mission Control API, you need a valid OAuth REST API client token. Access to the API is controlled by scope, meaning that you also need the proper permissions assigned to the token. See the description below to find out which permissions are required to use it.
-
Register a client (Generate SSO client credentials).
Execute the following REST call:
curl -X POST "https://mcsvc.dynatrace.com/rest/public/v1.0/oauth/registration/withLicenseKey"-H "accept: application/json"-u "<cluster-identifier>:<license-key>"where:
<cluster-identifier>is a cluster identifier (in Dynatrace, go to Licensing). For example,0a00a0a0-92ec-11e7-b1e6-12fbd1fb3732<license-key>is a license key provided to you in welcome email and visible in Licensing. For example,0a0aAAAA0jeUv6N.
As a result, you should receive a JSON response containing
clientIdandclientSecretand the response code200. For example:{"clientId": "dt0s04.AAAAAAAA","clientSecret": "dt0s04.AAAAAAAA.AAAA00AAAAAAAAAA0OBA6AVNCQVQAGSO25VM5KDFBIKEZ7HVG6THKTHGWAY5ACCL","scopes": ["sso20-managed-cluster-offline-bundle","sso20-identity-linking"]}200 -
Generate a token (Generate SSO token).
Currently, only thesso20-managed-cluster-offline-bundlescope, which allows to generate update package download URLs is supported.Using the
clientIdandclientSecretfrom the previous call, execute the following REST call:curl -X POST "https://mcsvc.dynatrace.com/rest/public/v1.0/oauth/api-token" \-H "accept: application/json" \-H "Content-Type: application/json" \-d "{ \"clientId\": \"dt0s04.AAAAAAAA\", \"clientSecret\": \"dt0s04.AAAAAAAA.AAAA00AAAAAAAAAA0OBA6AVNCQVQAGSO25VM5KDFBIKEZ7HVG6THKTHGWAY5ACCL\", \"scope\": \"sso20-managed-cluster-offline-bundle\"}"As a result you will receive a JSON response with a token, associated scopes and the token expiration date. For example:
{"token": "aaA0aAAaAaAAA0AaAAAaaAaaAaAAAaA0AaA0.eyJzdWIiOiJjbHVzdGVyLTBhMDBhMGEwLTkyZWMtMTFlNy1iMWU2LTEyZmJkMWZiMzczMkBkeW5hdHJhY2UtbWFuYWdlZC5jb20iLCJhdWQiOiJkdDBzMDQuTFFWT1FQQVMiLCJ1aWQiOiI5N2Y0OGFhMy1jYmRiLTRkMzEtOGE2YS02NjUyNTQxMzY5MTIiLCJzY29wZSI6InNzbzIwLW1hbmFnZWQtY2x1c3Rlci1vZmZsaW5lLWJ1bmRsZSIsImlzcyI6Imh0dHBzOi8vc3NvLXNwcmludC5keW5hdHJhY2VsYWJzLmNvbTo0NDMiLCJleHAiOjE2MTU0NzcxNTIsImdyYW50VHlwZSI6ImNsaWVudF9jcmVkZW50aWFscyIsImlhdCI6MTYxNTQ2OTk1Mn0.svn34bJEZbziHVyV7cKW9OWwvBwakzH0Ke_Iu19GV743zrC4zHuX4YQFts-JkEHRYmnVvnQRwPPCakuq0LHVjA","scopes": ["sso20-managed-cluster-offline-bundle"],"expiresAt": 1615477153001}200 -
Authenticate in your API calls.
Your API call can get authenticated per call via an HTTP header authorization. You can authenticate by attaching the token to the authorization HTTP header preceding the
Bearerrealm.curl -X GET "https://mcsvc.dynatrace.com/rest/public/downloads/offline-bundle/published"-H "accept: application/json"-H "Authorization: Bearer aaA0aAAaAaAAA0AaAAAaaAaaAaAAAaA0AaA0.eyJzdWIiOiJjbHVzdGVyLTBhMDBhMGEwLTkyZWMtMTFlNy1iMWU2LTEyZmJkMWZiMzczMkBkeW5hdHJhY2UtbWFuYWdlZC5jb20iLCJhdWQiOiJkdDBzMDQuTFFWT1FQQVMiLCJ1aWQiOiI5N2Y0OGFhMy1jYmRiLTRkMzEtOGE2YS02NjUyNTQxMzY5MTIiLCJzY29wZSI6InNzbzIwLW1hbmFnZWQtY2x1c3Rlci1vZmZsaW5lLWJ1bmRsZSIsImlzcyI6Imh0dHBzOi8vc3NvLXNwcmludC5keW5hdHJhY2VsYWJzLmNvbTo0NDMiLCJleHAiOjE2MTU0NzcxNTIsImdyYW50VHlwZSI6ImNsaWVudF9jcmVkZW50aWFscyIsImlhdCI6MTYxNTQ2OTk1Mn0.svn34bJEZbziHVyV7cKW9OWwvBwakzH0Ke_Iu19GV743zrC4zHuX4YQFts-JkEHRYmnVvnQRwPPCakuq0LHVjA"Unless otherwise specified, the following response codes are used:
200- OK. The request is successful.400- Bad request. The request has failed. The body of the response provides additional details.401- Unauthorized. The token authentication has failed. Check to see if your token has the required permissions.404- Not found. The requested resource is not found. Check if your input is correct.429- Too many requests. Mission Control is currently busy, try again later.