如何修正ADF中用服务主体调用PowerBI API禁用刷新计划的报错？

核心问题分析 #

1. 字段名错误：你误用了不存在的ScheduleNotifyOption字段，PowerBI API的通知选项字段实际为notifyOption。
2. 重复认证配置：Web Activity同时配置了手动Authorization头和ServicePrincipal认证，导致请求头冲突。
3. 服务主体限制：服务主体(App Only)无法接收邮件通知，必须显式将notifyOption设置为NoNotification，否则会触发Invalid NotifyOption错误。

具体修正步骤 #

1. 修正请求体字段 #

将Web Activity的body部分修改为：

"body": {
    "value": {
        "enabled": false,
        "notifyOption": "NoNotification"
    }
}

2. 移除重复的Authorization头配置 #

删除headers下的Authorization节点，因为已通过authentication配置的ServicePrincipal自动处理认证，无需手动添加令牌头。

修正后的完整Web Activity代码 #

{
    "name": "Disable dataset refresh",
    "type": "WebActivity",
    "dependsOn": [
        {
            "activity": "Takeover dataset",
            "dependencyConditions": [
                "Succeeded"
            ]
        }
    ],
    "policy": {
        "timeout": "0.00:10:00",
        "retry": 5,
        "retryIntervalInSeconds": 30,
        "secureOutput": false,
        "secureInput": false
    },
    "userProperties": [],
    "typeProperties": {
        "method": "PATCH",
        "url": {
            "value": "https://api.powerbi.com/v1.0/myorg/groups/@{pipeline().parameters.PBIWorkspaceId}/datasets/@{pipeline().parameters.PBIDatasetId}/refreshSchedule",
            "type": "Expression"
        },
        "body": {
            "value": {
                "enabled": false,
                "notifyOption": "NoNotification"
            }
        },
        "authentication": {
            "type": "ServicePrincipal",
            "userTenant": {
                "value": "@pipeline().globalParameters.TenantId",
                "type": "Expression"
            },
            "username": {
                "value": "@pipeline().parameters.SP_ClientId",
                "type": "Expression"
            },
            "resource": "https://analysis.windows.net/powerbi/api",
            "password": {
                "type": "AzureKeyVaultSecret",
                "store": {
                    "referenceName": "LS_KV",
                    "type": "LinkedServiceReference",
                    "parameters": {
                        "baseUrl": {
                            "value": "@pipeline().globalParameters.KeyVaultUrl",
                            "type": "Expression"
                        }
                    }
                },
                "secretName": "xxx"
            }
        }
    }
}

验证说明 #

• 确保服务主体拥有目标PowerBI工作区的管理员或成员权限，且已被添加为数据集所有者（Takeover dataset活动需完成权限配置）。
• 此修改既满足API"禁用刷新计划仅修改enabled状态"的核心要求，又适配了服务主体无法接收邮件通知的限制。

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