1. REST API for Oracle Java Cloud Service
  2. Tasks
  3. Patches

View a Patch Operation

get

/paas/api/v1.1/instancemgmt/{identityDomainId}/services/jaas/instances/{serviceId}/patches/applied/{id}

Returns information about the specified patching operation for an Oracle Java Cloud Service instance.

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.

Request

Path Parameters
Header Parameters
Back to Top

Response

Supported Media Types

200 Response

OK. See Status Codes for information about other possible HTTP status codes.
Body ()
Root Schema : applied-patch
Type: object
Each object is a patch that has been applied.
Show Source
Nested Schema : appliedPatchGuiMetadata
Type: object
Instruction to the metadata UI about the patch.
Show Source
Nested Schema : componentPatches
Type: object
A map that groups details of one or more components in the patch. A component could be WLS, OTD, JDK, OTD_JDK, or ORACLE_TOOLS.
Show Source
Nested Schema : patching-result
Type: object
Groups information about the results of the patch.
Show Source
Nested Schema : rollback-result
Type: object
Groups information about the results of the rollback operation. This attribute displays only when a rollback of the patch had been performed.
Show Source
Nested Schema : componentname
Type: object
This attribute is the actual component name for the target service type. For example, an Oracle Java Cloud Service component name could be WLS. Each object is one component.
Show Source
Nested Schema : zipBundles
Type: object
Zips that contain the artifacts (for example, patched binaries or patches for the service volumes).
Show Source
Nested Schema : artifactname
Type: object
This attribute is the actual artifact name for the target service type, component, and component version (for example, JDK or WLS). Each object is one artifact.
Show Source
Nested Schema : progressMessages
Type: array
List of progress messages for the patch.
Show Source
Nested Schema : progressMessages
Type: array
List of progress messages for the rollback.
Show Source
Back to Top

Examples

The following example shows how to view a patch operation for an Oracle Java Cloud Service instance by submitting a GET 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

curl -i -X GET -u username:password -H "X-ID-TENANT-NAME:ExampleIdentityDomain" https://rest_server_url/paas/api/v1.1/instancemgmt/ExampleIdentityDomain/services/jaas/instances/ExampleInstance/patches/applied/98702

Example of Response Header

The following shows an example of the response header:

HTTP/1.0 200 Connection established

HTTP/1.1 200 OK
Content-Type: application/json
Date: Mon, 10 Apr 2017 22:06:19 GMT

Example of Response Body

The following shows an example of the response body in JSON format for a patch operation that has completed.

[
  {
    "backupStatus":"Available",
    "additionalNote":"Applying PSU patch",
    "appliedBy":"username",
    "appliedDate":"2017-04-10T21:20:58.452+0000",
    "totalTime":"41 min, 8 sec",
    "patchId":"wls_patch_12.2.1.2.0_170308",
    "patchDescription":"WLS PATCH SET UPDATE 12.2.1.2.0 ,IDCS PATCH 24963946,DATAGUARD PATCH 25368371,\u0026 ADF PATCH",
    "patchReleaseUrl":"https://docs.oracle.com/middleware/12212/wls/WLSRN/issues.htm#WLSRN001",
    "releaseDate":"2017-02-11T01:40:00.000+0000",
    "lastStatus":"COMPLETED",
    "lastStatusMessage":"Completed",
    "componentPatches":
    {
      "WLS":
      {
        "id":1803,
        "version":"12.2.1.2.0",
        "releaseVersion":"12.2.1.2.170224",
        "expectedAppliedPatches":"opatch:23762529,25218838,25368371,23101385,25164167,24738691,24849618,24963946,19795066,19154304,18905788,19632480,19030178,22754279,19002423,21663638",
        "zipBundles":
        {
          "WLS":
          {
            "id":3816,
            "md5sum":"8a8b1c9aea8cc8e9b89cb6fd2c246562",
            "storageKey":"FMW/12.2.1.2.0/170208/fmiddleware.zip"
          }
        },
        "preserveFiles":[]
      },
      "OTD_JDK":
      {
        "id":1801,
        "version":"1.8.0_121",
        "releaseVersion":"1.8.0_121",
        "zipBundles":
        {
          "OTD_JDK":
          {
            "id":3814,
            "md5sum":"72200f4ebaa0a025b32736e36c7074c9",
            "storageKey":"JDK/8.0.121/170117/jdk.zip"
          }
        },
        "preserveFiles":[]
      },
      "JDK":
      {
        "id":1802,
        "version":"1.8.0_121",
        "releaseVersion":"1.8.0_121",
        "zipBundles":
        {
          "JDK":
          {
            "id":3815,
            "md5sum":"72200f4ebaa0a025b32736e36c7074c9",
            "storageKey":"JDK/8.0.121/170117/jdk.zip"
          }
        },
        "preserveFiles":[]
      }
    },
    "patchType":"PSU",
    "patchCategory":"General",
    "patchSeverity":"Normal",
    "jobId":"4953052",
    "displayName":"12.2.1.2.170224",
    "backupId":"1491860000003",
    "inProgress":false,
    "operationType":"None",
    "id":98702,
    "patchingResult":
    {
      "patchingId":71752,
      "backupId":"1491860000003",
      "versionBeforeThisPatch":"WLS 12.2.1.2.0,OTD_JDK 1.8.0_112,JDK 1.8.0_112",
      "strategy":"Rolling",
      "releaseVersionBeforeThisPatch":"12.2.1.2.0",
      "customRollbackId":"4953052_1491859258452",
      "startDate":"2017-04-10T21:20:58.452+0000",
      "endDate":"2017-04-10T22:02:06.928+0000",
      "patchingStatus":"COMPLETED",
      "resultMessage":"Completed",
      "additionalNote":"Applying PSU patch",
      "appliedBy":"username",
      "jobId":"4953052",
      "completeLog":"",
      "progressMessages":
      [
        "9:20:58.409 PM Phase initialize started",
        "9:20:58.519 PM Phase initialize completed",
        "9:20:58.594 PM Phase pre-check started",
        "9:20:58.698 PM Phase pre-check-rex started",
        ...
        "10:02:06.000 PM Phase patch-rex completed",
        "10:02:06.552 PM Phase patch completed",
        "10:02:06.710 PM Phase finalize started",
        "10:02:06.788 PM Completed"
      ]
    },
    "rollbackId":"98702",
    "rollbackVersion":"12.2.1.2.0",
    "currentPatchLevel":"12.2.1.2.170224"
  }
]

When an applied patch has been rolled back, rollbackResult is also displayed: 

    "rollbackResult":
    {
        "rollbackId":151,
        "startDate":"Jun 3, 2016 4:32:59 PM",
        "endDate":"Jun 3, 2016 4:46:17 PM",
        "patchingStatus":"COMPLETED_ROLLBACK",
        "resultMessage":"Completed",
        "additionalNote":"Rolling back the WLS patch",
        "appliedBy":"username",
        "jobId":"4538993",
        "completeLog":"",
        "progressMessages":
        [
            "4:32:59.860 PM Phase initialize started",
            "4:32:59.895 PM Phase initialize completed",
            "4:32:59.936 PM Phase restore started",
            "4:46:17.548 PM Phase restore completed",
            "4:46:17.578 PM Phase finalize started",
            "4:46:17.596 PM Completed"
        ]
    }
Back to Top