rds.instances.describe-maintenanceVersions per node, the pending minor upgrade, the maintenance window and when it next opens
Request syntax
GET /rds/api/instances/{id}/maintenancePath parameters
idRequiredstring
Constraints: 3-64 chars, /^(?!ewdoc-)[a-z0-9-]+$/
Response
200 with engineVersion, upgradeTarget, upgradeableTo (minors), majorUpgradeableTo, maintenanceWindow, autoMinorVersionUpgrade, nextWindowStart, inPlaceUpgrades, inProgress and nodes: each node’s id, name, engineVersion, whether its maintenance agent answers, and its lastOperation.
A JSON response is wrapped as { "success": true, "data": … }; the CLI prints the whole body with --json.
Fields of data
engineVersionAlwaysstring
PostgreSQL version of the database, e.g. 17.11upgradeTargetAlwaysstring, may be null
Minor the next maintenance window installs; null: none pendingupgradeableToAlwaysarray of string
Newer minors of its major that upgrade can installmajorUpgradeableToAlwaysarray of string
Newer majors it can move to, each at its pinned minormaintenanceWindowAlwaysstring, may be null
Maintenance window, UTC ddd:hh24:mi-ddd:hh24:miautoMinorVersionUpgradeAlwaysboolean
Whether new minors are applied in the windownextWindowStartAlwaysstring, may be null
When the window next opens; null: no windowinPlaceUpgradesAlwaysboolean
Every node can be upgraded in placeinProgressAlwaysboolean
Maintenance is running nownodesAlwaysarray of object
Each node with a machinenodes[].idAlwaysstring
Node idnodes[].nameAlwaysstring
Node namenodes[].engineVersionAlwaysstring, may be null
Version the node runs; null until it reportsnodes[].agentAlwaysboolean
Whether the node takes in-place maintenance worknodes[].lastOperationAlwaysobject, may be null
Current or last maintenance operation; null: nonenodes[].lastOperation.statusAlwaysone of pending, running, succeeded, failed
State of the operationnodes[].lastOperation.packageVersionAlwaysstring
Package version it installsnodes[].lastOperation.requestedAtAlwaysstring
When it was asked fornodes[].lastOperation.finishedAtAlwaysstring, may be null
When it finished
Checked against the handlers: every route test validates their answers against this schema.
Errors
- 400The request does not pass the schema above. The body is { "error": …, "issues": […] }, one issue per field.
- 401No credentials, or an access key that is unknown, revoked or expired.
- 403The caller's policies do not allow rds:DescribeDBInstances on this resource. The body names the action and the resource, and the refusal is recorded in the audit log.
- 404The resource does not exist in your organization.
Examples
The required parameters only, with example values. Replace id and the other placeholders with your own.
dcloud rds instances describe-maintenance idcurl -X GET "https://console.platform-development.deutschecloud.app/rds/api/instances/id/maintenance" \
-H "Authorization: EWS-ACCESS-KEY $ACCESS_KEY"Generated from the API description, the same one the API checks requests against and the CLI is built from. MCP tool: dcloud_rds_instances_describe-maintenance.