Edit Configuration Store

URL:
https://<root>/system/configstore/edit
Methods:
POST
Required Capability:
Access allowed only with the default administrator role
Version Introduced:
10.1

Description

The edit operation updates the configuration store. Typically, this operation is used to change the location of the store.

When ArcGIS Server is installed, the default configuration store uses local paths. As the site grows (more server machines are added), the location of the store must be updated to use a shared file system path. On the other hand, if you know at the onset that your site will have two or more server machines, you can start from a shared path while creating a site and skip this step altogether.

Request parameters

ParameterDetails

type

Type of the configuration store.

Values: FILESYSTEM

connectionString

A file path or connection URL to the physical location of the store.

Example
1
connectionString=C:\arcgis\arcgisserver\config-store

localRepositoryPath

A file path or connection URL to the physical location of the local repository for when the site is in read-only mode.

Example
1
localRepositoryPath=C:\arcgisserver\local

move

A boolean to indicate if you want to move the content of the current store to the new store. The default is true.

Values: true | false

runAsync

Decides if this operation must run asynchronously.

Values: true | false

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

The folowing is a sample POST request for the edit operation:

1
2
3
4
5
6
POST /webadaptor/admin/system/configstore/edit HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

type=FILESYSTEM&connectionString=C:\arcgis\arcgisserver\config-store&localRepositoryPath=C:\arcgisserver\local&move=true&runAsync=true&f=pjson

JSON Response example

1
{"status": "success"}

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