Is Datastore Registered

URL:: https://<root>/System/PublishingTools/GPServer/Is Datastore Registered/submitJob
Methods:: GETPOST
Version Introduced:: 11.4

Description

The Is Datastore Registered operation checks whether a specific data store has been registered with an organization. The operation either returns a list of matching data stores or, if there are no matches, an empty array for matchedDatastores. The Is Datastore Registered operation should be performed as the second step in moving a map service from one organization to another. For more information on this workflow, and supported service types, see the Export Service documentation.

Request parameters

Parameter Details

Parameter	Details
`datastore` (Required)	A JSON object containing the data store's information. The object must contain the `path`, `type`, and `info` properties. The values for these properties can be retrieved from the Data Item resource in the Server Admin API. Use dark colors for code blocksCopy `1 2 3 4 5 6 7 8 9 { "path": "/enterpriseDatabases/EGDB_shared_db", "type": "egdb", "info": { "dataStoreConnectionType": "shared", "isManaged": false, "connectionString": "<connectionString>"> } }`
`options` (Optional)	A set of additional options for the request. At this time, no options are available or supported.
`returnZ` (Optional)	A Boolean that determines if z-values are included as part of the result. If `true`, z-values will be included in the results if the features have z-values. Otherwise, z-values will not be returned. The default is `false`. Values: `true` \| `false`
`returnTrueCurves` (Optional)	A Boolean that specifies whether true curves will be returned in the output geometries (`true`). When `false`, curves will be converted to densified polylines or polygons. The default value is `false`. Values: `true` \| `false`
`simplifyFeatures` (Optional)	A Boolean that specifies whether geometries should be simplified (`true`). Simplifying can siginificantly reduce the size of the response while fulfiling the accuracy needs for most analysis, espeically for complex and large geometries. The default value is `false`. Values: `true` \| `false`
`context` (Optional)	Additional settings that affect the result of the operation: `outSR` is the spatial reference of the output geometries. `processSR` is the spatial reference that the model will use to perform geometry operations. `extent` will only process features that overlap the specified extent. The output features will have an extent that is the same or larger than the `extent` value.
`f`	The response format. The default format is `html`. Values: `html` \| `json` \| `pjson`

datastore

(Required)

A JSON object containing the data store's information. The object must contain the path, type, and info properties. The values for these properties can be retrieved from the Data Item resource in the Server Admin API.

Use dark colors for code blocksCopy
{
  "path": "/enterpriseDatabases/EGDB_shared_db",
  "type": "egdb",
  "info": {
    "dataStoreConnectionType": "shared",
    "isManaged": false,
    "connectionString": "<connectionString>">
  }
}

options

(Optional)

A set of additional options for the request. At this time, no options are available or supported.

returnZ

(Optional)

A Boolean that determines if z-values are included as part of the result. If true, z-values will be included in the results if the features have z-values. Otherwise, z-values will not be returned. The default is false.

Values: true | false

returnTrueCurves

(Optional)

A Boolean that specifies whether true curves will be returned in the output geometries (true). When false, curves will be converted to densified polylines or polygons. The default value is false.

Values: true | false

simplifyFeatures

(Optional)

A Boolean that specifies whether geometries should be simplified (true). Simplifying can siginificantly reduce the size of the response while fulfiling the accuracy needs for most analysis, espeically for complex and large geometries. The default value is false.

Values: true | false

context

(Optional)

Additional settings that affect the result of the operation:

outSR is the spatial reference of the output geometries.
processSR is the spatial reference that the model will use to perform geometry operations.
extent will only process features that overlap the specified extent. The output features will have an extent that is the same or larger than the extent value.

f

The response format. The default format is html.

Values: html | json | pjson

Example usage

The following are sample requests (GET and POST) for the Is Datastore Registered operation:

Use dark colors for code blocksCopy
https://machine.domain.com/webadaptor/rest/services/System/PublishingTools/GPServer/Is%20Datastore%20Registered/submitJob?datastore={"path": "/enterpriseDatabases/EGDB_shared_db","type": "egdb","info": {"dataStoreConnectionType": "shared","isManaged": false,"connectionString":"ENCRYPTED_PASSWORD_UTF8=00022e6855315744425a512f754e4f65334b47585574596c4a513d3d2a00ENCRYPTED_PASSWORD=00022e68494e74644572374667587a6f50612b49794b424944413d3d2a00;SERVER=antigua;INSTANCE=sde:oracle$antigua/ant11gr2;DBCLIENT=oracle;DB_CONNECTION_PROPERTIES=antigua/ant11gr2;USER=gdb;VERSION=SDE.DEFAULT;AUTHENTICATION_MODE=DBMS"}}&options=&returnZ=false&returnM=false&returnTrueCurves=false&simplifyFeatures=true&context=&f=pjson

Use dark colors for code blocksCopy
POST /webadaptor/rest/services/System/PublishingTools/GPServer/Is%20Datastore%20Registered/submitJob HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []

datastore={"path": "/enterpriseDatabases/EGDB_shared_db","type": "egdb","info": {"dataStoreConnectionType": "shared","isManaged": false,"connectionString":"ENCRYPTED_PASSWORD_UTF8=00022e6855315744425a512f754e4f65334b47585574596c4a513d3d2a00ENCRYPTED_PASSWORD=00022e68494e74644572374667587a6f50612b49794b424944413d3d2a00;SERVER=antigua;INSTANCE=sde:oracle$antigua/ant11gr2;DBCLIENT=oracle;DB_CONNECTION_PROPERTIES=antigua/ant11gr2;USER=gdb;VERSION=SDE.DEFAULT;AUTHENTICATION_MODE=DBMS"}}&options=&returnZ=false&returnM=false&returnTrueCurves=false&simplifyFeatures=true&context=&f=pjson

JSON Response example

The tabbed sections below outline the workflow to obtain the Is Datastore Registered response.

When the Is Datastore Registered job request is submitted, the following JSON response is returned:

Use dark colors for code blocksCopy
{
  "jobId": "j5f3aa768e0a24dcfbdff45f379870553",
  "jobStatus": "esriJobSubmitted"
}

The value for jobId can be appended to a modified version of the request URL (shown below) to access the job resource:

Use dark colors for code blocksCopy
https://machine.domain.com/webadaptor/rest/services/System/PublishingTools/GPServer/Is%20Datastore%20Registered/jobs/j5f3aa768e0a24dcfbdff45f379870553?f=pjson

The job resource can be polled to check the status of the Is Datastore Registered job. When the job is completed successfully, the following JSON response is returned:

Use dark colors for code blocksCopy
{
  "jobId": "j3a05c75b952546bc997af96bc01178b9",
  "jobStatus": "esriJobSucceeded",
  "results": {
    "results": {
      "paramUrl": "results/results"
    }
  },
  "inputs": {
    "datastore": {
      "paramUrl": "inputs/datastore"
    }
  },
  "messages": [
    {
      "type": "esriJobMessageTypeInformative",
      "description": "Start Time: Saturday, September 21, 2024 5:17:35 PM"
    },
    {
      "type": "esriJobMessageTypeInformative",
      "description": "Succeeded at Saturday, September 21, 2024 5:17:35 PM (Elapsed Time: 0.16 seconds)"
    }
  ]
}

The value for the results property's paramUrl can be appended to the job resource URL to access the results resource:

Use dark colors for code blocksCopy
https://machine.domain.com/webadaptor/rest/services/System/PublishingTools/GPServer/Is%20Datastore%20Registered/jobs/j0754c83d71884311a53b9d3018d40500/results/results

If there are matching data stores, the results resource returns the following JSON response:

Use dark colors for code blocksCopy
{
  "paramName": "results",
  "dataType": "GPString",
  "value": {
    "matchedDatastores": [
      {
        "id": "dc060080e87c405ab99326033f98952e",
        "path": "/enterpriseDatabases/EGDB_shared_db"
      }
    ]
  }
}

If there are no matching data stores, the results resource returns the following JSON response:

Use dark colors for code blocksCopy
{
  "paramName": "results",
  "dataType": "GPString",
  "value": {
    "matchedDatastores": []
  }
}