Setting the Daily Maintenance Time (v2)

Note: To ensure that the use of this API does not interfere with the Oracle requirement for creating backups, this API will not change the maintenance start time if the daily maintenance process did not run in the last 36 hours.

Before using the REST resources, you must understand how to access the REST resources and other important concepts. See About the REST APIs. Using this REST API requires prerequisites. See Prerequisites.

This API is version v2

Required Roles

Service Administrator

REST Resource

PUT /interop/rest/v2/maintenance/setdailymaintenancestarttime

Parameters:

The following table summarizes the request parameters.

Table 11-8 Parameters

Name	Description	Type	Required	Default
`StartTime`	Scheduled time (in HH:00 format using a 24 hour clock) at which the maintenance process should start and an optional time zone. Acceptable start time value range is 00:00 - 23:00. If the start time is not to be set in UTC, specify a valid standard time zone; for example, "14:00 America/Los_Angeles" for 2:00 pm Pacific Standard Time.	Payload	Yes	None

Example URL and Payload

https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/interop/rest/v2/maintenance/setdailymaintenancestarttime

{"startTime":"08:00"}

Response

Supported Media Types: application/json

Table 11-9 Parameters

Parameters	Description
`details`	In case of errors, details are published with the error string
`status`	See Migration Status Codes
`links`	Detailed information about the link
`href`	Links to API call
`action`	The HTTP call type
`rel`	Possible value: `self`
`data`	null

Example of Response Body

The following shows an example of the response body in JSON format.

{
    "details": null,
    "status": 0,
    "items": null,
    "links": [
        {
            "href": " https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/interop/rest/v2/maintenance/setdailymaintenancestarttime",
            "action": "PUT",
            "rel": "self",
            "data": null
       }]
}

Sample cURL command

curl -X PUT -s -u '<USERNAME>:<PASSWORD>' -o response.txt -D respHeader.txt -H 'Content-Type: application/json' -d '{"startTime":"08:00"}' 'https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/interop/rest/v2/maintenance/setdailymaintenancestarttime'

Common Functions