- URL:
- https://<root>/system/upgrades/rollback
- Methods:
POST- Version Introduced:
- 10.9
Access requirements
Required privileges
The Enterprise Administrator API requires privilege-based access. An administrator must be assigned a specific user privilege, or role, to access any given endpoint. Listed below are the user privileges or roles an administrator can be assigned that provides access to this endpoint. If multiple privileges are listed, only one needs to be assigned to gain access.
Tokens
This API requires token-based authentication. A token is automatically generated for administrators who sign in to the Enterprise Administrator API directory's HTML interface. Tokens generated in this way are stored for the entirety of the session.
Those accessing the API directory outside of the HTML interface will need to acquire a session token from the generate operation in the Enterprise Directory API. For security reasons, all POST requests made to the Enterprise Administrator API must include a token in the request body.
Description
The rollback operation uninstalls a patch, removing the updates and fixes that had been applied to specific containers, and restoring the deployment to a previous, user-specified version of the software. The rollback operation cannot be performed for release-based updates.
The organization will be placed into read-only mode while a rollback is occurring.
Request parameters
| Parameter | Details |
|---|---|
(Required) | The version of the deployment the operation will roll back toward. This value can be retrieved from the Check Rollback operation. Example |
(Optional) | A JSON object containing patch settings. At 10.9, the object is empty and doesn't support any values. |
| The response format. The default format is Values: |
Example usage
The following is a sample POST request for the rollback operation:
POST /<context>/admin/system/upgrades/rollback HTTP/1.1
Host: organization.example.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
versionManifest={"id": "pat_345432_505"}&rollbackSettings={}&f=pjson&token=ugW_uEP1WiJV7PkHhb2BU-f1C30eAZclpgOKE599aSIFxwYBNRc8O7h6sjjgzC3l3NxhPjpa-6zgeun7rB6xCizGstMk9ZcTgLeOc67dWbTsrn7A7_VzvfpC2cV2Ig77h6w0_mvhbaMTmpnzOek7tY85PguVExKeM-ODE5L2NTX2z9LM5URYviKA4nJu7Oyg3xBKwZzxXnhPUxpiCxUy5rZ_C9QRS6kNnZjNcvhAp6Dw2FE6hL6wnLIjk3H9IjvYJSON Response example
The following example demonstrates the immediate JSON response returned by a successful rollback request. Detailed, real-time job information is returned on the upgrades resource while the patch is being uninstalled.
{
"status": {
"state": "in_progress",
"code": 1,
"messages": [
{
"message": "Starting the rollback process from 10.9.0.506 to 10.9.0.505.",
"when": 1602276011623,
"code": 2072
}
]
}
}Once the rollback process is complete, the JSON view of the upgrades resource will return the full job messages of the job and success status. Abbreviated information is denoted by ...:
{
"status": {
"code": 3,
"messages": [
{
"code": 2072,
"message": "Starting the rollback process from 10.9.0.1090 to 10.9.0.1089.",
"when": 1618599881971
},
{
"code": 2168,
"message": "Launching upgrader... ",
"when": 1618599882141
},
{
"code": 2165,
"message": "System is going into Read-Only mode.",
"when": 1618599893065
},
{
"code": 2270,
"message": "Preparing an upgrade plan.",
"when": 1618599954127
},
{
"code": 2287,
"message": "Pre-diagnostics started.",
"when": 1618599954626
},
{
"code": 2288,
"message": "Pre-diagnostics completed.",
"when": 1618599954696
},
{
"code": 2271,
"message": "Executing upgrade plan.",
"when": 1618599954714
},
{
"code": 2293,
"message": "Rollback of apps module started.",
"when": 1618599954726
},
{
"code": 2177,
"message": "The rolling back of apps has completed in 31520 millis (~ 0 minutes).",
"when": 1618599986262
},
{
"code": 2293,
"message": "Rollback of monitoring components module started.",
"when": 1618599986283
},
{
"code": 2177,
"message": "The rolling back of monitoring components has completed in 35655 millis (~ 0 minutes).",
"when": 1618600021938
},
{
"code": 2293,
"message": "Rollback of main core rest APIs module started.",
"when": 1618600021963
},
{
"code": 2177,
"message": "The rolling back of main core rest APIs has completed in 216945 millis (~ 3 minutes).",
"when": 1618600238908
},
{
"code": 2166,
"message": "System is coming out of Read-Only mode.",
"when": 1618600238938
},
{
"code": 2179,
"message": "Post-upgrade operations started.",
"when": 1618600298984
},
{
"code": 2183,
"message": "Post-upgrade operations completed.",
"when": 1618600299001
},
{
"code": 2263,
"message": "Persisting rollback state to database.",
"when": 1618600299001
},
{
"code": 2077,
"message": "The rollback process from 10.9.0.1090 to 10.9.0.1089 has completed in 00hr:06min:45sec:968millisec.",
"when": 1618600299019
},
{
"code": 2076,
"message": "The ArcGIS Enterprise on Kubernetes has been rolled-back from 10.9.0.1090 to 10.9.0.1089 successfully.",
"when": 1618600299019
}
],
"state": "success"
}
}