Jump to

• Request
• Response
• Examples

Rollback a Patch

put

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

Rolls back a patch for an Oracle Java Cloud Service instance.

(Not available on Oracle Cloud at Customer) Rollback a WebLogic Server software version upgrade patch: Rolling back a WebLogic Server version upgrade is a combination of procedures you perform manually. As part of rolling back a version upgrade, use this endpoint to restore the WebLogic Server software version information (that is stored in Oracle Java Cloud Service) to the original version number prior to the upgrade. See Roll Back an Upgrade in the chapter Upgrade the WebLogic Server Version for an Oracle Java Cloud Service Instance in Administering Oracle Java Cloud Service.

Request

Supported Media Types

• application/json

Path Parameters

• identityDomainId: string
  Identity domain ID for the Oracle Java Cloud Service account.
• rollbackId: string
  ID of the rollback that is associated to the completed patching operation.

  To retrieve the rollback ID, get the list of applied patches. See View Applied Patches.

• serviceId: string
  Name of the Oracle Java Cloud Service instance.

Header Parameters

• Authorization: string
  Base64 encoded user name and password separated by a colon or OAuth access token obtained from Oracle Identity Cloud Service. See Authenticate.
• X-ID-TENANT-NAME: string
  Identity domain ID for the Oracle Java Cloud Service account.

Body ()

The request can contain a note about the rollback operation.

Root Schema : rollback-request

Type: object

Show Source

• additionalNote(optional): string
  Free-form text to provide additional information about the rollback request.

{
    "properties":{
        "additionalNote":{
            "type":"string",
            "description":"Free-form text to provide additional information about the rollback request."
        }
    }
}

Back to Top

Response

Supported Media Types

• application/json

202 Response

Accepted. See Status Codes for information about other possible HTTP status codes.

Body ()

Root Schema : rollback-response

Type: object

The response body includes information about the rollback operation.

Show Source

• details(optional): object details
  Groups the details of the rollback operation.
• status(optional): string
  Status of the operation. When first initiated, the status is set to New. The status may transition to one of the following values: Completed and Cannot Complete.

{
    "description":"The response body includes information about the rollback operation.",
    "properties":{
        "details":{
            "type":"object",
            "description":"Groups the details of the rollback operation.",
            "properties":{
                "jobId":{
                    "type":"string",
                    "description":"Job ID for the rollback operation. You can use the ID to review the status of the rollback operation."
                },
                "message":{
                    "type":"string",
                    "description":"System message that describes the operation."
                }
            }
        },
        "status":{
            "type":"string",
            "description":"Status of the operation. When first initiated, the status is set to <code>New</code>. The status may transition to one of the following values: <code>Completed</code> and <code>Cannot Complete</code>."
        }
    }
}

Nested Schema : details

Type: object

Groups the details of the rollback operation.

Show Source

• jobId(optional): string
  Job ID for the rollback operation. You can use the ID to review the status of the rollback operation.
• message(optional): string
  System message that describes the operation.

{
    "type":"object",
    "description":"Groups the details of the rollback operation.",
    "properties":{
        "jobId":{
            "type":"string",
            "description":"Job ID for the rollback operation. You can use the ID to review the status of the rollback operation."
        },
        "message":{
            "type":"string",
            "description":"System message that describes the operation."
        }
    }
}

Back to Top

Examples

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

curl -i -X PUT -u username:password -d @rollback.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/88992/rollback

Example of Request Body

The following shows an example of the request body.

{
   "additionalNote": "Rolling back the JDK patch."
}

Example of Response Body

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

{
   "details":
   {
      "jobId":"6553026",
      "message":"JCS-PATCHING-038: Rollback of service from patch [otd_jdk1.7.0_95] is submitted as an asynchronous job."
   },
   "status":"Completed"
}

{
   "status":"Completed",
   "details":{
      "message":"PSM-PATCH-50038:  Rollback of service from patch [wls_upg_12.2.1.3.190115_for_12cRelease212] is submitted as an  asynchronous job.",
      "jobId":"206236"
   }
}

Back to Top