Plugins API - GET states of an ActiveGate plugin
Lists the endpoint states of the specified plugin.
States are stored in server memory and are cleared with restart.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/config/v1/plugins/{id}/states |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/config/v1/plugins/{id}/states | |
Environment ActiveGate | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/config/v1/plugins/{id}/states |
Authentication
To execute this request, you need an access token with ReadConfig
scope.
To learn how to obtain and use it, see Tokens and authentication.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
id | string | The ID of the required plugin. | path | required |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | PluginStateList | Success |
Response body objects
The PluginStateList
object
A list of plugin states.
Element | Type | Description |
---|---|---|
states | PluginState[] | A list of plugin states. |
The PluginState
object
The state of the plugin.
Element | Type | Description |
---|---|---|
endpointId | string | The ID of the endpoint where the state is detected - Active Gate only. |
hostId | string | The ID of the host on which the plugin runs. |
pluginId | string | The ID of the plugin. |
processId | string | The ID of the entity on which the plugin is active. |
state | string | The state of the plugin.
|
stateDescription | string | A short description of the state. |
timestamp | integer | The timestamp when the state was detected, in UTC milliseconds. |
version | string | The version of the plugin (for example |
Response body JSON model
1{2 "endpointId": "-8213819843595439277",3 "pluginId": "custom.remote.python.demo",4 "state": "ERROR_AUTH",5 "stateDescription": "Could not authorize",6 "timestamp": 1556199097994,7 "version": "1.0.0"8}
Example
In this example, the request lists the states of the MathPlugin, which has the ID of custom.remote.python.simple_math.
Curl
1curl -X GET \2 https://mySampleEnv.live.dynatrace.com/api/config/v1/plugins/custom.remote.python.simple_math/states \3 -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
1https://mySampleEnv.live.dynatrace.com/api/config/v1/plugins/custom.remote.python.simple_math/states
Response body
1{2 "states": [3 {4 "pluginId": "custom.remote.python.simple_math",5 "version": "1.02",6 "endpointId": "575712901374982783",7 "state": "OK",8 "stateDescription": "",9 "timestamp": 156034324417810 }11 ]12}
Response code
200