Settings API - OneAgent updates schema table

OneAgent updates (`builtin:deployment.oneagent.updates`)

Configure OneAgent update behavior. To learn more about the latest updates, visit OneAgent release notes. To configure RUM JavaScript update behaviour, visit 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`

Retrieve schema via Settings API

GET	Managed	`https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:deployment.oneagent.updates`
	SaaS	`https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:deployment.oneagent.updates`
	Environment ActiveGate	`https://{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	Label	Type	Description	Required
updateMode	Update mode	enum	-	required
maintenanceWindows	Maintenance windows	set	-	required
targetVersion	Target version	text	-	required
revision	Revision	text	-	required

Request body objects

The `maintenanceWindow` object

Property	Label	Type	Description	Required
maintenanceWindow	Maintenance window	setting	Select a maintenance window for OneAgent updates (`<your-dynatrace-url>/ui/settings/builtin:deployment.management.update-windows`)	required