testDataSourceConnection

Test to see if a data source’s connection is operational.

Note: This web services operation is different from the procedure of the same name, which is in the resource tree under /lib/resource.

Location

/services/webservices/system/admin/resource/operations/

Request Elements

path: The path to the data source to be tested.

Response Elements

status: If SUCCESS, the data source is operational and responds to the test; otherwise, the test status reports FAIL.

messages: List of entry elements describing messages that were generated during the test. See Messages Element.

Faults

IllegalArgument: If the path is malformed.

NotFound: If the data source does not exist.

Security: If the user does not have READ access on all items in path.

Security: If the user does not have the ACCESS_TOOLS right.