Fetch All System Maintenance Records

Use this API to retrieve all of the system maintenance statuses of a particular maintenance request using the maintenanceId.

Warning: When an upgrade for an agent is requested, the Agent Installer automatically upgrades to the latest version. Then, it is represented by the implicitMaintenance field in the response. The configuration maintenance occurs after the version maintenance. Then, it is represented by the "operation": "CONFIGURATIONS" field in the response.

Format:

GET /maintenance/history/{maintenanceId}/systemMaintenances

Request Example:

curl --location --request GET 'https://demo.saas.appdynamics.com/zero/v1beta/maintenance/history/{maintenanceId}/systemMaintenances' --header 'Authorization: Bearer {AuthToken}'

Input Parameters:

Parameter Name Parameter Type Description Mandatory
systemMaintenanceId Path ID of the system maintenance activity Yes

Response Examples:

On Linux:
{
"total": 3,
"items": [
{
"systemMaintenanceId": "b469f73f-8530-444d-8aa1-256226de0305",
"systemId": "28f7a681-6010-4150-8940-ebee25841217",
"hostName": "hostname",
"startedAt": "1653427594984",
"updatedAt": "1653427608216",
"logsAvailable": false,
"status": "SUCCEEDED",
"prevAgentVersions": [
{
"type": "ZERO",
"version": "20.2.0.1183"
},
{
"type": "JAVA",
"version": "20.3.0.1183"
},
{
"type": "MACHINE",
"version": "22.2.0.3282"
}
],
"maintAgentVersions": [
{
"type": "ZERO",
"version": "22.5.0.2286"
}
],
"curAgentVersions": [
{
"type": "ZERO",
"version": "20.3.0.1183"
},
{
"type": "JAVA",
"version": "20.3.0.1183"
},
{
"type": "MACHINE",
"version": "22.3.0.3296"
}
],
"implicitMaintenance": true,
"operation": "UPGRADE",
"configurations": null
},
{
"systemMaintenanceId": "eab11200-cf9a-4ec5-9255-0ddbba320257",
"systemId": "28f7a681-6010-4150-8940-ebee25841217",
"hostName": "hostname",
"startedAt": "1653427594988",
"updatedAt": "1653427624802",
"logsAvailable": false,
"status": "SUCCEEDED",
"prevAgentVersions": [
{
"type": "ZERO",
"version": "20.2.0.1183"
},
{
"type": "JAVA",
"version": "20.3.0.1183"
},
{
"type": "MACHINE",
"version": "22.2.0.3282"
}
],
"maintAgentVersions": [
{
"type": "JDK8_PLUS",
"version": "22.4.0.33722"
}
],
"curAgentVersions": [
{
"type": "ZERO",
"version": "20.3.0.1183"
},
{
"type": "JAVA",
"version": "20.3.0.1183"
},
{
"type": "MACHINE",
"version": "22.3.0.3296"
}
],
"implicitMaintenance": false,
"operation": "UPGRADE",
"configurations": null
},
{
"systemMaintenanceId": "913d9929-a94b-472e-830f-ac1a4b68bc40",
"systemId": "28f7a681-6010-4150-8940-ebee25841217",
"hostName": "hostname",
"startedAt": "1653427594989",
"updatedAt": "1653427642527",
"logsAvailable": false,
"status": "SUCCEEDED",
"prevAgentVersions": [
{
"type": "ZERO",
"version": "20.2.0.1183"
},
{
"type": "JAVA",
"version": "20.3.0.1183"
},
{
"type": "MACHINE",
"version": "22.2.0.3282"
}
],
"maintAgentVersions": [],
"curAgentVersions": [
{
"type": "ZERO",
"version": "20.3.0.1183"
},
{
"type": "JAVA",
"version": "20.3.0.1183"
},
{
"type": "MACHINE",
"version": "22.3.0.3296"
}
],
"implicitMaintenance": false,
"operation": "CONFIGURATION",
"configurations": {
"enableOtel": true,
"otelProperties": {
"tracesExporter": "otlp,logging",
"metricsExporter": "otlp",
"otlpEndpoint": "http://localhost:4317"
},
"enableSim": null,
"dotnetCompatibility": null
}
}
]
}
On Windows:
{
"total": 3,
"items": [
{
"systemMaintenanceId": "85473377-f46b-4ab8-941f-9c34a555c15a",
"systemId": "28f7a681-6010-4150-8940-ebee25841217",
"hostName": "hostname",
"startedAt": "1653430383251",
"updatedAt": "1653430397986",
"logsAvailable": false,
"status": "SUCCEEDED",
"prevAgentVersions": [
{
"type": "ZERO_WINDOWS",
"version": "20.2.0.1183"
},
{
"type": "MACHINE_WINDOWS",
"version": "22.2.0.3282"
}
],
"maintAgentVersions": [
{
"type": "ZERO_WINDOWS",
"version": "22.5.0.2286"
}
],
"curAgentVersions": [
{
"type": "ZERO_WINDOWS",
"version": "20.3.0.1183"
},
{
"type": "MACHINE_WINDOWS",
"version": "22.3.0.3296"
}
],
"implicitMaintenance": true,
"operation": "UPGRADE",
"configurations": null
},
{
"systemMaintenanceId": "5e8df22e-3e10-490a-874f-e7a8f9a1cd78",
"systemId": "28f7a681-6010-4150-8940-ebee25841217",
"hostName": "hostname",
"startedAt": "1653430383259",
"updatedAt": "1653430480344",
"logsAvailable": false,
"status": "SUCCEEDED",
"prevAgentVersions": [
{
"type": "ZERO_WINDOWS",
"version": "20.2.0.1183"
},
{
"type": "MACHINE_WINDOWS",
"version": "22.2.0.3282"
}
],
"maintAgentVersions": [
{
"type": "MACHINE_WINDOWS",
"version": "22.4.0.3344"
}
],
"curAgentVersions": [
{
"type": "ZERO_WINDOWS",
"version": "20.3.0.1183"
},
{
"type": "MACHINE_WINDOWS",
"version": "22.3.0.3296"
}
],
"implicitMaintenance": false,
"operation": "UPGRADE",
"configurations": null
},
{
"systemMaintenanceId": "4327f68b-78b1-4296-abf6-4c63c5012419",
"systemId": "28f7a681-6010-4150-8940-ebee25841217",
"hostName": "hostname",
"startedAt": "1653430383262",
"updatedAt": "1653430502656",
"logsAvailable": false,
"status": "SUCCEEDED",
"prevAgentVersions": [
{
"type": "ZERO_WINDOWS",
"version": "20.2.0.1183"
},
{
"type": "MACHINE_WINDOWS",
"version": "22.2.0.3282"
}
],
"maintAgentVersions": [],
"curAgentVersions": [
{
"type": "ZERO_WINDOWS",
"version": "20.3.0.1183"
},
{
"type": "MACHINE_WINDOWS",
"version": "22.3.0.3296"
}
],
"implicitMaintenance": false,
"operation": "CONFIGURATION",
"configurations": {
"enableOtel": null,
"otelProperties": null,
"enableSim": true,
"dotnetCompatibility": true
}
}
]
}