psm jcs patch

Syntax

In the following syntax, line breaks have been added for clarity. Do not include them when entering the command.

psm jcs patch -s|--service-name serviceName 
  -p|--patch-id patchId
      [-a|--additional-note text ]
      [-of|--output-format json|html|short]
      [-wc|--wait-until-complete true|false]

Parameters

All parameters are required unless otherwise noted.

Parameter	Description
`-s\|--service-name serviceName`	Name of the Oracle Java Cloud Service instance.
`-p\|--patch—id patchId`	String that identifies the patch. To retrieve the patch ID, use the `available-patches`command.
`-a\|--additional-note free form text`	(Optional) Free-form text to provide additional information about the patch.
`-of\|--output-format json\|html\|short`	(Optional) Output format of the command’s response: Accepted values: `json, html, short` The default output format is the one you specified when using the `psm setup` command to configure the psm CLI.
`-wc\|--wait-until-complete true\|false`	(Optional) A boolean value that, when set to `true`, makes the command behave synchronously; that is, it does not return until the submitted job is complete. The following message is displayed until the job is complete: `Waiting for the job to complete... (it cannot be cancelled)` Default: `false`

Example

$ psm jcs patch -s Example1Instance -p Test_Patch_12.2.1.0.160119 
{
    "details":{
        "jobId":"34184",
        "message":"JCS-PATCHING-5068: Patching service with patch [Test_Patch_12.2.1.0.160119] is submitted as an asynchronous job."
    },
    "status":"Completed"
}
Job ID : 34184

Note that this command returned a job ID. To see the status of your patch operation, use this ID with the psm jcs operation-status command:

$ psm jcs operation-status -j 34184 -of json

When you see the message:

 "operationId":364,
 "operationType":"PATCH",
 "serviceId":364,
 "serviceName":"Example1Instance",
 "serviceType":"jaas",
 "startDate":"2016-04-28T17:39:41.618+0000",
 "status":"SUCCEED",
 "summaryMessage":"PATCH"

the service was successfully patched.