Get the metadata of an ActiveGate token in Dynatrace by its ID with the Fleet Management API; the token secret itself is never exposed in the response.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/v1/activegate/tokens/{id} |
You use the id path parameter, the token identifier made of its prefix and public part, to read the metadata of one ActiveGate token. The response doesn't expose the token secret, which is only returned once when the token is created. Typical usage is checking a token's owner or expiration date before you rotate or delete it.
To execute this request, you need a platform token or OAuth access token with fleet-management:activegate.tokens:read scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| id | string | The ActiveGate token identifier, consisting of the prefix and public parts of the token. | path | Required |
| Code | Type | Description |
|---|---|---|
| 200 | Active | Success. The response contains the metadata of the token. |
| 4XX | Error | Client side error. |
| 5XX | Error | Server side error. |
ActiveGateToken objectMetadata of an ActiveGate token.
| Element | Type | Description |
|---|---|---|
| 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 the prefix and public parts 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 ( |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| code | integer | The HTTP status code |
| constraintViolations | Constraint | A list of constraint violations |
| message | string | The error message |
ConstraintViolation objectA list of constraint violations
| Element | Type | Description |
|---|---|---|
| location | string | - |
| message | string | - |
| parameterLocation | string | -The element can hold these values
|
| path | string | - |
{"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}
{"error": {"code": 1,"constraintViolations": [{"location": "string","message": "string","parameterLocation": "HEADER","path": "string"}],"message": "string"}}