- URL:https://<data-url>/validateDataItem(POST only)
- Required Capability:Default administrator role | All authorized privileges
- Version Introduced:10.1
Description
This operation validates that the path (for file shares) or connection string (for databases) for a specific data item is accessible to every server node in the site by checking against the JSON representing the data item, ensuring that the data item can be registered and used successfully within the server's data store.
Validating a data item does not automatically register it for you. You need to explicitly register your data item by invoking the Register Data Item operation.
Request parameters
Parameter | Details |
---|---|
item | The JSON representing the data item. |
f | The response format. The default response format is html. Values: html | json| pjson |
Example usage
Below is a sample POST request for validateDataItem, formatted for readability:
POST /webadaptor/admin/data/validateDataItem HTTP/1.1
Host: machine.domain.com
Content-Type: application/x-www-form-urlencoded
Content-Length: []
item={
"path": "/fileShares/folder_shared",
"type": "folder",
"id": null,
"clientPath": null,
"info": {
"path": "\\\\server\\share_data\\map_data",
"dataStoreConnectionType": "shared"
}
}&f=json
JSON Response example
{"status": "success"}