Skip To Content
ArcGIS Developer
Dashboard

Register Item (Data Stores)

Description

This operation registers a new data item (for example, geodatabases, cloud shares, and file shares) with a data store. Before registering the data item, you must validate it and make sure that it is accessible.

Caution:

If you are registering a folder that uses a new path, it will require several of your system and utility services to restart. To avoid disruption, consider registering this folder during off-peak hours. Additionally, data store items can be registered while configuring your organization.

Request parameters

ParameterDetails
item

The JSON representation of the data item.

With ArcGIS Enterprise on Kubernetes 10.9.1, you must provide the File Server Host name and path on the file server as part of registering new folder paths in your deployment. This workflow is recommended for registering any new folder paths.

To register these folder paths, the following user-defined information must be provided:

  • clientPath—Either a drive or shared location where source data can be accessed and published by clients, such as ArcGIS Pro. If the clientPath uses a drive location, an additional property (hostName) will need to be included as well.
  • fileServerHost—The machine name where shared data is stored and can be accessed through a NFS path.
  • filerServerPath—A NFS path on the host machine where shared data can be accessed across the organization.

Example

//Shared location
item={
  "clientPath": "\\\\sample_server\\SharedPath\Data",
  "type": "folder",
  "info": {
    "fileServerHost": "nfsHost.domain.com",
    "fileServerType": "nfs",
    "fileServerPath": "/SharedPath/Data"
  }
}

//Drive location
item={
  "clientPath": "C:\\data",
  "type": "folder",
  "info": {
    "fileServerHost": "nfsHost.domain.com",
    "fileServerType": "nfs",
    "fileServerPath": "/data",
    "hostName": "youclienthost.domain.com"
  }
}
async

(Optional)

Introduced at 10.9.1. This parameter specifies whether the operation will run synchronously or asynchronously. If false, the operation is run synchronously. If true, the operation is run asynchronously and the response returns a JSON object containing job information that can be used to track the job's status. The default value is false.

Values: true | false

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

The following is a sample POST request for the registerItem operation, formatted for readability:

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

item={
  "clientPath": "\\\\sample_server\\SharedPath\Data",
  "type": "folder",
  "info": {
    "fileServerHost": "nfsHost.domain.com",
    "fileServerType": "nfs",
    "fileServerPath": "/SharedPath/Data"
  }
}&f=pjson&token=uH1XErH8KruWpIAJId4WJ1tfR0xuolWt4bz5S58vYqk5qpbDhGnpbbysmiVDyqDf70tr6i0n4qYCql7eZa_PiKgnA2-1ccEB2O4rkymYoc0-R4WnYrO_t_7Rm9qKzVLN7oFDmJpqmCt55mKz3WyQkumnK2MmBYmgYmU2DycSPyKL4BJx0gr1UHmfqeWA7I52zBsgV8FiND6e_AhjzktIwF8iifMg96Hm0KAGztgsdSDQF0tvLj7doyxTQFWuGRik

JSON Response examples

If async is false, the following response is returned:

{"status": "success"}

If async is true, the following response is returned. The value returned for jobsUrl can be used to access the job resource to track a job's status after it's been submitted. For more information, see the Job resource topic.

{
  "jobsUrl": "https://organization.domain.com/context/admin/jobs/ja2ca1a35-881c-400c-a49a-b26883002d6c",
  "jobID": "ja2ca1a35-881c-400c-a49a-b26883002d6c",
  "jobStatus": "SUBMITTED"
}