Run a read-only datasource operation

GET 
/datasources/:datasource_id/operations

Dispatches on the action query parameter. Caller needs at least read/view on the datasource (else AUTH-1012). Safe to retry (read-only). Actions: testDatasource (jdbc, email, s3, ext-api, amorphic, arcgis — other types fail with GE-1004); getSampleData (ext-api only; other types return 200 Message); getSupportedItemTypes (arcgis only; other types return 200 Message); getSchemas, getSchemaTables, getTableMetadata (JDBC bulkdataload or advanceddataload only — otherwise the handler leaves the response unset and can fail with 500).

Request

Responses

200

Success response varies by action. testDatasource returns Message; getSampleData returns Status, Data, Headers, and Message for ext-api, or Message when unsupported; getSupportedItemTypes returns SupportedItemTypes for ArcGIS, or Message when unsupported; getSchemas and getSchemaTables return an array of names; and getTableMetadata returns an array of objects containing name and type.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Validation or authorization failure. Body is {"Message": " - "}. Common codes: AUTH-1012 (no view access), IPV-1045 (unknown datasource, missing schemaName/tableName/action for schema extract), GE-1004 (testDatasource or getSampleData failure).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

Backend failure. Body is {"Message": " - "}. Schema extract may return DTSC-1007 (bulk) or GE-1034 (advanced). Unsupported action/IngestionType combinations can surface as an unbound response (generic 500).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers