Settings API - OneAgent updates schema table

OneAgent updates (builtin:deployment.oneagent.updates)

Select the OneAgent target version and configure update behavior. The selected version is also used for the Deployment API and OneAgent deployment pages. For more about the OneAgent target version, see OneAgent update. To learn more about the latest updates, see the OneAgent release notes. To configure RUM JavaScript update behavior, see RUM JavaScript updates (<your-dynatrace-url>//ui/settings/builtin:rum.web.rum-javascript-updates).

Schema ID
Schema groups
Scope
builtin:deployment.oneagent.updates
  • group:updates
HOST - Host
HOST_GROUP - Host Group
environment
GETManagedhttps://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:deployment.oneagent.updates
SaaShttps://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:deployment.oneagent.updates
Environment ActiveGatehttps://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:deployment.oneagent.updates

Authentication

To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Property
Type
Description
Required
Target version
targetVersion
text
-
required
Revision
revision
text
-
required
Update mode
updateMode
enum
  • AUTOMATIC
  • AUTOMATIC_DURING_MW
  • MANUAL
required
Update windows
maintenanceWindows
-
required
The maintenanceWindow object
Property
Type
Description
Required
Update window
maintenanceWindow
setting

Select an update window for OneAgent updates (<your-dynatrace-url>//ui/settings/builtin:deployment.management.update-windows)

required