Rollback the Upgrade

To rollback the upgrade, trigger the below API with the systemIDs, hostname, and the previous versions. Once the request is accepted, you will receive a response with a maintenanceID.

Warning: The rollback happens asynchronously, and uses the maintenanceID. Rollback does not accept any of the configuration inputs, whichever configurations were previously running in the Agent Installer will be used.

Format:

POST /maintenance/rollback/systems

Request Examples:

On Linux:
curl --location --request POST 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/rollback/systems' \
--header 'Authorization: Bearer {AuthToken}' \
--header 'Content-Type: application/json' \
--data-raw
{
"systemDetails": [
{
"systemId": "28f7a681-6010-4150-8940-ebee25841215",
"hostname": "hostname1"
},
{
"systemId": "28f7a681-6010-4150-8940-ebee25841216",
"hostname": "hostname2"
}
],
"versions": [
{
"type": "JAVA",
"version": "21.7.0.32930"
}
]
}
On Windows:
curl --location --request POST 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/rollback/systems' \
--header 'Authorization: Bearer {AuthToken}' \
--header 'Content-Type: application/json' \
--data-raw
{
"systemDetails": [
{
"systemId": "c44f978d-8db6-452f-9387-9b852d8df03a",
"hostname": "windows_host"
}
],
"versions": [
{
"type": "MACHINE_WINDOWS",
"version": "22.1.0.3252"
}
]
}

Input Parameters:

Parameter Name Parameter Type Description Mandatory
systemDetails.systemId

Body

 ID of the Agent Installer system

Yes
systemDetails.hostname Hostname of the Agent Installer system
versions.type Type of the monitoring agents
versions.verison Previous versions of the monitoring agents to rollback

Response Examples:

On Linux:
{
"maintenanceId": "d601aacc-97a4-479e-b2b3-db095fef34fc",
"operation": "ROLLBACK",
"status": "PENDING",
"startedAt": "2021-10-25T18:19:28.607Z",
"updatedAt": "2021-10-25T18:19:28.607Z",
"maintAgentVersions": [
{
"type": "JAVA",
"version": "20.3.0.1183"
}
],
"affectedSystemIds": [
"d601aacc-97a4-479e-b2b3-db095fef34fc"
]
}
On Windows:
{
"maintenanceId": "d601aacc-97a4-479e-b2b3-db095fef34fd",
"operation": "ROLLBACK",
"status": "PENDING",
"startedAt": "2022-05-12T18:19:28.607Z",
"updatedAt": "2022-05-12T18:19:28.607Z",
"maintAgentVersions": [
{
"type": "MACHINE_WINDOWS",
"version": "22.1.0.3252"
}
],
"affectedSystemIds": [
"c44f978d-8db6-452f-9387-9b852d8df03a"
]
}