调用API/New-PowerBIReport上传PBIX至PowerBI工作区失败求助

问题描述 #

已通过服务主体成功获取PowerBI的Bearer令牌和工作区ID，但调用API上传PBIX时出现以下错误：

Invoke-RestMethod : {"error":{"code":"UnknownError","pbi.error":{"code":"UnknownError","parameters":{},"details":[],"exceptionCulprit":1}}}

同时使用New-PowerBIReport cmdlet时返回：

New-PowerBIReport : Operation returned an invalid status code 'BadRequest'

错误原因分析 #

你的代码存在几个关键问题：

• 令牌变量引用错误：$accessTokenkey是未定义的变量，Get-PowerBIAccessToken返回的是包含Token属性的对象，需调用$accessToken.Token获取实际令牌字符串。
• Content-Type头手动设置错误：使用Invoke-RestMethod的-InFile参数时，PowerShell会自动处理multipart/form-data编码，手动设置该头会导致请求格式异常。
• URL未编码：文件名包含空格（如test report.pbix），直接拼接进URL会触发请求格式错误，需对文件名进行URL编码。
• 权限缺失：服务主体需拥有目标工作区的成员/管理员权限，以及导入报表的权限。

修正后的API调用代码 #

# Set the workspace name and API endpoint
$pbixFilePath = "C:\temp\testworkspace\test report.pbix"
$workspaceName = "testworkspace"
$apiEndpoint = "https://api.powerbi.com/v1.0/myorg"

# Connect to Power BI using a service principal
$DeploymentPrincipalAppId = "1234"
$DeploymentPrincipalAppSecret = "1234"
$tenantID = "1234"

$credentials = New-Object System.Management.Automation.PSCredential ($DeploymentPrincipalAppId, (convertto-securestring $DeploymentPrincipalAppSecret -asplaintext -force))
Connect-PowerBIServiceAccount -ServicePrincipal -Credential $credentials -Tenant $tenantID

# Get an access token for the Power BI API
$accessToken = Get-PowerBIAccessToken
$bearerToken = $accessToken.Token # 获取实际令牌字符串

# Get the ID of the specified workspace
$workspace = Invoke-RestMethod -Method Get -Uri "$apiEndpoint/groups?`$filter=name eq '$workspaceName'" -Headers @{ "Authorization" = "Bearer $bearerToken" }
$workspaceId = $workspace.value.id

# 对文件名进行URL编码
$encodedFileName = [Uri]::EscapeDataString((Split-Path $pbixFilePath -Leaf))
$uploadUrl = "$apiEndpoint/groups/$workspaceId/imports?datasetDisplayName=$encodedFileName&nameConflict=Overwrite"

# 上传PBIX文件，不手动设置Content-Type
$headers = @{ "Authorization" = "Bearer $bearerToken" }
$response = Invoke-RestMethod -Method Post -Uri $uploadUrl -Headers $headers -InFile $pbixFilePath

New-PowerBIReport修复方案 #

如果使用cmdlet，确保参数正确且权限足够，示例代码：

# 连接PowerBI服务（已连接可跳过）
$credentials = New-Object System.Management.Automation.PSCredential ($DeploymentPrincipalAppId, (convertto-securestring $DeploymentPrincipalAppSecret -asplaintext -force))
Connect-PowerBIServiceAccount -ServicePrincipal -Credential $credentials -Tenant $tenantID

# 获取工作区ID
$workspace = Get-PowerBIWorkspace -Name $workspaceName

# 上传报表，注意文件名无空格或已处理，且服务主体有权限
New-PowerBIReport -Path $pbixFilePath -WorkspaceId $workspace.Id -Name (Split-Path $pbixFilePath -Leaf) -ConflictAction Overwrite

额外排查步骤 #

• 验证服务主体权限：进入PowerBI工作区设置，确认服务主体已被添加为成员或管理员。
• 检查PBIX文件完整性：确保文件未损坏，可手动导入PowerBI服务验证。
• 查看PowerBI审计日志：在PowerBI管理门户的审计日志中查看具体错误详情，定位问题。

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