共用方式為

Reports - Clone Report

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

從 [我的工作區] 複製指定的報表。

  • 如果複製報表的數據集位於兩個不同的 工作區或 [我的工作區] 中，則會在報表工作區中建立共用數據集。
  • 複製時，具有 即時連線 的報表將會遺失該連線，而是直接系結至目標數據集。

權限

除非不適用需求，否則用戶必須具備下列所有專案：

  • 指定之報表的寫入許可權。
  • 如果使用 targetModelId 參數，則為目標數據集的建置許可權。

必要範圍

Content.Create

POST https://api.powerbi.com/v1.0/myorg/reports/{reportId}/Clone

URI 參數

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

string

uuid

報表標識碼

要求本文

名稱 必要 類型 Description
name True

string

新的報表名稱
targetModelId

string

選擇性。 用於指定目標相關聯數據集標識碼的參數。 如果未提供，新報表將會與源報表相同的數據集相關聯。
targetWorkspaceId

string

選擇性。 指定目標工作區識別碼的參數。 空的 GUID (00000000-0000-0000-0000-000000000000) 表示 [我的工作區]。 如果未提供此參數，新報表將會在與來源報表相同的工作區內複製。

回應

名稱 類型 Description
200 OK

Report

確定

範例

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Clone
Request Body
{
  "name": "New Report Name",
  "targetModelId": "8e4d5880-81d6-4804-ab97-054665050799",
  "targetWorkspaceId": "2f42a406-a075-4a15-bbf2-97ef958c94cb"
}

Sample Response

Status code:
200

定義

名稱 Description
CloneReportRequest

Power BI 複製報表要求
PrincipalType

主體類型
Report

Power BI 報表。 API 會傳回下列報表屬性清單的子集。 子集取決於呼叫的 API、呼叫端許可權，以及 Power BI 資料庫中數據的可用性。
ReportUser

報表的 Power BI 使用者存取權專案
ReportUserAccessRight

用戶對於報表的存取權 (許可權等級)

ServicePrincipalProfile

Power BI 服務 主體配置檔。 僅適用於 Power BI Embedded 多租用戶解決方案。
Subscription

Power BI 專案的電子郵件訂閱 (，例如報表或儀錶板)

SubscriptionUser

Power BI 電子郵件訂用帳戶使用者

CloneReportRequest

Power BI 複製報表要求

名稱 類型 Description
name

string

新的報表名稱
targetModelId

string

選擇性。 用於指定目標相關聯數據集標識碼的參數。 如果未提供，新報表將會與源報表相同的數據集相關聯。
targetWorkspaceId

string

選擇性。 指定目標工作區識別碼的參數。 空的 GUID (00000000-0000-0000-0000-000000000000) 表示 [我的工作區]。 如果未提供此參數，新報表將會在與來源報表相同的工作區內複製。

PrincipalType

主體類型

名稱 類型 Description
App

string

服務主體類型
Group

string

群組主體類型
None

string

沒有主體類型。 用於整個組織層級存取。
User

string

用戶主體類型

Report

Power BI 報表。 API 會傳回下列報表屬性清單的子集。 子集取決於呼叫的 API、呼叫端許可權，以及 Power BI 資料庫中數據的可用性。

名稱 類型 Description
appId

string

只有在報表屬於應用程式時，才會傳回應用程式標識碼
datasetId

string

報表的數據集標識碼
description

string

報表描述
embedUrl

string

報表的內嵌 URL
id

string

報表標識碼
isOwnedByMe

boolean

判斷報表是否由目前使用者建立。
name

string

報表的名稱
originalReportId

string

當工作區發佈為應用程式時的實際報表標識碼。
reportType enum:
  • PaginatedReport
  • PowerBIReport

報表類型
subscriptions

Subscription[]

(空白值) Power BI 專案的訂用帳戶詳細數據 (，例如報表或儀錶板) 。 這個屬性將會從即將發行的承載回應中移除。 您可以使用取得報表訂閱作為 #D3B75215F31354A2BB013C854243E6DD0 API 呼叫，來擷取 Power BI 報表的訂用帳戶資訊。
users

ReportUser[]

(空白值) Power BI 報表的使用者存取詳細數據。 這個屬性將會從即將發行的承載回應中移除。 您可以使用取得報表用戶作為 管理員 API 呼叫，或使用 參數來擷取 Power BI 報表的使用者資訊， 或 PostWorkspaceInfogetArtifactUsers API 呼叫。
webUrl

string

報表的Web URL

ReportUser

報表的 Power BI 使用者存取權專案

名稱 類型 Description
displayName

string

主體的顯示名稱
emailAddress

string

使用者的電子郵件地址
graphId

string

Microsoft Graph 中主體的標識碼。 僅適用於系統管理員 API。
identifier

string

主體的標識碼
principalType

PrincipalType

主體類型
profile

ServicePrincipalProfile

Power BI 服務 主體配置檔。 僅適用於 Power BI Embedded 多租用戶解決方案。
reportUserAccessRight

ReportUserAccessRight

用戶對於報表的存取權 (許可權等級)

userType

string

使用者的型別。

ReportUserAccessRight

用戶對於報表的存取權 (許可權等級)

名稱 類型 Description
None

string

報表中內容沒有許可權
Owner

string

授與報表中內容的讀取、寫入和重新共用存取權
Read

string

授與報表中內容的讀取許可權
ReadCopy

string

授與報表中內容的讀取和複製存取權
ReadReshare

string

授與讀取和重新共享報表中內容的存取權
ReadWrite

string

授與報表中內容的讀取和寫入存取權

ServicePrincipalProfile

Power BI 服務 主體配置檔。 僅適用於 Power BI Embedded 多租用戶解決方案。

名稱 類型 Description
displayName

string

服務主體配置檔名稱
id

string

服務主體配置檔識別碼

Subscription

Power BI 專案的電子郵件訂閱 (，例如報表或儀錶板)

名稱 類型 Description
artifactDisplayName

string

訂閱的Power BI專案名稱 (，例如報表或儀錶板)

artifactId

string

訂閱 Power BI 專案 (識別符，例如報表或儀錶板)

artifactType

string

Power BI 專案的類型 (例如 Report、 Dashboard或 Dataset)

attachmentFormat

string

電子郵件訂閱中附加的報表格式
endDate

string

電子郵件訂閱的結束日期和時間
frequency

string

電子郵件訂閱的頻率
id

string

訂用帳戶標識碼
isEnabled

boolean

是否啟用電子郵件訂閱
linkToContent

boolean

電子郵件訂閱中是否有訂用帳戶連結
previewImage

boolean

報表的螢幕快照是否存在於電子郵件訂閱中
startDate

string

電子郵件訂閱的開始日期和時間
subArtifactDisplayName

string

如果訂閱的Power BI專案是報表，則為頁面名稱。
title

string

應用程式名稱
users

SubscriptionUser[]

每個電子郵件訂閱者的詳細數據。 使用取得使用者訂用帳戶作為 管理員 API 呼叫時，傳回的值是空陣列 (null) 。 這個屬性將會從即將發行的承載回應中移除。 您可以使用取得報表訂閱作為 管理員 或取得儀錶板訂用帳戶作為 管理員 API 呼叫，來擷取 Power BI 報表或儀錶板上的訂用帳戶資訊。

SubscriptionUser

Power BI 電子郵件訂用帳戶使用者

名稱 類型 Description
displayName

string

主體的顯示名稱
emailAddress

string

使用者的電子郵件地址
graphId

string

Microsoft Graph 中主體的標識碼。 僅適用於系統管理員 API。
identifier

string

主體的標識碼
principalType

PrincipalType

主體類型
profile

ServicePrincipalProfile

Power BI 服務 主體配置檔。 僅適用於 Power BI Embedded 多租用戶解決方案。
userType

string

使用者的型別。