Update Datastore Configuration

URL:
https://<root>/data/config/update
Methods:
POST
Required Capability:
Access allowed with either the "Update", "Delete", "Security and Infrastructure", or "Servers" privileges
Version Introduced:
10.1.1

Description

The update operation allows you to update the data store configuration. You can use this to allow or block the automatic copying of data to the server at publish time. This operation overwrites all existing configuraitons.

Request parameters

ParameterDetails

datastoreConfig

The JSON object containing the data configuration. For more information, see the configuration properties table below.

Example
1
datastoreConfig={"blockDataCopy": true}

f

The response format. The default response format is html.

Values: html | json | pjson

Configuration properties

ParameterDetails

blockDataCopy

A Boolean property. When this property is set to false, or not set at all, copying data to the site when publishing services from a client application is allowed. This is the default behavior. When this property is true, the client application is not allowed to copy data to the site when publishing. Rather, the publisher is required to register data items through which the service being published can reference data.

When this property is set to true, users will not be able to publish geoprocessing and geocoding services from composite locators, as these services require data to be copied to the server. As a workaround, you can temporarily set the blockDataCopy to false, publish the service, and then set the property back to true once the service has been published.

Values: true | false

Example usage

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

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

datastoreConfig={"blockDataCopy": 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