Azure工作簿部署失败：sharedType不能为空错误求助

什么是sharedType #

sharedType是Azure工作簿ARM模板中的隐含必填属性，用于定义工作簿的共享可见范围，可选值通常包括：

• Private：仅当前用户可见
• Shared：同订阅/资源组下的其他用户可见
• Gallery：作为模板共享至整个租户

该字段未在Azure公开文档中单独列出，属于ARM模板的内部必填项，容易被忽略。

错误原因及修复方法 #

出现此错误的核心原因是ARM模板中缺少sharedType字段，或该字段被设置为null。修复步骤如下：

1. 打开你的工作簿ARM模板，定位到Microsoft.Insights/workbooks资源的properties节点
2. 添加或补全sharedType字段，示例代码如下：

{
  "type": "Microsoft.Insights/workbooks",
  "apiVersion": "2021-03-08",
  "name": "[parameters('workbookName')]",
  "location": "[parameters('location')]",
  "properties": {
    "displayName": "自定义工作簿",
    "sharedType": "Private", // 根据需求选择对应共享范围
    "serializedData": "[parameters('workbookSerializedData')]"
    // 其他工作簿属性...
  }
}

3. 确保sharedType值不为空或null，根据实际场景选择合适的共享范围

社区相关案例 #

不少用户在通过ARM模板部署工作簿时遇到过相同问题，大多是因为从Azure门户导出模板时遗漏了该隐含字段，或手动编写模板时未注意到这个必填项。

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