Set the Daily Maintenance Time (v1)

Use this REST API to set the time (UTC or another time zone) at which the daily maintenance of the environment starts. The maintenance of the environment need not start at the top of the hour; you can set the hour and the minute at which the maintenance should start.

This topic describes the original version of this REST API. You can also use the simplified v2 version of the REST API. The v2 version contains all parameters in the payload and does not require URL encoding while calling the REST APIs. This makes the v2 API easier to use. The v2 version is backwards compatible.

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.

Service Administrators who are currently logged in to the environment using a browser will see the new daily maintenance start time only after they sign out and then sign in

Required Roles

Service Administrator, or any application role and the Migrations - Administer granular role

REST Resource

PUT /interop/rest/v1/services/dailymaintenance?StartTime={N}

Request

Table 2-220 Parameters

Name	Description	Type	Required	Default
StartTime	Scheduled Time (in HH:MM 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:59. If the start time is not to be set in UTC, specify a valid standard time zone; for example, "14:35 America/Los_Angeles" for 2:35 pm Pacific Standard Time.	Query	Yes	None

Response

Supported Media Types: application/json

Table 2-221 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	Parameters as key value pairs passed in the request

Example of Response Body

{
  "links": [
    {
      "rel": "self",
      "href": "https://<BASE-URL>/interop/rest/v1/services/dailymaintenance?StartTime=14:20",
      "data": "null",
      "action": "PUT"
    }
  ],
  "details": "null",
  "status": "0"
}

Sample cURL command

curl -X PUT -s -u '<USERNAME>:<PASSWORD>' -o response.txt -D respHeader.txt 'https://<BASE-URL>/interop/rest/v1/services/dailymaintenance?StartTime=14:20'