Create a datasource entity

POST 
/datasources/:datasource_id/entities

Creates an entity for a datasource. The caller (identified by role_id) must have at least edit permission (else AUTH-1012). Supports JDBC Bulkload (shared DMS instance), JDBC Advanced Load (shared Kafka cluster; blocked in GovCloud with GE-1034), and Streams (data transformation function after get_presigned_url upload). Other types fail at runtime. Not idempotent.

Request

Responses

200

Create accepted. Always returns Message and EntityId. Typical messages: "Successfully triggered entity creation and is running in background" (Bulk/Streams immediate; Advanced uses "it is running"), "Entity creation has been successfully scheduled" (Bulk scheduled), "Schedule has been created and the entity configuration is added to metadata" (Advanced scheduled).

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 edit access), IPV-1045 (missing EntityName/EntityConfig or invalid config), IPV-1008 / IPV-1010 / IPV-1018 (name validation), SCH-1015 (invalid schedule), GE-1034 (streams zip / config issues when raised as InvalidInput).

Response Headers

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

500

Backend failure. Body is {"Message": " - "} or a plain Message. Common codes: GE-1034 (Advanced create in GovCloud), DTSC-1006 / DTSC-1007 (DMS/schedule failures), GE-1020 / DB-1002 (persist failures). Unsupported datasource types fail here.

Response Headers

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