ActiveGate API - GET an auto-update job
Gets the parameters of the specified ActiveGate auto-update job.
The request produces an application/json
payload.
GET | ManagedDynatrace for Government | https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/{agId}/updateJobs/{jobId} |
SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/{agId}/updateJobs/{jobId} | |
Environment and Cluster ActiveGate (default port 9999) | https://{your-activegate-domain}:9999/e/{your-environment-id}/api/v2/activeGates/{agId}/updateJobs/{jobId} |
Authentication
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.
Parameters
Parameter | Type | Description | In | Required |
---|---|---|---|---|
agId | string | The ID of the required ActiveGate. | path | required |
jobId | string | A unique identifier for a update-job of ActiveGate. | path | required |
Response
Response codes
Code | Type | Description |
---|---|---|
200 | UpdateJob | Success |
404 | ErrorEnvelope | Not found. See response body for details. |
Response body objects
The UpdateJob
object
Configuration of the ActiveGate update job.
Element | Type | Description |
---|---|---|
agType | string | The type of the ActiveGate.
|
cancelable | boolean | The job can ( |
duration | integer | The duration of the update, in milliseconds. |
environments | string[] | A list of environments (specified by IDs) the ActiveGate can connect to. |
error | string | The information about update error. |
jobId | string | The ID of the update job. |
jobState | string | The status of the update job.
|
startVersion | string | The initial version of the ActiveGate. |
targetVersion | string | The target version of the update. Specify the version in the To update to the latest available version, use the |
timestamp | integer | The timestamp of the update job completion. The |
updateMethod | string | The method of updating the ActiveGate or its component.
|
updateType | string | The component to be updated.
|
Response body JSON model
1{2 "agType": "ENVIRONMENT",3 "cancelable": false,4 "duration": 3608000,5 "environments": [6 "string"7 ],8 "error": "string",9 "jobId": "-3524498778810258605",10 "jobState": "SUCCEED",11 "startVersion": "1.185.0.20200201-120000",12 "targetVersion": "1.190.0.20200301-130000",13 "timestamp": 1582031917814,14 "updateMethod": "AUTOMATIC",15 "updateType": "ACTIVE_GATE"16}
Example
In this example, the request lists the parameters of the auto-update job with the ID of -7537034309286328684 from the ActiveGate with the ID of 2131628184.
The API token is passed in the Authorization header.
Curl
1curl -L -X GET 'https://mySampleEnv.live.dynatrace.com/api/v2/activeGates/2131628184/updateJobs/-7537034309286328684' \2-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890'
Request URL
1https://mySampleEnv.live.dynatrace.com/api/v2/activeGates/2131628184/updateJobs/-7537034309286328684
Response body
1{2 "jobId": "-7537034309286328684",3 "jobState": "SUCCEED",4 "updateMethod": "AUTOMATIC",5 "updateType": "SYNTHETIC",6 "cancelable": false,7 "startVersion": "1.198.0.20200629-183024",8 "targetVersion": "1.198.0.20200630-114457",9 "timestamp": 1593518788274,10 "agType": "ENVIRONMENT",11 "environments": [12 "mySampleEnv"13 ],14 "error": null,15 "duration": 59604716}
Response code
200