ActiveGate tokens API - GET all tokens

Lists all ActiveGate tokens available for your environment.

You can limit the output by using the pagination:

  1. Specify the number of results per page in the pageSize query parameter.
  2. Then use the cursor from the nextPageKey field of the previous response in the nextPageKey query parameter to obtain subsequent pages.

The request produces an application/json payload.

GETSaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/activeGateTokens
Environment ActiveGateCluster ActiveGatehttps://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/activeGateTokens

Authentication

To execute this request, you need an access token with activeGateTokenManagement.read scope.

To learn how to obtain and use it, see Tokens and authentication.

Parameters

ParameterTypeDescriptionInRequired
nextPageKeystring

The cursor for the next page of results. You can find it in the nextPageKey field of the previous response.

The first page is always returned if you don't specify the nextPageKey query parameter.

When the nextPageKey is set to obtain subsequent pages, you must omit all other query parameters.

queryoptional
pageSizeinteger

The amount of ActiveGate tokens in a single response payload.

The maximal allowed page size is 3000 and the minimal size is 100.

If not set, 100 is used.

queryoptional

Response

Response codes

CodeTypeDescription
200ActiveGateTokenList

Success. The response contains the list of ActiveGate tokens.

400ErrorEnvelope

Failed. The input is invalid.

404ErrorEnvelope

Failed. The requested resource doesn't exist.

4XXErrorEnvelope

Client side error.

5XXErrorEnvelope

Server side error.

Response body objects

The ActiveGateTokenList object

A list of ActiveGate tokens.

ElementTypeDescription
activeGateTokensActiveGateToken[]

A list of ActiveGate tokens.

nextPageKeystring

The cursor for the next page of results. Has the value of null on the last page.

Use it in the nextPageKey query parameter to obtain subsequent pages of the result.

pageSizeinteger

The number of entries per page.

totalCountinteger

The total number of entries in the result.

The ActiveGateToken object

Metadata of an ActiveGate token.

ElementTypeDescription
activeGateTypestring

The type of the ActiveGate for which the token is valid.

  • ENVIRONMENT
  • CLUSTER
creationDatestring

The token creation date in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z').

expirationDatestring

The token expiration date in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z').

If not set, the token never expires.

idstring

The ActiveGate token identifier, consisting of prefix and public part of the token.

lastUsedDatestring

The token last used date in ISO 8601 format (yyyy-MM-dd'T'HH:mm:ss.SSS'Z').

namestring

The name of the token.

ownerstring

The owner of the token.

seedTokenboolean

The token is a seed token (true) or an individual token (false).

Response body JSON model

{
  "activeGateTokens": {
    "activeGateType": "ENVIRONMENT",
    "creationDate": "2020-11-22T08:15:30.144Z",
    "expirationDate": "2020-11-24T08:15:30.144Z",
    "id": "dt0g02.4KWZO5EF",
    "lastUsedDate": "2020-11-23T08:15:30.144Z",
    "name": "myToken",
    "owner": "john.smith",
    "seedToken": "false"
  },
  "nextPageKey": "AAAAAAAAAAAAAABOAAAAAAAAAAAAAAA6ACQAEAAAABgACgAITFdXQk1BRzYAAAhtZXRhZGF0YQB___-bf___m3iIYxfF7xVQvY72rwblQkcAAwAAAAAAAADHAAAAZA==",
  "pageSize": 100,
  "totalCount": 1000
}

Example

In this example, the request lists all ActiveGate tokens available for the mySampleEnv environment.

The API token is passed in the Authorization header.

The result is truncated to three entries.

Curl

curl --request GET \
  --url https://mySampleEnv.live.dynatrace.com//api/v2/activeGateTokens \
  --header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'

Request URL

https://mySampleEnv.live.dynatrace.com//api/v2/activeGateTokens

Response body

{
  "totalCount": 3,
  "pageSize": 3,
  "activeGateTokens": [
    {
      "id": "dt0g02.abc123",
      "name": "system:installer",
      "owner": "max.mustermann@company.com",
      "creationDate": "2021-11-22T11:39:29.797Z",
      "seedToken": true,
      "activeGateType": "ENVIRONMENT"
    },
    {
      "id": "dt0g02.321cba",
      "name": "system:installer",
      "owner": "john.smith@company.com",
      "creationDate": "2021-11-30T14:11:40.913Z",
      "seedToken": true,
      "activeGateType": "ENVIRONMENT"
    },
    {
      "id": "dt0g02.123abc",
      "name": "system:initial-setup",
      "owner": "mary.brown@company.com",
      "creationDate": "2021-10-22T13:48:00.135Z",
      "lastUsedDate": "2021-12-02T11:52:17.201Z",
      "seedToken": false,
      "activeGateType": "ENVIRONMENT"
    },
  ]
}

Response code

200

Related topics