Microsoft.Synapse workspaces/integrationRuntimes 2021-06-01-preview

Bicep resource definition

The workspaces/integrationRuntimes resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Synapse/workspaces/integrationRuntimes resource, add the following Bicep to your template.

resource symbolicname 'Microsoft.Synapse/workspaces/integrationRuntimes@2021-06-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    description: 'string'
    type: 'string'
    // For remaining properties, see IntegrationRuntime objects
  }
}

IntegrationRuntime objects

Set the type property to specify the type of object.

For Managed, use:

{
  managedVirtualNetwork: {
    id: 'string'
    referenceName: 'string'
    type: 'string'
  }
  type: 'Managed'
  typeProperties: {
    computeProperties: {
      dataFlowProperties: {
        cleanup: bool
        computeType: 'string'
        coreCount: int
        timeToLive: int
      }
      location: 'string'
      maxParallelExecutionsPerNode: int
      nodeSize: 'string'
      numberOfNodes: int
      vNetProperties: {
        publicIPs: [
          'string'
        ]
        subnet: 'string'
        subnetId: 'string'
        vNetId: 'string'
      }
    }
    ssisProperties: {
      catalogInfo: {
        catalogAdminPassword: {
          type: 'string'
          value: 'string'
        }
        catalogAdminUserName: 'string'
        catalogPricingTier: 'string'
        catalogServerEndpoint: 'string'
      }
      customSetupScriptProperties: {
        blobContainerUri: 'string'
        sasToken: {
          type: 'string'
          value: 'string'
        }
      }
      dataProxyProperties: {
        connectVia: {
          referenceName: 'string'
          type: 'string'
        }
        path: 'string'
        stagingLinkedService: {
          referenceName: 'string'
          type: 'string'
        }
      }
      edition: 'string'
      expressCustomSetupProperties: [
        {
          type: 'string'
          // For remaining properties, see CustomSetupBase objects
        }
      ]
      licenseType: 'string'
    }
  }
}

For SelfHosted, use:

{
  type: 'SelfHosted'
  typeProperties: {
    linkedInfo: {
      authorizationType: 'string'
      // For remaining properties, see LinkedIntegrationRuntimeType objects
    }
  }
}

LinkedIntegrationRuntimeType objects

Set the authorizationType property to specify the type of object.

For Key, use:

{
  authorizationType: 'Key'
  key: {
    type: 'string'
    value: 'string'
  }
}

For RBAC, use:

{
  authorizationType: 'RBAC'
  resourceId: 'string'
}

SecretBase objects

Set the type property to specify the type of object.

For SecureString, use:

{
  type: 'SecureString'
  value: 'string'
}

CustomSetupBase objects

Set the type property to specify the type of object.

For CmdkeySetup, use:

{
  type: 'CmdkeySetup'
  typeProperties: {
    password: {
      type: 'string'
      // For remaining properties, see SecretBase objects
    }
    targetName: any(Azure.Bicep.Types.Concrete.AnyType)
    userName: any(Azure.Bicep.Types.Concrete.AnyType)
  }
}

For ComponentSetup, use:

{
  type: 'ComponentSetup'
  typeProperties: {
    componentName: 'string'
    licenseKey: {
      type: 'string'
      // For remaining properties, see SecretBase objects
    }
  }
}

For EnvironmentVariableSetup, use:

{
  type: 'EnvironmentVariableSetup'
  typeProperties: {
    variableName: 'string'
    variableValue: 'string'
  }
}

Property values

CmdkeySetup

Name Description Value
type The type of custom setup. 'CmdkeySetup' (required)
typeProperties Cmdkey command custom setup type properties. CmdkeySetupTypeProperties (required)

CmdkeySetupTypeProperties

Name Description Value
password The password of data source access. SecretBase (required)
targetName The server name of data source access. any (required)
userName The user name of data source access. any (required)

ComponentSetup

Name Description Value
type The type of custom setup. 'ComponentSetup' (required)
typeProperties Install 3rd party component type properties. LicensedComponentSetupTypeProperties (required)

CustomSetupBase

Name Description Value
type Set to 'CmdkeySetup' for type CmdkeySetup. Set to 'ComponentSetup' for type ComponentSetup. Set to 'EnvironmentVariableSetup' for type EnvironmentVariableSetup. 'CmdkeySetup'
'ComponentSetup'
'EnvironmentVariableSetup' (required)

EntityReference

Name Description Value
referenceName The name of this referenced entity. string
type The type of this referenced entity. 'IntegrationRuntimeReference'
'LinkedServiceReference'

EnvironmentVariableSetup

Name Description Value
type The type of custom setup. 'EnvironmentVariableSetup' (required)
typeProperties Add environment variable type properties. EnvironmentVariableSetupTypeProperties (required)

EnvironmentVariableSetupTypeProperties

Name Description Value
variableName The name of the environment variable. string (required)
variableValue The value of the environment variable. string (required)

IntegrationRuntime

Name Description Value
description Integration runtime description. string
type Set to 'Managed' for type ManagedIntegrationRuntime. Set to 'SelfHosted' for type SelfHostedIntegrationRuntime. 'Managed'
'SelfHosted' (required)

IntegrationRuntimeComputeProperties

Name Description Value
dataFlowProperties Data flow properties for managed integration runtime. IntegrationRuntimeDataFlowProperties
location The location for managed integration runtime. The supported regions could be found on /azure/data-factory/data-factory-data-movement-activities string
maxParallelExecutionsPerNode Maximum parallel executions count per node for managed integration runtime. int

Constraints:
Min value = 1
nodeSize The node size requirement to managed integration runtime. string
numberOfNodes The required number of nodes for managed integration runtime. int

Constraints:
Min value = 1
vNetProperties VNet properties for managed integration runtime. IntegrationRuntimeVNetProperties

IntegrationRuntimeCustomSetupScriptProperties

Name Description Value
blobContainerUri The URI of the Azure blob container that contains the custom setup script. string
sasToken The SAS token of the Azure blob container. SecureString

IntegrationRuntimeDataFlowProperties

Name Description Value
cleanup Cluster will not be recycled and it will be used in next data flow activity run until TTL (time to live) is reached if this is set as false. Default is true. bool
computeType Compute type of the cluster which will execute data flow job. 'ComputeOptimized'
'General'
'MemoryOptimized'
coreCount Core count of the cluster which will execute data flow job. Supported values are: 8, 16, 32, 48, 80, 144 and 272. int
timeToLive Time to live (in minutes) setting of the cluster which will execute data flow job. int

Constraints:
Min value = 0

IntegrationRuntimeDataProxyProperties

Name Description Value
connectVia The self-hosted integration runtime reference. EntityReference
path The path to contain the staged data in the Blob storage. string
stagingLinkedService The staging linked service reference. EntityReference

IntegrationRuntimeSsisCatalogInfo

Name Description Value
catalogAdminPassword The password of the administrator user account of the catalog database. SecureString
catalogAdminUserName The administrator user name of catalog database. string

Constraints:
Min length = 1
Max length = 1
catalogPricingTier The pricing tier for the catalog database. The valid values could be found in https://azure.microsoft.com/en-us/pricing/details/sql-database/ 'Basic'
'Premium'
'PremiumRS'
'Standard'
catalogServerEndpoint The catalog database server URL. string

IntegrationRuntimeSsisProperties

Name Description Value
catalogInfo Catalog information for managed dedicated integration runtime. IntegrationRuntimeSsisCatalogInfo
customSetupScriptProperties Custom setup script properties for a managed dedicated integration runtime. IntegrationRuntimeCustomSetupScriptProperties
dataProxyProperties Data proxy properties for a managed dedicated integration runtime. IntegrationRuntimeDataProxyProperties
edition The edition for the SSIS Integration Runtime 'Enterprise'
'Standard'
expressCustomSetupProperties Custom setup without script properties for a SSIS integration runtime. CustomSetupBase[]
licenseType License type for bringing your own license scenario. 'BasePrice'
'LicenseIncluded'

IntegrationRuntimeVNetProperties

Name Description Value
publicIPs Resource IDs of the public IP addresses that this integration runtime will use. string[]
subnet The name of the subnet this integration runtime will join. string
subnetId The ID of subnet, to which this Azure-SSIS integration runtime will be joined. string
vNetId The ID of the VNet that this integration runtime will join. string

LicensedComponentSetupTypeProperties

Name Description Value
componentName The name of the 3rd party component. string (required)
licenseKey The license key to activate the component. SecretBase

LinkedIntegrationRuntimeKeyAuthorization

Name Description Value
authorizationType The authorization type for integration runtime sharing. 'Key' (required)
key The key used for authorization. SecureString (required)

LinkedIntegrationRuntimeRbacAuthorization

Name Description Value
authorizationType The authorization type for integration runtime sharing. 'RBAC' (required)
resourceId The resource identifier of the integration runtime to be shared. string (required)

LinkedIntegrationRuntimeType

Name Description Value
authorizationType Set to 'Key' for type LinkedIntegrationRuntimeKeyAuthorization. Set to 'RBAC' for type LinkedIntegrationRuntimeRbacAuthorization. 'Key'
'RBAC' (required)

ManagedIntegrationRuntime

Name Description Value
managedVirtualNetwork Managed integration runtime managed virtual network. ManagedIntegrationRuntimeManagedVirtualNetworkReference
type Type of integration runtime. 'Managed' (required)
typeProperties Managed integration runtime properties. ManagedIntegrationRuntimeTypeProperties (required)

ManagedIntegrationRuntimeManagedVirtualNetworkReference

Name Description Value
id The id of the managed virtual network. string
referenceName The reference name of the managed virtual network. string
type The type of the managed virtual network. string

ManagedIntegrationRuntimeTypeProperties

Name Description Value
computeProperties The compute resource for managed integration runtime. IntegrationRuntimeComputeProperties
ssisProperties SSIS properties for managed integration runtime. IntegrationRuntimeSsisProperties

Microsoft.Synapse/workspaces/integrationRuntimes

Name Description Value
name The resource name string (required)
parent In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource.

For more information, see Child resource outside parent resource.
Symbolic name for resource of type: workspaces
properties Integration runtime properties. IntegrationRuntime (required)

SecretBase

Name Description Value
type Set to 'SecureString' for type SecureString. 'SecureString' (required)

SecureString

Name Description Value
type Type of the secret. string (required)
value Value of secure string. string (required)

SecureString

Name Description Value
type Type of the secret. 'SecureString' (required)
value Value of secure string. string (required)

SelfHostedIntegrationRuntime

Name Description Value
type Type of integration runtime. 'SelfHosted' (required)
typeProperties When this property is not null, means this is a linked integration runtime. The property is used to access original integration runtime. SelfHostedIntegrationRuntimeTypeProperties

SelfHostedIntegrationRuntimeTypeProperties

Name Description Value
linkedInfo Linked integration runtime type from data factory LinkedIntegrationRuntimeType

ARM template resource definition

The workspaces/integrationRuntimes resource type can be deployed with operations that target:

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Synapse/workspaces/integrationRuntimes resource, add the following JSON to your template.

{
  "type": "Microsoft.Synapse/workspaces/integrationRuntimes",
  "apiVersion": "2021-06-01-preview",
  "name": "string",
  "properties": {
    "description": "string",
    "type": "string"
    // For remaining properties, see IntegrationRuntime objects
  }
}

IntegrationRuntime objects

Set the type property to specify the type of object.

For Managed, use:

{
  "managedVirtualNetwork": {
    "id": "string",
    "referenceName": "string",
    "type": "string"
  },
  "type": "Managed",
  "typeProperties": {
    "computeProperties": {
      "dataFlowProperties": {
        "cleanup": "bool",
        "computeType": "string",
        "coreCount": "int",
        "timeToLive": "int"
      },
      "location": "string",
      "maxParallelExecutionsPerNode": "int",
      "nodeSize": "string",
      "numberOfNodes": "int",
      "vNetProperties": {
        "publicIPs": [ "string" ],
        "subnet": "string",
        "subnetId": "string",
        "vNetId": "string"
      }
    },
    "ssisProperties": {
      "catalogInfo": {
        "catalogAdminPassword": {
          "type": "string",
          "value": "string"
        },
        "catalogAdminUserName": "string",
        "catalogPricingTier": "string",
        "catalogServerEndpoint": "string"
      },
      "customSetupScriptProperties": {
        "blobContainerUri": "string",
        "sasToken": {
          "type": "string",
          "value": "string"
        }
      },
      "dataProxyProperties": {
        "connectVia": {
          "referenceName": "string",
          "type": "string"
        },
        "path": "string",
        "stagingLinkedService": {
          "referenceName": "string",
          "type": "string"
        }
      },
      "edition": "string",
      "expressCustomSetupProperties": [ {
        "type": "string"
        // For remaining properties, see CustomSetupBase objects
      } ],
      "licenseType": "string"
    }
  }
}

For SelfHosted, use:

{
  "type": "SelfHosted",
  "typeProperties": {
    "linkedInfo": {
      "authorizationType": "string"
      // For remaining properties, see LinkedIntegrationRuntimeType objects
    }
  }
}

LinkedIntegrationRuntimeType objects

Set the authorizationType property to specify the type of object.

For Key, use:

{
  "authorizationType": "Key",
  "key": {
    "type": "string",
    "value": "string"
  }
}

For RBAC, use:

{
  "authorizationType": "RBAC",
  "resourceId": "string"
}

SecretBase objects

Set the type property to specify the type of object.

For SecureString, use:

{
  "type": "SecureString",
  "value": "string"
}

CustomSetupBase objects

Set the type property to specify the type of object.

For CmdkeySetup, use:

{
  "type": "CmdkeySetup",
  "typeProperties": {
    "password": {
      "type": "string"
      // For remaining properties, see SecretBase objects
    },
    "targetName": {},
    "userName": {}
  }
}

For ComponentSetup, use:

{
  "type": "ComponentSetup",
  "typeProperties": {
    "componentName": "string",
    "licenseKey": {
      "type": "string"
      // For remaining properties, see SecretBase objects
    }
  }
}

For EnvironmentVariableSetup, use:

{
  "type": "EnvironmentVariableSetup",
  "typeProperties": {
    "variableName": "string",
    "variableValue": "string"
  }
}

Property values

CmdkeySetup

Name Description Value
type The type of custom setup. 'CmdkeySetup' (required)
typeProperties Cmdkey command custom setup type properties. CmdkeySetupTypeProperties (required)

CmdkeySetupTypeProperties

Name Description Value
password The password of data source access. SecretBase (required)
targetName The server name of data source access. any (required)
userName The user name of data source access. any (required)

ComponentSetup

Name Description Value
type The type of custom setup. 'ComponentSetup' (required)
typeProperties Install 3rd party component type properties. LicensedComponentSetupTypeProperties (required)

CustomSetupBase

Name Description Value
type Set to 'CmdkeySetup' for type CmdkeySetup. Set to 'ComponentSetup' for type ComponentSetup. Set to 'EnvironmentVariableSetup' for type EnvironmentVariableSetup. 'CmdkeySetup'
'ComponentSetup'
'EnvironmentVariableSetup' (required)

EntityReference

Name Description Value
referenceName The name of this referenced entity. string
type The type of this referenced entity. 'IntegrationRuntimeReference'
'LinkedServiceReference'

EnvironmentVariableSetup

Name Description Value
type The type of custom setup. 'EnvironmentVariableSetup' (required)
typeProperties Add environment variable type properties. EnvironmentVariableSetupTypeProperties (required)

EnvironmentVariableSetupTypeProperties

Name Description Value
variableName The name of the environment variable. string (required)
variableValue The value of the environment variable. string (required)

IntegrationRuntime

Name Description Value
description Integration runtime description. string
type Set to 'Managed' for type ManagedIntegrationRuntime. Set to 'SelfHosted' for type SelfHostedIntegrationRuntime. 'Managed'
'SelfHosted' (required)

IntegrationRuntimeComputeProperties

Name Description Value
dataFlowProperties Data flow properties for managed integration runtime. IntegrationRuntimeDataFlowProperties
location The location for managed integration runtime. The supported regions could be found on /azure/data-factory/data-factory-data-movement-activities string
maxParallelExecutionsPerNode Maximum parallel executions count per node for managed integration runtime. int

Constraints:
Min value = 1
nodeSize The node size requirement to managed integration runtime. string
numberOfNodes The required number of nodes for managed integration runtime. int

Constraints:
Min value = 1
vNetProperties VNet properties for managed integration runtime. IntegrationRuntimeVNetProperties

IntegrationRuntimeCustomSetupScriptProperties

Name Description Value
blobContainerUri The URI of the Azure blob container that contains the custom setup script. string
sasToken The SAS token of the Azure blob container. SecureString

IntegrationRuntimeDataFlowProperties

Name Description Value
cleanup Cluster will not be recycled and it will be used in next data flow activity run until TTL (time to live) is reached if this is set as false. Default is true. bool
computeType Compute type of the cluster which will execute data flow job. 'ComputeOptimized'
'General'
'MemoryOptimized'
coreCount Core count of the cluster which will execute data flow job. Supported values are: 8, 16, 32, 48, 80, 144 and 272. int
timeToLive Time to live (in minutes) setting of the cluster which will execute data flow job. int

Constraints:
Min value = 0

IntegrationRuntimeDataProxyProperties

Name Description Value
connectVia The self-hosted integration runtime reference. EntityReference
path The path to contain the staged data in the Blob storage. string
stagingLinkedService The staging linked service reference. EntityReference

IntegrationRuntimeSsisCatalogInfo

Name Description Value
catalogAdminPassword The password of the administrator user account of the catalog database. SecureString
catalogAdminUserName The administrator user name of catalog database. string

Constraints:
Min length = 1
Max length = 1
catalogPricingTier The pricing tier for the catalog database. The valid values could be found in https://azure.microsoft.com/en-us/pricing/details/sql-database/ 'Basic'
'Premium'
'PremiumRS'
'Standard'
catalogServerEndpoint The catalog database server URL. string

IntegrationRuntimeSsisProperties

Name Description Value
catalogInfo Catalog information for managed dedicated integration runtime. IntegrationRuntimeSsisCatalogInfo
customSetupScriptProperties Custom setup script properties for a managed dedicated integration runtime. IntegrationRuntimeCustomSetupScriptProperties
dataProxyProperties Data proxy properties for a managed dedicated integration runtime. IntegrationRuntimeDataProxyProperties
edition The edition for the SSIS Integration Runtime 'Enterprise'
'Standard'
expressCustomSetupProperties Custom setup without script properties for a SSIS integration runtime. CustomSetupBase[]
licenseType License type for bringing your own license scenario. 'BasePrice'
'LicenseIncluded'

IntegrationRuntimeVNetProperties

Name Description Value
publicIPs Resource IDs of the public IP addresses that this integration runtime will use. string[]
subnet The name of the subnet this integration runtime will join. string
subnetId The ID of subnet, to which this Azure-SSIS integration runtime will be joined. string
vNetId The ID of the VNet that this integration runtime will join. string

LicensedComponentSetupTypeProperties

Name Description Value
componentName The name of the 3rd party component. string (required)
licenseKey The license key to activate the component. SecretBase

LinkedIntegrationRuntimeKeyAuthorization

Name Description Value
authorizationType The authorization type for integration runtime sharing. 'Key' (required)
key The key used for authorization. SecureString (required)

LinkedIntegrationRuntimeRbacAuthorization

Name Description Value
authorizationType The authorization type for integration runtime sharing. 'RBAC' (required)
resourceId The resource identifier of the integration runtime to be shared. string (required)

LinkedIntegrationRuntimeType

Name Description Value
authorizationType Set to 'Key' for type LinkedIntegrationRuntimeKeyAuthorization. Set to 'RBAC' for type LinkedIntegrationRuntimeRbacAuthorization. 'Key'
'RBAC' (required)

ManagedIntegrationRuntime

Name Description Value
managedVirtualNetwork Managed integration runtime managed virtual network. ManagedIntegrationRuntimeManagedVirtualNetworkReference
type Type of integration runtime. 'Managed' (required)
typeProperties Managed integration runtime properties. ManagedIntegrationRuntimeTypeProperties (required)

ManagedIntegrationRuntimeManagedVirtualNetworkReference

Name Description Value
id The id of the managed virtual network. string
referenceName The reference name of the managed virtual network. string
type The type of the managed virtual network. string

ManagedIntegrationRuntimeTypeProperties

Name Description Value
computeProperties The compute resource for managed integration runtime. IntegrationRuntimeComputeProperties
ssisProperties SSIS properties for managed integration runtime. IntegrationRuntimeSsisProperties

Microsoft.Synapse/workspaces/integrationRuntimes

Name Description Value
apiVersion The api version '2021-06-01-preview'
name The resource name string (required)
properties Integration runtime properties. IntegrationRuntime (required)
type The resource type 'Microsoft.Synapse/workspaces/integrationRuntimes'

SecretBase

Name Description Value
type Set to 'SecureString' for type SecureString. 'SecureString' (required)

SecureString

Name Description Value
type Type of the secret. string (required)
value Value of secure string. string (required)

SecureString

Name Description Value
type Type of the secret. 'SecureString' (required)
value Value of secure string. string (required)

SelfHostedIntegrationRuntime

Name Description Value
type Type of integration runtime. 'SelfHosted' (required)
typeProperties When this property is not null, means this is a linked integration runtime. The property is used to access original integration runtime. SelfHostedIntegrationRuntimeTypeProperties

SelfHostedIntegrationRuntimeTypeProperties

Name Description Value
linkedInfo Linked integration runtime type from data factory LinkedIntegrationRuntimeType

Terraform (AzAPI provider) resource definition

The workspaces/integrationRuntimes resource type can be deployed with operations that target:

  • Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Synapse/workspaces/integrationRuntimes resource, add the following Terraform to your template.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Synapse/workspaces/integrationRuntimes@2021-06-01-preview"
  name = "string"
  body = jsonencode({
    properties = {
      description = "string"
      type = "string"
      // For remaining properties, see IntegrationRuntime objects
    }
  })
}

IntegrationRuntime objects

Set the type property to specify the type of object.

For Managed, use:

{
  managedVirtualNetwork = {
    id = "string"
    referenceName = "string"
    type = "string"
  }
  type = "Managed"
  typeProperties = {
    computeProperties = {
      dataFlowProperties = {
        cleanup = bool
        computeType = "string"
        coreCount = int
        timeToLive = int
      }
      location = "string"
      maxParallelExecutionsPerNode = int
      nodeSize = "string"
      numberOfNodes = int
      vNetProperties = {
        publicIPs = [
          "string"
        ]
        subnet = "string"
        subnetId = "string"
        vNetId = "string"
      }
    }
    ssisProperties = {
      catalogInfo = {
        catalogAdminPassword = {
          type = "string"
          value = "string"
        }
        catalogAdminUserName = "string"
        catalogPricingTier = "string"
        catalogServerEndpoint = "string"
      }
      customSetupScriptProperties = {
        blobContainerUri = "string"
        sasToken = {
          type = "string"
          value = "string"
        }
      }
      dataProxyProperties = {
        connectVia = {
          referenceName = "string"
          type = "string"
        }
        path = "string"
        stagingLinkedService = {
          referenceName = "string"
          type = "string"
        }
      }
      edition = "string"
      expressCustomSetupProperties = [
        {
          type = "string"
          // For remaining properties, see CustomSetupBase objects
        }
      ]
      licenseType = "string"
    }
  }
}

For SelfHosted, use:

{
  type = "SelfHosted"
  typeProperties = {
    linkedInfo = {
      authorizationType = "string"
      // For remaining properties, see LinkedIntegrationRuntimeType objects
    }
  }
}

LinkedIntegrationRuntimeType objects

Set the authorizationType property to specify the type of object.

For Key, use:

{
  authorizationType = "Key"
  key = {
    type = "string"
    value = "string"
  }
}

For RBAC, use:

{
  authorizationType = "RBAC"
  resourceId = "string"
}

SecretBase objects

Set the type property to specify the type of object.

For SecureString, use:

{
  type = "SecureString"
  value = "string"
}

CustomSetupBase objects

Set the type property to specify the type of object.

For CmdkeySetup, use:

{
  type = "CmdkeySetup"
  typeProperties = {
    password = {
      type = "string"
      // For remaining properties, see SecretBase objects
    }
    targetName = ?
    userName = ?
  }
}

For ComponentSetup, use:

{
  type = "ComponentSetup"
  typeProperties = {
    componentName = "string"
    licenseKey = {
      type = "string"
      // For remaining properties, see SecretBase objects
    }
  }
}

For EnvironmentVariableSetup, use:

{
  type = "EnvironmentVariableSetup"
  typeProperties = {
    variableName = "string"
    variableValue = "string"
  }
}

Property values

CmdkeySetup

Name Description Value
type The type of custom setup. 'CmdkeySetup' (required)
typeProperties Cmdkey command custom setup type properties. CmdkeySetupTypeProperties (required)

CmdkeySetupTypeProperties

Name Description Value
password The password of data source access. SecretBase (required)
targetName The server name of data source access. any (required)
userName The user name of data source access. any (required)

ComponentSetup

Name Description Value
type The type of custom setup. 'ComponentSetup' (required)
typeProperties Install 3rd party component type properties. LicensedComponentSetupTypeProperties (required)

CustomSetupBase

Name Description Value
type Set to 'CmdkeySetup' for type CmdkeySetup. Set to 'ComponentSetup' for type ComponentSetup. Set to 'EnvironmentVariableSetup' for type EnvironmentVariableSetup. 'CmdkeySetup'
'ComponentSetup'
'EnvironmentVariableSetup' (required)

EntityReference

Name Description Value
referenceName The name of this referenced entity. string
type The type of this referenced entity. 'IntegrationRuntimeReference'
'LinkedServiceReference'

EnvironmentVariableSetup

Name Description Value
type The type of custom setup. 'EnvironmentVariableSetup' (required)
typeProperties Add environment variable type properties. EnvironmentVariableSetupTypeProperties (required)

EnvironmentVariableSetupTypeProperties

Name Description Value
variableName The name of the environment variable. string (required)
variableValue The value of the environment variable. string (required)

IntegrationRuntime

Name Description Value
description Integration runtime description. string
type Set to 'Managed' for type ManagedIntegrationRuntime. Set to 'SelfHosted' for type SelfHostedIntegrationRuntime. 'Managed'
'SelfHosted' (required)

IntegrationRuntimeComputeProperties

Name Description Value
dataFlowProperties Data flow properties for managed integration runtime. IntegrationRuntimeDataFlowProperties
location The location for managed integration runtime. The supported regions could be found on /azure/data-factory/data-factory-data-movement-activities string
maxParallelExecutionsPerNode Maximum parallel executions count per node for managed integration runtime. int

Constraints:
Min value = 1
nodeSize The node size requirement to managed integration runtime. string
numberOfNodes The required number of nodes for managed integration runtime. int

Constraints:
Min value = 1
vNetProperties VNet properties for managed integration runtime. IntegrationRuntimeVNetProperties

IntegrationRuntimeCustomSetupScriptProperties

Name Description Value
blobContainerUri The URI of the Azure blob container that contains the custom setup script. string
sasToken The SAS token of the Azure blob container. SecureString

IntegrationRuntimeDataFlowProperties

Name Description Value
cleanup Cluster will not be recycled and it will be used in next data flow activity run until TTL (time to live) is reached if this is set as false. Default is true. bool
computeType Compute type of the cluster which will execute data flow job. 'ComputeOptimized'
'General'
'MemoryOptimized'
coreCount Core count of the cluster which will execute data flow job. Supported values are: 8, 16, 32, 48, 80, 144 and 272. int
timeToLive Time to live (in minutes) setting of the cluster which will execute data flow job. int

Constraints:
Min value = 0

IntegrationRuntimeDataProxyProperties

Name Description Value
connectVia The self-hosted integration runtime reference. EntityReference
path The path to contain the staged data in the Blob storage. string
stagingLinkedService The staging linked service reference. EntityReference

IntegrationRuntimeSsisCatalogInfo

Name Description Value
catalogAdminPassword The password of the administrator user account of the catalog database. SecureString
catalogAdminUserName The administrator user name of catalog database. string

Constraints:
Min length = 1
Max length = 1
catalogPricingTier The pricing tier for the catalog database. The valid values could be found in https://azure.microsoft.com/en-us/pricing/details/sql-database/ 'Basic'
'Premium'
'PremiumRS'
'Standard'
catalogServerEndpoint The catalog database server URL. string

IntegrationRuntimeSsisProperties

Name Description Value
catalogInfo Catalog information for managed dedicated integration runtime. IntegrationRuntimeSsisCatalogInfo
customSetupScriptProperties Custom setup script properties for a managed dedicated integration runtime. IntegrationRuntimeCustomSetupScriptProperties
dataProxyProperties Data proxy properties for a managed dedicated integration runtime. IntegrationRuntimeDataProxyProperties
edition The edition for the SSIS Integration Runtime 'Enterprise'
'Standard'
expressCustomSetupProperties Custom setup without script properties for a SSIS integration runtime. CustomSetupBase[]
licenseType License type for bringing your own license scenario. 'BasePrice'
'LicenseIncluded'

IntegrationRuntimeVNetProperties

Name Description Value
publicIPs Resource IDs of the public IP addresses that this integration runtime will use. string[]
subnet The name of the subnet this integration runtime will join. string
subnetId The ID of subnet, to which this Azure-SSIS integration runtime will be joined. string
vNetId The ID of the VNet that this integration runtime will join. string

LicensedComponentSetupTypeProperties

Name Description Value
componentName The name of the 3rd party component. string (required)
licenseKey The license key to activate the component. SecretBase

LinkedIntegrationRuntimeKeyAuthorization

Name Description Value
authorizationType The authorization type for integration runtime sharing. 'Key' (required)
key The key used for authorization. SecureString (required)

LinkedIntegrationRuntimeRbacAuthorization

Name Description Value
authorizationType The authorization type for integration runtime sharing. 'RBAC' (required)
resourceId The resource identifier of the integration runtime to be shared. string (required)

LinkedIntegrationRuntimeType

Name Description Value
authorizationType Set to 'Key' for type LinkedIntegrationRuntimeKeyAuthorization. Set to 'RBAC' for type LinkedIntegrationRuntimeRbacAuthorization. 'Key'
'RBAC' (required)

ManagedIntegrationRuntime

Name Description Value
managedVirtualNetwork Managed integration runtime managed virtual network. ManagedIntegrationRuntimeManagedVirtualNetworkReference
type Type of integration runtime. 'Managed' (required)
typeProperties Managed integration runtime properties. ManagedIntegrationRuntimeTypeProperties (required)

ManagedIntegrationRuntimeManagedVirtualNetworkReference

Name Description Value
id The id of the managed virtual network. string
referenceName The reference name of the managed virtual network. string
type The type of the managed virtual network. string

ManagedIntegrationRuntimeTypeProperties

Name Description Value
computeProperties The compute resource for managed integration runtime. IntegrationRuntimeComputeProperties
ssisProperties SSIS properties for managed integration runtime. IntegrationRuntimeSsisProperties

Microsoft.Synapse/workspaces/integrationRuntimes

Name Description Value
name The resource name string (required)
parent_id The ID of the resource that is the parent for this resource. ID for resource of type: workspaces
properties Integration runtime properties. IntegrationRuntime (required)
type The resource type "Microsoft.Synapse/workspaces/integrationRuntimes@2021-06-01-preview"

SecretBase

Name Description Value
type Set to 'SecureString' for type SecureString. 'SecureString' (required)

SecureString

Name Description Value
type Type of the secret. string (required)
value Value of secure string. string (required)

SecureString

Name Description Value
type Type of the secret. 'SecureString' (required)
value Value of secure string. string (required)

SelfHostedIntegrationRuntime

Name Description Value
type Type of integration runtime. 'SelfHosted' (required)
typeProperties When this property is not null, means this is a linked integration runtime. The property is used to access original integration runtime. SelfHostedIntegrationRuntimeTypeProperties

SelfHostedIntegrationRuntimeTypeProperties

Name Description Value
linkedInfo Linked integration runtime type from data factory LinkedIntegrationRuntimeType