ActiveGate API - POST an auto-update job
Creates a new auto-update job on the specified ActiveGate.
The job updates the ActiveGate to the specified version. You can fetch the list of available versions with the GET available versions of ActiveGate call.
The request consumes and produces an application/json payload.
| POST | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/{agId}/updateJobs |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/{agId}/updateJobs | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/{agId}/updateJobs |
Authentication
To execute this request, you need an access token with Write ActiveGates (activeGates.write) 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 |
| body | Update | JSON body of the request, containing update-job parameters. | body | required |
Request body objects
The UpdateJob object
Configuration of the ActiveGate update job.
| Element | Type | Description |
|---|---|---|
| jobId | string | The ID of the update job. Can be |
| jobState | string | The status of the update job. Can be |
| updateMethod | string | The method of updating the ActiveGate or its component. Can be |
| updateType | string | The component to be updated. Can be |
| agType | string | The type of the ActiveGate. Can be |
| startVersion | string | The initial version of the ActiveGate. Can be |
| environments | string[] | A list of environments (specified by IDs) the ActiveGate can connect to. Can be |
| cancelable | boolean | The job can ( Can be |
| duration | integer | The duration of the update, in milliseconds. Can be |
| timestamp | integer | The timestamp of the update job completion. The Can be |
| error | string | The information about update error. Can be |
| targetVersion | string | The target version of the update. Specify the version in the To update to the latest available version, use the |
Request body JSON model
This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{
"jobId": "-3524498778810258605",
"jobState": "SUCCEED",
"updateMethod": "AUTOMATIC",
"updateType": "ACTIVE_GATE",
"agType": "ENVIRONMENT",
"startVersion": "1.185.0.20200201-120000",
"environments": [
"string"
],
"cancelable": false,
"duration": 3608000,
"timestamp": 1582031917814,
"error": "string",
"targetVersion": "1.190.0.20200301-130000"
}Response
Response codes
| Code | Type | Description |
|---|---|---|
| 201 | Update | Success. The update-job have been created. |
| 400 | Error | Failed. The input is invalid. |
Response body objects
The UpdateJob object
Configuration of the ActiveGate update job.
| Element | Type | Description |
|---|---|---|
| jobId | string | The ID of the update job. Can be |
| jobState | string | The status of the update job. Can be |
| updateMethod | string | The method of updating the ActiveGate or its component. Can be |
| updateType | string | The component to be updated. Can be |
| agType | string | The type of the ActiveGate. Can be |
| startVersion | string | The initial version of the ActiveGate. Can be |
| environments | string[] | A list of environments (specified by IDs) the ActiveGate can connect to. Can be |
| cancelable | boolean | The job can ( Can be |
| duration | integer | The duration of the update, in milliseconds. Can be |
| timestamp | integer | The timestamp of the update job completion. The Can be |
| error | string | The information about update error. Can be |
| targetVersion | string | The target version of the update. Specify the version in the To update to the latest available version, use the |
Response body JSON model
{
"jobId": "-3524498778810258605",
"jobState": "SUCCEED",
"updateMethod": "AUTOMATIC",
"updateType": "ACTIVE_GATE",
"agType": "ENVIRONMENT",
"startVersion": "1.185.0.20200201-120000",
"environments": [
"string"
],
"cancelable": false,
"duration": 3608000,
"timestamp": 1582031917814,
"error": "string",
"targetVersion": "1.190.0.20200301-130000"
}Validate payload
We recommend that you validate the payload before submitting it with an actual request. A response code of 204 indicates a valid payload.
The request consumes an application/json payload.
| POST | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/activeGates/{agId}/updateJobs/validator |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/activeGates/{agId}/updateJobs/validator | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/activeGates/{agId}/updateJobs/validator |
Authentication
To execute this request, you need an access token with Write ActiveGates (activeGates.write) scope. To learn how to obtain and use it, see Tokens and authentication.
Response
Response codes
| Code | Type | Description |
|---|---|---|
| 204 | - | Validated. The submitted update-job is valid. Response doesn't have a body. |
| 400 | Error | Failed. The input is invalid. |
Example
In this example, the request creates an update job to update the ActiveGate with the ID of 1812885988 to the 1.198.0.20200630-163221 version.
The API token is passed in the Authorization header.
Curl
curl -L -X POST 'https://mySampleEnv.live.dynatrace.com/api/v2/activeGates/1812885988/updateJobs' \
-H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \
-H 'Content-Type: application/json' \
--data-raw '{
"targetVersion": "1.198.0.20200630-163221"
}'Request URL
https://mySampleEnv.live.dynatrace.com/api/v2/activeGates/1812885988/updateJobsRequest body
{
"targetVersion": "1.198.0.20200630-163221"
}Response body
{
"jobId": "-7240069678607892845",
"jobState": "PENDING",
"updateMethod": null,
"updateType": null,
"cancelable": true,
"startVersion": "1.195.5.20200522-174041",
"targetVersion": "1.198.0.20200630-163221",
"timestamp": null,
"agType": "ENVIRONMENT",
"environments": [
"mySampleEnv"
],
"error": null,
"duration": null
}Response code
201