Gets the information about the specified ActiveGate.
The request produces an application/json
payload.
GET | SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/{agId} |
Environment ActiveGateCluster ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/activeGates/{agId} |
To execute this request, you need an access token with activeGates.read
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameter | Type | Description | In | Required |
---|---|---|---|---|
agId | string | The ID of the required ActiveGate. | path | required |
Code | Type | Description |
---|---|---|
200 | Active | Success |
404 | Error | Not found. See response body for details. |
4XX | Error | Client side error. |
5XX | Error | Server side error. |
ActiveGate
objectParameters of the ActiveGate.
Element | Type | Description |
---|---|---|
activeGateTokens | Active | A list of the ActiveGate tokens. |
autoUpdateSettings | Active | Configuration of the ActiveGate auto-updates. |
autoUpdateStatus | string | The current status of auto-updates of the ActiveGate.
|
connectedHosts | Active | Information about hosts currently connected to the ActiveGate |
containerized | boolean | ActiveGate is deployed in container ( |
environments | string[] | A list of environments (specified by IDs) the ActiveGate can connect to. |
group | string | The group of the ActiveGate. |
hostname | string | The name of the host the ActiveGate is running on. |
id | string | The ID of the ActiveGate. |
loadBalancerAddresses | string[] | A list of Load Balancer addresses of the ActiveGate. |
mainEnvironment | string | The ID of the main environment for a multi-environment ActiveGate. |
modules | Active | A list of modules of the ActiveGate. |
networkAddresses | string[] | A list of network addresses of the ActiveGate. |
networkZone | string | The network zone of the ActiveGate. |
offlineSince | integer | The timestamp since when the ActiveGate is offline. The |
osArchitecture | string | The OS architecture that the ActiveGate is running on.
|
osBitness | string | The OS bitness that the ActiveGate is running on.
|
osType | string | The OS type that the ActiveGate is running on.
|
type | string | The type of the ActiveGate.
|
version | string | The current version of the ActiveGate in the |
ActiveGateTokenInfoDto
objectInformation about ActiveGate token.
Element | Type | Description |
---|---|---|
environmentId | string | The environment ID to which the token belongs. Only available if more than one environment is supported. |
id | string | The ActiveGate token identifier, consisting of prefix and public part of the token. |
state | string | State of the ActiveGate token.
|
ActiveGateAutoUpdateConfig
objectConfiguration of the ActiveGate auto-updates.
Element | Type | Description |
---|---|---|
effectiveSetting | string | The actual state of the ActiveGate auto-update. Applicable only if the setting parameter is set to
|
setting | string | The state of the ActiveGate auto-update: enabled, disabled, or inherited. If set to
|
ActiveGateConnectedHosts
objectInformation about hosts currently connected to the ActiveGate
Element | Type | Description |
---|---|---|
number | integer | The number of hosts currently connected to the ActiveGate |
ActiveGateModule
objectInformation about ActiveGate module
Element | Type | Description |
---|---|---|
attributes | object | The attributes of the ActiveGate module. |
enabled | boolean | The module is enabled ( |
misconfigured | boolean | The module is misconfigured ( |
type | string | The type of ActiveGate module.
|
version | string | The version of the ActiveGate module. |
{"activeGateTokens": [{"environmentId": "string","id": "dt0g02.4KWZO5EF","state": "ABSENT"}],"autoUpdateSettings": {"effectiveSetting": "ENABLED","setting": "INHERITED"},"autoUpdateStatus": "OUTDATED","connectedHosts": {"number": 150},"containerized": true,"environments": ["string"],"group": "default","hostname": "exampleHostname","id": "0x3efdd091","loadBalancerAddresses": ["string"],"mainEnvironment": "d1bf4a7e-666b-43af-9f45-718g98372e2f","modules": [{"attributes": {},"enabled": true,"misconfigured": true,"type": "KUBERNETES","version": "string"}],"networkAddresses": ["string"],"networkZone": "exampleNetworkZone","offlineSince": 1582031917814,"osArchitecture": "X86","osBitness": "64","osType": "WINDOWS","type": "ENVIRONMENT","version": "1.185.0.20200201-120000"}
In this example, the request lists the parameters of the ActiveGate with the ID of 876651882.
The API token is passed in the Authorization header.
curl -L -X GET 'https://mySampleEnv/api/v2/activeGates/876651882' \-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
https://mySampleEnv/api/v2/activeGates/876651882
{"id": "876651882","networkAddresses": ["orange-13.easytravel.com","228.245.125.39"],"osType": "LINUX","autoUpdateStatus": "UPDATE_IN_PROGRESS","offlineSince": null,"version": "1.198.0.20200630-163221","type": "ENVIRONMENT","hostname": "orange-13.easytravel.com","mainEnvironment": null,"environments": ["mySampleEnv"],"networkZone": "easytravel.europe.austria.05"}
200