How do I fix ADF Pipeline Error 2341?

Open the HDInsight linked service in ADF and inspect the 'clusterUrl' value. Ensure the URL is in valid URI format and starts with 'https://' (not 'http://'). If parameterized, verify the resolved value at runtime in the activity input JSON. Test the linked service connection in ADF, then publish the corrected configuration. Re-run the failed pipeline activity and confirm it proceeds past the cluster connection step

High severityconfigurationAzure Data Factory →

ADF Pipeline Error:
ADF Pipeline Error 2341

What does this error mean?

HDInsight cluster URL is invalid — must be in URI format with 'https' scheme.

Common causes

1Cluster URL missing the 'https://' scheme or using 'http://' instead
2Typo or malformed URI in the HDInsight linked service configuration
3Parameterized URL resolving to an empty or invalid value at runtime
4Cluster endpoint changed (recreated/renamed) but linked service not updated

How to fix it

1Open the HDInsight linked service in ADF and inspect the 'clusterUrl' value
2Ensure the URL is in valid URI format and starts with 'https://' (not 'http://')
3If parameterized, verify the resolved value at runtime in the activity input JSON
4Test the linked service connection in ADF, then publish the corrected configuration
5Re-run the failed pipeline activity and confirm it proceeds past the cluster connection step

Frequently asked questions

What causes ADF Pipeline Error 2341?

Pipeline configuration or connectivity issue

Where can I find more details?

Open Azure Data Factory Monitor, find the failed run, click on the activity, and view the full error output in the Output tab.

Source · learn.microsoft.com/en-us/azure/data-factory/data-factory-troubleshoot-guide#error-code-2341