共用方式為

Admin - WorkspaceInfo GetScanStatus

  • 參考
Service:
Power BI REST APIs
API Version:
v1.0

取得指定掃描的掃描狀態。

權限

使用者必須具有系統管理員許可權 (，例如 Microsoft 365 全域管理員或 Power BI 服務管理員) 或使用服務主體進行驗證。

在服務主體驗證下執行時，應用程式不得在Azure 入口網站中設定 Power BI 的任何系統管理員同意許可權。

必要範圍

Tenant.Read.All 或 Tenant.ReadWrite.All

只有在透過標準委派的系統管理員存取權杖進行驗證時才相關。 使用透過服務主體進行驗證時，不得存在。

限制

每小時最多 10，000 個要求。 

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanStatus/{scanId}

URI 參數

名稱 位於 必要 類型 Description
scanId
 path True

string

uuid

掃描識別碼，包含在來自工作區或管理員 - WorkspaceInfo PostWorkspaceInfo API 呼叫觸發掃描的回應中。

回應

名稱 類型 Description
200 OK

ScanRequest

[確定]

範例

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/workspaces/scanStatus/e7d03602-4873-4760-b37e-1563ef5358e3

Sample Response

Status code:
200 
{
  "id": "e7d03602-4873-4760-b37e-1563ef5358e3",
  "createdDateTime": "2020-06-15T16:46:28.0487687Z",
  "status": "Succeeded"
}

定義

名稱 Description
PowerBIApiErrorResponseDetail

Power BI 錯誤回應的詳細資訊
ScanRequest

掃描要求

PowerBIApiErrorResponseDetail

Power BI 錯誤回應的詳細資訊

名稱 類型 Description
code

string

錯誤碼
message

string

錯誤訊息。
target

string

錯誤目標

ScanRequest

掃描要求

名稱 類型 Description
createdDateTime

string

掃描建立日期和時間
error

PowerBIApiErrorResponseDetail

如果有任何) ，掃描錯誤 (
id

string

掃描識別碼
status

string

掃描狀態