Create and Manage an Amazon S3 Data Source
This page describes the native-s3 (Amazon S3 data sources) endpoint.
Amazon S3 workflow
Create a data source
POST /native-s3/handler
Save the provided connection information as a data source.
Required Immuta permission: CREATE_S3_DATASOURCE
Payload parameters
The table below outlines the parameters for creating an S3 data source.
Parameter
Description
Required or optional
Accepted values
Response schema
The table below outlines the response schema for successful requests.
Request example
The following request saves the provided connection information as a data source.
Response example
The response returns the ID, name, and prefix of the data source. See the response schema above for details about the response schema. An unsuccessful response returns the status code and an error message.
Search Amazon S3 data sources
GET /native-s3/handler/{handlerId}
Get the handler metadata associated with the provided handler ID.
Query parameter
Attribute
Description
Required or optional
Response schema
Request example
The following request returns the handler metadata associated with the provided handler ID.
Response example
Delete an Amazon S3 data source
DELETE /dataSource/{dataSourceId}
Delete a data source. This will perform a soft delete on the first call and a hard delete the second time.
Required: The global GOVERNANCE permission or be the data source owner
Query parameters
Attribute
Description
Required
Response schema
Request example
The following request disables the data source 1.
Response example