使用Azure SDK部署创建MCA订阅的ARM模板报错如何解决？

• 部署层级不匹配：你使用的ARM模板是管理组层级部署模板（$schema指定为managementGroupDeploymentTemplate.json#），其中定义的Microsoft.Subscription/aliases资源绑定了管理组作用域。但C#代码调用的是资源组层级的部署接口（使用WithNewResourceGroup指定部署到新建资源组），跨层级部署时ARM校验引擎无法识别定义在管理组作用域下的资源，因此报输出引用的资源不存在的错误。PowerShell部署正常是因为你大概率使用的是管理组层级的部署命令，作用域匹配。
• 输出引用声明不完整：即使作用域匹配，你当前的reference调用未显式指定API版本，跨作用域引用资源时也可能触发校验失败。

方案1：调整C#代码为管理组层级部署（优先推荐，无需修改ARM模板） #

你当前使用的Azure.Fluent SDK对管理组部署支持不友好，建议迁移到官方最新的Azure.ResourceManager系列SDK，部署代码示例如下：

using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.ManagementGroups;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Resources.Models;

// 初始化ARM客户端，可根据需要替换认证方式
ArmClient armClient = new ArmClient(new DefaultAzureCredential());

// 获取目标管理组资源，替换为你实际的管理组ID
ManagementGroupResource mg = armClient.GetManagementGroupResource(ManagementGroupResource.CreateResourceIdentifier("mg-mission-default-dev"));

// 构造部署参数
ArmDeploymentContent deployContent = new ArmDeploymentContent(new ArmDeploymentProperties(ArmDeploymentMode.Incremental)
{
    Template = BinaryData.FromString(Utils.GetArmTemplate("<你的ARM模板路径>")),
    Parameters = BinaryData.FromString("{}")
});

// 执行管理组层级部署
var deployOp = await mg.GetArmDeployments().CreateOrUpdateAsync(WaitUntil.Completed, "deployment_temp", deployContent);
// 部署完成后从输出中获取订阅ID
var subId = deployOp.Value.Properties.Outputs["subscriptionID"].Value.ToString();

方案2：修改ARM模板适配资源组部署 #

如果暂时不想调整SDK和部署层级，可修改ARM模板的输出部分，显式声明资源的作用域和API版本：

"outputs": {
  "subscriptionID": {
    "type": "string",
    "value": "[reference(extensionResourceId(variables('mgId'), 'Microsoft.Subscription/aliases', parameters('subscriptionAliasName')), '2021-04-01').subscriptionId]"
  }
}

修改后使用你原有的C#代码即可正常部署。

替代方案：直接调用订阅别名API创建（无需依赖ARM模板） #

如果仅需要创建MCA订阅，可直接调用订阅别名的原生SDK接口，逻辑更简单，性能更好：

using Azure.Identity;
using Azure.ResourceManager;
using Azure.ResourceManager.Subscription;
using Azure.ResourceManager.Subscription.Models;

ArmClient armClient = new ArmClient(new DefaultAzureCredential());
// 构造别名资源
var aliasRes = armClient.GetSubscriptionAliasResource(SubscriptionAliasResource.CreateResourceIdentifier("devtestdeployasp22"));
// 构造创建参数
var aliasCreateParams = new SubscriptionAliasCreateOrUpdateContent()
{
    DisplayName = "devtestdeployasp22",
    Workload = SubscriptionWorkloadType.Production,
    BillingScope = "<你的Billing Scope值>",
    ManagementGroupId = "mg-mission-default-dev"
};
// 执行创建
var createOp = await aliasRes.CreateOrUpdateAsync(WaitUntil.Completed, aliasCreateParams);
// 直接获取订阅ID
string subscriptionId = createOp.Value.Data.SubscriptionId;

内容的提问来源于stack exchange，提问作者Willmore