/downloadAndInstallUpdates: Download and Install Package

URL:
https://[root]/portals/[portalID]/livingatlascatalog/downloadAndInstallUpdates
Methods:
POST
Required Capability:
Administrator
Version Introduced:
11.3

Example usage

The following is a sample ArcGIS Enterprise POST request for the downloadAndInstallUpdates operation:

1
2
3
4
5
6
POST /webadaptor/sharing/rest/portals/0123456789SBCEDF/livingatlascatalog/downloadAndInstallUpdates
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

packageId=&startTime=1712172786601&async=true&f=pjson

Description

The downloadAndInstallUpdates operation schedules, or immediately starts, a job to update an organization's ArcGIS Living Atlas content. When the update begins, the available content package is downloaded and installed.

If you choose to schedule an update, it's important to note that only one update can be scheduled at a time. If a new scheduled update is made using this operation while one already exists, the original scheduled job will be repalced with the new one. If a new scheduled job does need to be made, use the Cancel Scheduled Download and Install Package operation to cancel the original job before using the downloadAndInstallUpdates operation to schedule a new one.

If you choose to start the content update immediately, you can use the jobId returned as part of the response for this operation to check the status of the installation by making a request of the following form:

1
https://machine.domain.com/webadaptor/sharing/rest/portals/<portalID>/jobs/<jobId>

Request parameters

ParameterDetails

packageId

(Optional)

Specifies a specific ID of an avaiable ArcGIS Living Atlas content package. This value can be retrieved from either the Export Package Directory or Check for Updates resources. If a value is not provided for this parameter, the update will use the first available package on the server that's hosting the ArcGIS Living Atlas content packages.

Example

1
packageId=1897ca6b39284c4db098f439da5a92e0

startTime

(Optional)

Schedules a time (in Unix format) for the download and installation of the new content package to occur. If no value is provided for this parameter, the update will begin immediately after the request is submitted.

Example

1
startTime=1712172786601

async

(Optional)

Determines if the job will be performed asynchronously. The default value is true.

Values: true | false

f

The response format. The default format is html.

Values: html | json | pjson

JSON Response example

The following response is returned when a value for startTime has been provided:

1
2
3
4
5
6
7
{
  "scheduleId": "3f0790c95488464d8d5ebcc36630447d",
  "startTime": 1705050000000,
  "packageId": "3dd3ed5e-ef71-4b90-aaf4-a689a834e596",
  "success": true,
  "status": "scheduled"
}

The following response is returned when a value for startTime is not provided:

1
2
3
4
5
6
{

  "jobId": "077cb3784bc74c95be25c9df545af3de",
  "success": true,
  "status": "submitted"
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close