ARM Template DataFactory fails with "Self Hosted Integration Runtime: Updating property type is not supported."

Question

I am trying to clone a DataFactory to a different ResourceGroup.

To do so I exported the ARM template from the source Resource Group and I would like to import it into the new one.

I read here that you also need to recreate any self-hosted IR:

If you have a SelfHosted IntegrationRuntime in your source factory, you need to precreate it with the same name in the target factory. If you want to share the SelfHosted Integration Runtime between different factories, you can use the pattern published here on sharing SelfHosted IR.

I opted for sharing the existing IR into the new one.

Then I went on and imported the template passing any password or connection string in the UI when suggested. After I start the deployment I get one error:

Resource Microsoft.DataFactory/factories/integrationRuntimes '****/***' 
failed with message '{ "error": { "code": "DataFactoryPropertyUpdateNotSupported", 
"message": "Updating property type is not supported.", 
"target": null, "details": null } }'

I have seen here that the problem can be solved by creating an additional DTF to only contain the Integration Runtimes and then share it to all other DTF.

I would like to follow this hint but the problem is that I don't have access to the on-prem machine that was originally used to configure the IR.

Is there a way to just copy the IR definition from the target DTF to the new one without requiring to install the IR software into an on-prem machine?

Answer 1

Hi Francesco Pegoraro ,

Thankyou for using Microsoft Q&A and thanks for posting your query here.

As per my understanding you are trying to clone a Data Factory to a different Resource Group using an ARM template, however, you are encountering an error related to a Self-Hosted Integration Runtime (IR) and are looking for a solution for the same. Please let me know if this is not the correct understanding.

This error is due to an integration runtime with the same name in the target service instance, but with a different type. Integration Runtime needs to be of the same type during deployment.

Kindly implement the below points and see if helps:

• Refer to the Best Practices for CI/CD
• Integration runtimes don't change often and are similar across all stages in your CI/CD, so the service expects you to have the same name and type of integration runtime across all stages of CI/CD. If the name and types & properties are different, make sure to match the source and target integration runtime configuration and then deploy the release pipeline.
• If you want to share integration runtimes across all stages, consider using a ternary factory just to contain the shared integration runtimes. You can use this shared factory in all of your environments as a linked integration runtime type.

For more details, kindly refer to the troubleshooting documentation:

Troubleshoot CI-CD, Azure DevOps, and GitHub issues in Azure Data Factory and Synapse Analytics | Updating property type isn't supported

Hope it helps. Kindly accept the answer by clicking on Accept answer button if it helped. Thankyou