Skip To Content
ArcGIS Developers
Dashboard

Installed

Description

This operation returns a cumulative list of patches and releases that have been installed in your deployment. The returned list contains the following properties:

  • A newLicensesRequired binary property (true or false) specifying if the patch or release required new licenses
  • The releaseBuild number for the update
  • A description of the update that outlines the changes applied to the deployment
  • The update type (release or patch)
  • The version number the deployment will reflect if the patch or release is applied
  • A url that represents the external link pointing to the detailed information about patch. This link is not valid for release upgrade
  • The previousBuild number for the update
  • Any releaseNotes included with the update
  • The build number for the update
  • The previousVersion number that the patch or release builds on
  • The name of the patch or release
  • A containers JSON array that specifies the name, image, and checksum value of affected containers
  • A unique id associated with each patch or release
  • The date the patch or release was released, represented in milliseconds from epoch (UNIX )
Note:

When representing the current version of the deployment, the version and build numbers are combined. For example, if the version of the deployment is 10.9.0, and the build is 505, the current version is returned as 10.9.0.505. The version number will be updated with each installed release, while the build number will updated with each update (either patch or release) installed. This representation is returned through the HTML view of the API, as well as in the upgrade job messages retained by the currentVersion and upgrades resources.

Request parameters

ParameterDetails
f

The response format. The default format is html.

Values: html | json | pjson

Example usage

The following is a sample POST request for the installed operation:

POST /context/admin/system/upgrades/installed HTTP/1.1
Host: organization.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

f=pjson&token=HRozb6bnTL6gfA-SJO-IxhfLgJrioK1KJdMLWmCE5HjHWz9U3fOiFv3-HkgPZqsLljTkk2WDENGt5fjho5s39e_mZL5At60UvJPoNnC5O2sv2HTlumG7TsYfbtnokpWmS6-lf8XoQpSKusZwmxIkEMP-yE0Wxrj8o9sWKi29J-pxzkoCDhoUfdLt6NnBWxhESpegh8BzNcEruqxuDQD-JRmaTsbRDaBHTQTePMzQePhXl7KcEG9Cfkw2sa7P1W1e

JSON Response example

The response example below demonstrates a deployment that has an installed patch:

{
  "updates": [
    {
      "newLicensesRequired": false,
      "releaseBuild": "1089",
      "description": "",
      "type": "patch",
      "version": "10.9.0",
      "url": "https://support.esri.com/download/7443",
      "previousBuild": "1089",
      "releaseNotes": "",
      "build": "1090",
      "previousVersion": "10.9.0",
      "name": "Overview Patch for ArcGIS Enterprise",
      "containers": [
        {
          "image": "enterprise-admin:dev-stable-1089",
          "name": "ENTERPRISE_ADMIN_API",
          "checksum": "d8203f62486387d4abeb2b32ab59e2541e79bd4b8cbaee2366219bacd2f207cb"
        },
        {
          "image": "help:dev-stable-1089",
          "name": "HELP",
          "checksum": "d8203f62486387d4abeb2b32ab59e2541e79bd4b8cbaee2366219bacd2f207cb"
        },
        {
          "image": "enterprise-admin-tools:dev-stable-1089",
          "name": "ADMIN_TOOLS",
          "checksum": "d8203f62486387d4abeb2b32ab59e2541e79bd4b8cbaee2366219bacd2f207cb"
        },
        {
          "image": "arcgis-nginx-web:dev-stable-1089",
          "name": "WEB_PROXY",
          "checksum": "d8203f62486387d4abeb2b32ab59e2541e79bd4b8cbaee2366219bacd2f207cb"
        }
      ],
      "id": "pat_345432_1090",
      "released": 1618540600000
    }
  ]
}

The following response demonstrates a deployment that has no installed patch or release:

{"updates": []}