ActiveGate tokens API - GET a token
Gets metadata of the ActiveGate token by its ID.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v2/activeGateTokens/{activeGateTokenIdentifier} |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/activeGateTokens/{activeGateTokenIdentifier} | |
Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGateTokens/{activeGateTokenIdentifier} |
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
Parameter | Type | Description | In | Required |
---|---|---|---|---|
activeGateTokenIdentifier | string | The ActiveGate token identifier, consisting of prefix and public part of the token. | path | required |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | Active | Success. The response contains the metadata of the tokens. |
400 | ErrorEnvelope | Failed. The input is invalid. |
404 | ErrorEnvelope | Failed. The requested resource doesn't exist. |
Response body objects
The ActiveGateToken
object
Metadata of an ActiveGate token.
Element | Type | Description |
---|---|---|
activeGateType | string | The type of the ActiveGate for which the token is valid. |
creationDate | string | The token creation date in ISO 8601 format ( |
expirationDate | string | The token expiration date in ISO 8601 format ( If not set, the token never expires. |
id | string | The ActiveGate token identifier, consisting of prefix and public part of the token. |
lastUsedDate | string | The token last used date in ISO 8601 format ( |
name | string | The name of the token. |
owner | string | The owner of the token. |
seedToken | boolean | The token is a seed token ( |
Response body JSON model
{
"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
}
Example
In this example, the request retrieves metadata for the token with the ID of dt0g02.abc123.
The API token is passed in the Authorization header.
Curl
curl --request GET \
--url https://mySampleEnv.live.dynatrace.com//api/v2/activeGateTokens/dt0g02.abc123 \
--header 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
https://mySampleEnv.live.dynatrace.com//api/v2/activeGateTokens/dt0g02.abc123
Response body
{
"id": "dt0g02.abc123",
"name": "system:installer",
"owner": "max.mustermann@company.com",
"creationDate": "2021-11-22T11:39:29.797Z",
"seedToken": true,
"activeGateType": "ENVIRONMENT"
}
Response code
200