Configure Reltio data sharing with Microsoft Fabric - essentials using APIs

Using the REST APIs, you create a Microsoft Fabric data share, set up the data share, and generate a share link for the recipient to accept.

Prerequisites

A valid tenant ID and environment
An authentication token with the required role, ROLE_DATA_PIPELINE_ADMIN
Details of your Microsoft Fabric environment, including region and recipient email
An active subscription for Reltio data sharing with Microsoft Fabric - essentials

To configure a Microsoft Fabric data share using APIs

Create a new data share

Send a request to the DPH service with the configuration details:

POST {env}-data-pipeline-hub.reltio.com/api/tenants/{tenantId}/adapters

Where:

{env} represents your environment identifier (for example, prod, or test).
{tenantId} is your tenant ID

Example request body:

POST test-data-pipeline-hub.reltio.com/api/tenants/f4K3XQ7EecQZGBE/adapters
{
  "type": "datashare-fabric",
  "name": "datashare",
  "enabled": true,
  "fabricConfig": {
    "region": "eastus2",
    "receiverEmails": [
      "user1@company.com"
    ]
  }
}

Field reference:


Parameter	Type	Description
`type`	String	Type of data share. Use `datashare-fabric`
`name`	String	Name of the data share. The name must be alphanumeric, can be 3 to 20 characters in length, and cannot contain any spaces.
`enabled`	Boolean	Enable or disable the data share
`fabricConfig.region`	String	Region and availability zone of the Fabric instance
`fabricConfig.receiverEmails`	Array	Email address of the recipient of the data share

Set up the data share
Send a request to provision the required Microsoft Fabric resources:
```
POST {env}-data-pipeline-hub.reltio.com/api/tenants/{tenantId}/adapters/{adapterName}/actions/setup
        
```
Where:
- {env} represents your environment identifier (e.g. dev, prod, test, etc)
- {tenantId} is your tenant ID
- {adapterName} is the name you gave your data share when you created it
Create a data share link
Send a request to generate a share link that MS Fabric users can use to log in and accept the data share:
```
POST {env}-data-pipeline-hub.reltio.com/api/tenants/{tenantId}/adapters/{adapterName}/shareLink
```
Where:
- {env} represents your environment identifier (e.g., dev, , prod, test, etc)
- {tenantId} is your tenant ID
- {adapterName} is the name you gave your data share when you created it
Get the data share link
Retrieve a previously generated link so the recipients can log in to Microsoft Fabric and accept the data share:
```
GET {env}-data-pipeline-hub.reltio.com/api/tenants/{tenantId}/adapters/{adapterName}/shareLink
        
```
Where:
- {env} represents your environment identifier (e.g. dev, prod, test, etc)
- {tenantId} is your tenant ID
- {adapterName} is the name you gave your data share when you created it

Result

Your data share is created, set up, and ready to use. Microsoft Fabric recipient can now accept the shared data through the generated link.

Unify and manage your data

Configure Reltio data sharing with Microsoft Fabric - essentials using APIs

Footer