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

View Applied Patches

get

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

Returns a list of all applied patches 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
Query Parameters
  • String used to filter the results. Valid operatives include:
    • =
    • !=
    • >=
    • <=

    For example, to filter the results on a specific patch category and type, set the filter as follows: patchCategory=general,patchType!=security. This value defaults to null.

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-patches-response
Type: array
The response body includes details of all applied patches.
Show Source
Nested 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 applied patches 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

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:07:21 GMT

Example of Response Body

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

[
    {
        "backupStatus": "SameVersion",
        "rollbackStatus": "SameVersion",
        "additionalNote": "Rolling back patch wls_patch_12.2.1.2.2_180227",
        "appliedBy": "username",
        "appliedDate": "2018-04-25T16:37:04.910+0000",
        "totalTime": "13 min, 20 sec",
        "patchId": "wls_patch_12.2.1.2.2_180227",
        "patchDescription": "WLS PIPELINE UPDATE 12.2.1.2.2",
        "patchReleaseUrl": "https://support.oracle.com/epmos/faces/PatchDetail?patchId=26860993",
        "releaseDate": "2018-02-27T01:40:00.000+0000",
        "lastStatus": "COMPLETED_ROLLBACK",
        "lastStatusMessage": "No errors",
        "componentPatches": {
            "OTD": {
                "id": 15701,
                "version": "12.2.1.2.4",
                "releaseVersion": "12.2.1.2.180116",
                "zipBundles": {
                    "OTD_JDK": {
                        "id": 51421,
                        "md5sum": "51c0768028b642cf3a37bfdb72550c3a",
                        "storageKey": "jcs/JDK/8.0.161/180116/jdk.zip",
                        "zipVersion": "1.8.0_161",
                        "releaseDate": "2018-01-16",
                        "releaseUrl": "http://www.oracle.com/technetwork/java/javase/8all-relnotes-2226344.html#R180_161",
                        "displayName": "OTD JDK"
                    }
                },
                "preserveFiles": []
            },
            "WLS": {
                "id": 15702,
                "version": "12.2.1.2.9",
                "releaseVersion": "12.2.1.2.180227",
                "expectedAppliedPatches": "opatch:26910516,19795066,19154304,21663638,22754279,19030178,19632480,18459080,18905788,19002423",
                "zipBundles": {
                    "JDK": {
                        "id": 51422,
                        "md5sum": "51c0768028b642cf3a37bfdb72550c3a",
                        "storageKey": "jcs/JDK/8.0.161/180116/jdk.zip",
                        "zipVersion": "1.8.0_161",
                        "releaseDate": "2018-01-16",
                        "releaseUrl": "http://www.oracle.com/technetwork/java/javase/8all-relnotes-2226344.html#R180_161",
                        "displayName": "JDK"
                    },
                    "WLS": {
                        "id": 51423,
                        "md5sum": "0ce1fcf6dcd8abfec2cdeb843aa5bf96",
                        "storageKey": "jcs/FMW/12.2.1.2.2/180227/fmiddleware.zip",
                        "releaseDate": "2018-02-27",
                        "releaseUrl": "https://support.oracle.com/epmos/faces/PatchDetail?patchId=26860993",
                        "displayName": "Middleware"
                    }
                },
                "preserveFiles": []
            }
        },
        "patchType": "PSU",
        "patchCategory": "PATCH",
        "patchSeverity": "Normal",
        "jobId": "25321289",
        "displayName": "12.2.1.2.180227",
        "backupId": "e2618d09-ea9f-49b2-95f7-0fc2d1aba9ae",
        "inProgress": false,
        "operationType": "None",
        "id": 719063,
        "patchingResult": {
            "patchingId": 622928,
            "backupId": "e2618d09-ea9f-49b2-95f7-0fc2d1aba9ae",
            "versionBeforeThisPatch": "OTD 12.2.1.2.180116,WLS 12.2.1.2.180120,SERVICEVERSION 12cRelease212",
            "strategy": "Rolling",
            "releaseVersionBeforeThisPatch": "12.2.1.2.180120",
            "customRollbackId": "25217695_1524520377611",
            "startDate": "2018-04-23T21:52:57.611+0000",
            "endDate": "2018-04-23T22:06:44.006+0000",
            "patchingStatus": "COMPLETED",
            "resultMessage": "No errors",
            "additionalNote": "Applying the patch wls_patch_12.2.1.2.2_180227",
            "appliedBy": "username",
            "jobId": "25217695",
            "completeLog": "",
            "progressMessages": [
                "9:52:57.573 PM Phase initialize started",
                "9:52:57.699 PM Phase initialize completed",
                "9:52:57.920 PM patching.action.tools.phase_started",
                "9:53:07.982 PM patching.action.tools.phase_completed",
                "9:53:08.231 PM Phase backup started",
                "9:55:14.958 PM Phase backup completed",
                "9:55:15.185 PM patching.action.patch-pre-action.phase_started",
                "9:55:15.381 PM patching.action.patch-pre-action.phase_completed",
                "9:55:15.597 PM Phase patch started",
				...
                "10:06:37.495 PM Phase patch completed",
                "10:06:37.742 PM patching.action.patch-post-action.phase_started",
                "10:06:37.927 PM patching.action.patch-post-action.phase_completed",
                "10:06:38.717 PM patching.action.patch-cleanup.phase_started",
                "10:06:39.574 PM PSM-PATCH-60099: Removing any retained old artifacts",
                "10:06:40.294 PM patching.progress.remove.left.over.binary.completed$jcs/FMW/12.2.1.2.2/180227/fmiddleware.zip$exampleinstance-wls-1",
                "10:06:40.294 PM PSM-PATCH-60099: Removing any retained old artifacts",
                "10:06:40.483 PM patching.progress.remove.left.over.binary.completed$jcs/JDK/8.0.161/180116/jdk.zip$exampleinstance-wls-1",
                "10:06:43.488 PM patching.action.patch-cleanup.phase_completed",
                "10:06:43.779 PM Phase finalize started",
                "10:06:43.900 PM Completed"
            ]
        },
        "rollbackResult": {
            "rollbackId": 3201,
            "startDate": "2018-04-25T16:37:04.910+0000",
            "endDate": "2018-04-25T16:50:25.485+0000",
            "patchingStatus": "COMPLETED_ROLLBACK",
            "resultMessage": "No errors",
            "additionalNote": "Rolling back patch wls_patch_12.2.1.2.2_180227",
            "appliedBy": "username",
            "jobId": "25321289",
            "completeLog": "",
            "progressMessages": [
                "4:37:04.905 PM Phase initialize started",
                "4:37:05.000 PM Phase initialize completed",
                "4:37:05.233 PM patching.action.tools.phase_started",
                "4:37:15.185 PM patching.action.tools.phase_completed",
                "4:37:15.483 PM patching.action.rollback-pre-action.phase_started",
                "4:37:15.630 PM patching.action.rollback-pre-action.phase_completed",
                "4:37:15.825 PM Phase rollback started",
				...
                "4:50:14.776 PM Phase rollback completed",
                "4:50:15.040 PM patching.action.rollback-post-action.phase_started",
                "4:50:15.240 PM patching.action.rollback-post-action.phase_completed",
                "4:50:16.055 PM patching.action.rollback-cleanup.phase_started",
                "4:50:17.059 PM PSM-PATCH-60099: Removing any retained old artifacts",
                "4:50:17.511 PM patching.progress.remove.left.over.binary.completed$jcs/FMW/12.2.1.2.2/180119/fmiddleware.zip$exampleinstance-wls-1",
                "4:50:17.511 PM PSM-PATCH-60099: Removing any retained old artifacts",
                "4:50:17.650 PM patching.progress.remove.left.over.binary.completed$jcs/JDK/8.0.161/180116/jdk.zip$exampleinstance-wls-1",
                "4:50:24.958 PM patching.action.rollback-cleanup.phase_completed",
                "4:50:25.211 PM Phase finalize started",
                "4:50:25.317 PM Completed"
            ]
        },
        "rollbackId": "719063",
        "rollbackVersion": "12.2.1.2.180120",
        "currentPatchLevel": "12.2.1.2.180120",
        "isUpgrade": false,
        "appliedPatchGuiMetadata": {
            "supportsPreRollbackCheck": true
        }
    }
]

Note that rollbackResult is displayed only if an applied patch has been rolled back.

Back to Top