What causes DF-GEN2-InvalidCloudType?

The linked service 'Azure Cloud' setting is set to 'Azure' (public) but the storage account is in Azure China or Azure Government. The ADF instance is in one cloud environment and the storage account is in another, requiring cross-cloud endpoint configuration. A linked service was copied from a public cloud environment into a sovereign cloud ADF without updating the cloud type

How do I fix DF-GEN2-InvalidCloudType?

Open the ADLS Gen2 linked service in ADF Studio and find the 'Azure Cloud' or 'Environment' setting.. Match the cloud type to where the storage account lives: Azure (public), AzureChina, or AzureUsGovernment.. Verify the storage account endpoint hostname suffix matches the cloud type: .dfs.core.windows.net (public), .dfs.core.chinacloudapi.cn (China), .dfs.core.usgovcloudapi.net (Government).. Click 'Test connection' after updating the cloud type to confirm the endpoint resolves correctly.

Medium severitydata source

Power BI Refresh Error:
DF-GEN2-InvalidCloudType

What does this error mean?

The ADLS Gen2 linked service is configured for one Azure cloud environment (Public, China, Government) but the target storage account is in a different environment. The endpoint and token authority differ between cloud types.

Common causes

1The linked service 'Azure Cloud' setting is set to 'Azure' (public) but the storage account is in Azure China or Azure Government
2The ADF instance is in one cloud environment and the storage account is in another, requiring cross-cloud endpoint configuration
3A linked service was copied from a public cloud environment into a sovereign cloud ADF without updating the cloud type

How to fix it

1Open the ADLS Gen2 linked service in ADF Studio and find the 'Azure Cloud' or 'Environment' setting.
2Match the cloud type to where the storage account lives: Azure (public), AzureChina, or AzureUsGovernment.
3Verify the storage account endpoint hostname suffix matches the cloud type: .dfs.core.windows.net (public), .dfs.core.chinacloudapi.cn (China), .dfs.core.usgovcloudapi.net (Government).
4Click 'Test connection' after updating the cloud type to confirm the endpoint resolves correctly.

Frequently asked questions

What are the different Azure cloud environments for ADLS Gen2?

Azure has three main cloud environments: Public (global), China (operated by 21Vianet), and US Government. Each uses different endpoint suffixes and authentication authorities.

Can ADF in Azure Public connect to a storage account in Azure China?

No — cross-cloud connections are not supported. ADF must be in the same cloud environment as the storage account.

How do I know which cloud type my storage account is in?

Check the storage account endpoint in the Azure portal. China uses .chinacloudapi.cn, Government uses .usgovcloudapi.net, and Public uses .core.windows.net.

Official documentation: https://learn.microsoft.com/en-us/azure/data-factory/data-flow-troubleshoot-guide