List All Private Links

Returns a list of all private links.

Request schema

DATABRICKS_AWS

Query parameters

cursor

string

Paging cursor, read more about pagination

example:

lhg1345hk8vh

limit

integer

Number of records to fetch per page. Accepts a number in the range 1..1000; the default value is 100.

format:

int32

example:

100

Header parameters

Authorization

stringrequired

HTTP: basicAuth

HTTP AuthorizationScheme: basic

string

default:

application/json

example:

application/json

Http + 1.1

GET

https://api.fivetran.com/v1/private-links

GET /v1/private-links?cursor=lhg1345hk8vh&limit=100 HTTP/1.1
Accept: application/json
Authorization: Basic REPLACE_BASIC_AUTH
Host: api.fivetran.com

Responses

200

Successful response

Successful response schema

code

stringrequired

Response status code

example:

Success

message

string

Response status text

example:

Operation performed.

data

objectrequired

items

arrayrequired

The collection of returned items

stringrequired

The unique identifier for the private link within the Fivetran system.

example:

private_link_id

name

stringrequired

Private link name

example:

PrivateLinkName

region

stringrequired

Data processing location. This is where Fivetran will operate and run computation on data.

enum:

"GCP_US_EAST4""GCP_US_WEST1""GCP_EUROPE_WEST3""GCP_AUSTRALIA_SOUTHEAST1""GCP_NORTHAMERICA_NORTHEAST1""GCP_EUROPE_WEST2""GCP_ASIA_SOUTHEAST1""GCP_ASIA_SOUTHEAST2""GCP_ASIA_SOUTH1""GCP_ASIA_NORTHEAST1""AWS_US_EAST_1""AWS_US_EAST_2""AWS_US_WEST_2""AWS_AP_NORTHEAST_1""AWS_AP_SOUTHEAST_1""AWS_AP_SOUTHEAST_2""AWS_EU_CENTRAL_1""AWS_EU_WEST_1""AWS_EU_WEST_2""AWS_AP_SOUTH_1""AWS_CA_CENTRAL_1""AWS_US_GOV_WEST_1""AZURE_EASTUS2""AZURE_AUSTRALIAEAST""AZURE_UKSOUTH""AZURE_WESTEUROPE""AZURE_CENTRALUS""AZURE_CANADACENTRAL""AZURE_UAENORTH""AZURE_SOUTHEASTASIA"

service

stringrequired

DATABRICKS_AWS

The name for the service type within the Fivetran system.

enum:

"DATABRICKS_AWS""SNOWFLAKE_AWS""REDSHIFT_AWS""SOURCE_AWS""DATABRICKS_AZURE""SNOWFLAKE_AZURE""ONELAKE_AZURE""SYNAPSE_AZURE""POSTGRES_WAREHOUSE_AZURE""SQL_DATA_WAREHOUSE_AZURE""SOURCE_AZURE""SNOWFLAKE_GCP""SOURCE_GCP"

state

stringrequired

Private link state

enum:

"CREATING""UPDATING""DESTROYING""OK""FAIL"

account_id

string

created_at

stringrequired

The timestamp of the time the private link was created in your account

format:

date-time

example:

2023-12-01T15:43:29.013729Z

created_by

stringrequired

The actor who created the private link

example:

user_id

cloud_provider

stringrequired

Private link cloud provider

enum:

"AWS""GCP""AZURE"

state_summary

stringrequired

Private link state summary

example:

...

config

objectrequired

Databricks for AWS

connection_service_name

objectrequired

The name of your connection service.

example:

connection_service_name

nextCursor

string

The value of the cursor parameter for the next page

example:

cursor_value

{
  "code": "Success",
  "message": "Operation performed.",
  "data": {
    "items": [
      {
        "id": "private_link_id",
        "name": "PrivateLinkName",
        "region": "AWS_US_EAST_1",
        "service": "DATABRICKS_AWS",
        "state": "OK",
        "account_id": "string",
        "created_at": "2023-12-01T15:43:29.013729Z",
        "created_by": "user_id",
        "cloud_provider": "AWS",
        "state_summary": "...",
        "config": {
          "connection_service_name": "connection_service_name"
        }
      }
    ],
    "nextCursor": "cursor_value"
  }
}