---
title: "PUT /linkconnections/{linkConnectionName}"
method: PUT
path: "/linkconnections/{linkConnectionName}"
tags: ["linkConnections"]
---

# PUT /linkconnections/{linkConnectionName}

`PUT /linkconnections/{linkConnectionName}`

Creates or updates a link connection

## Path parameters

- `linkConnectionName` string, required

## Query parameters

- `api-version` string, required

## Request body

- LinkConnectionResource
  - `id` string — Link connection id
  - `name` string — Link connection name
  - `type` string — Link connection type
  - `properties` LinkConnection, required
    - `sourceDatabase` LinkConnectionSourceDatabase
      - `linkedService` LinkedServiceReference — Linked service reference type.
        - `type` 'LinkedServiceReference', required — Linked service reference type.
        - `referenceName` string, required — Reference LinkedService name.
        - `parameters` ParameterValueSpecification — An object mapping parameter names to argument values.
      - `typeProperties` LinkConnectionSourceDatabaseTypeProperties
        - `resourceId` string — Link connection source database server's resource id
        - `principalId` string — Link connection source database server's principal id
    - `targetDatabase` LinkConnectionTargetDatabase
      - `linkedService` LinkedServiceReference — Linked service reference type.
        - `type` 'LinkedServiceReference', required — Linked service reference type.
        - `referenceName` string, required — Reference LinkedService name.
        - `parameters` ParameterValueSpecification — An object mapping parameter names to argument values.
      - `typeProperties` LinkConnectionTargetDatabaseTypeProperties
        - `crossTableTransaction` boolean — Enable cross table transaction consistency on target database
        - `dropExistingTargetTableOnStart` boolean — Drop and recreate same existing target table on link connection target database
        - `actionOnExistingTargetTable` 'FailOnNonEmptyTable' | 'DropAndRecreateTable' | 'MergeWithExistingData' — Action on existing target table. If not specified, 'FailOnNonEmptyTable' action is used.
    - `landingZone` LinkConnectionLandingZone
      - `linkedService` LinkedServiceReference — Linked service reference type.
        - `type` 'LinkedServiceReference', required — Linked service reference type.
        - `referenceName` string, required — Reference LinkedService name.
        - `parameters` ParameterValueSpecification — An object mapping parameter names to argument values.
      - `fileSystem` string — Landing zone's file system name
      - `folderPath` string — Landing zone's folder path name
      - `sasToken` SecureString — The base definition of a secret type.
        - `type` string, required — Type of the secret.
    - `compute` LinkConnectionCompute
      - `coreCount` integer — Compute core count used by the link connection
      - `computeType` string — Link connection's compute type
      - `dataProcessIntervalMinutes` integer — Link connection's data process interval in minutes
  - `description` string — Link connection description

## Response `200`

OK

- LinkConnectionResource
  - `id` string — Link connection id
  - `name` string — Link connection name
  - `type` string — Link connection type
  - `properties` LinkConnection, required
    - `sourceDatabase` LinkConnectionSourceDatabase
      - `linkedService` LinkedServiceReference — Linked service reference type.
        - `type` 'LinkedServiceReference', required — Linked service reference type.
        - `referenceName` string, required — Reference LinkedService name.
        - `parameters` ParameterValueSpecification — An object mapping parameter names to argument values.
      - `typeProperties` LinkConnectionSourceDatabaseTypeProperties
        - `resourceId` string — Link connection source database server's resource id
        - `principalId` string — Link connection source database server's principal id
    - `targetDatabase` LinkConnectionTargetDatabase
      - `linkedService` LinkedServiceReference — Linked service reference type.
        - `type` 'LinkedServiceReference', required — Linked service reference type.
        - `referenceName` string, required — Reference LinkedService name.
        - `parameters` ParameterValueSpecification — An object mapping parameter names to argument values.
      - `typeProperties` LinkConnectionTargetDatabaseTypeProperties
        - `crossTableTransaction` boolean — Enable cross table transaction consistency on target database
        - `dropExistingTargetTableOnStart` boolean — Drop and recreate same existing target table on link connection target database
        - `actionOnExistingTargetTable` 'FailOnNonEmptyTable' | 'DropAndRecreateTable' | 'MergeWithExistingData' — Action on existing target table. If not specified, 'FailOnNonEmptyTable' action is used.
    - `landingZone` LinkConnectionLandingZone
      - `linkedService` LinkedServiceReference — Linked service reference type.
        - `type` 'LinkedServiceReference', required — Linked service reference type.
        - `referenceName` string, required — Reference LinkedService name.
        - `parameters` ParameterValueSpecification — An object mapping parameter names to argument values.
      - `fileSystem` string — Landing zone's file system name
      - `folderPath` string — Landing zone's folder path name
      - `sasToken` SecureString — The base definition of a secret type.
        - `type` string, required — Type of the secret.
    - `compute` LinkConnectionCompute
      - `coreCount` integer — Compute core count used by the link connection
      - `computeType` string — Link connection's compute type
      - `dataProcessIntervalMinutes` integer — Link connection's data process interval in minutes
  - `description` string — Link connection description

## Other responses

- `default` — An error response received from the Azure Synapse service.

---

[API](https://skmtc.net/azuresynapse/apis/artifactsclient-4.md) · [All operations](https://skmtc.net/azuresynapse/apis/artifactsclient-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azuresynapse/artifactsclient-4/versions/fc1fdc654d4b/schema)