Perform a Patching Precheck



Performs a precheck to identify potential issues that might prevent the specified patch from completing successfully without actually patching the service instance. Specifically, the patching precheck reports on the following conditions:
  • Disk space shortage
  • Database connectivity failure
  • Server access failure
  • Storage access failure

Prechecks do not check whether another administration task (such as backup, restoration, or scaling) is in progress, which would prevent patching.

Note: Patching is not supported for Oracle Java Cloud Service instances if you have installed any product that modifies MW_HOME (such as Oracle WebCenter Portal and Oracle Data Integrator). Patching is also not supported if you are reusing a license via the Bring Your Own License (BYOL) entitlement (for any product that modifies MW_HOME). Because patching replaces the contents of MW_HOME, patching prechecks flag this condition and patching fails.


Supported Media Types
Path Parameters
Header Parameters
Body ()
The request contains information about the patch precheck operation.
Root Schema : precheck-request
The request consumes an application/json payload. No parameters are supported in the payload at this time.
Back to Top


Supported Media Types

202 Response

Accepted. See Status Codes for information about other possible HTTP status codes.
  • A REST URI you can use to check the progress and completion of the precheck operation.
Body ()
Root Schema : patch-response
Type: object
The response body includes information about the operation.
Show Source
Nested Schema : details
Type: object
Groups the details of the operation.
Show Source
Back to Top


The following example shows how to perform a patch precheck by submitting a PUT request on the REST resource using cURL.

Note: The command in this example uses the URL structure https://rest_server_url/resource-path, where rest_server_url is the REST server to contact for your identity domain (or Cloud Account). See Send Requests.

cURL Command and Request Body

curl -i -X PUT -u username:password -d @emptyfile.json -H "Content-Type:application/json" -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/patches/checks/Patch_jdk1.7.0_95

No parameters are supported in the request payload at this time.

Example of Response Header

The following shows an example of the response header.

The Location header returns the REST resource that can be used to access the status of the patch precheck operation. See View the Status of a Patching Precheck Operation.

HTTP/1.0 200 Connection established

HTTP/1.1 202 Accepted
Location: https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/JaaS/instances/ExampleInstance/patches/checks/job/5409198
Content-Language: en
Content-Type: application/json
Date: Thu, 11 May 2017 16:59:21 GMT

Example of Response Body

The following are examples of the response body in JSON format.

       "message":"PATCHING-5227: Pre-Checking service for patch [wls_patch_12.]
is submitted as an asynchronous job.",
Back to Top