Reports - Clone Report In Group

サービス:

Power BI REST APIs

API バージョン:

v1.0

指定したワークスペースから指定したレポートを複製します。

• 複製されたレポートのデータセットが 2 つの異なるワークスペースまたは [マイ ワークスペース に存在する場合は、レポートのワークスペースに共有データセットが作成されます。
• 複製すると、ライブ接続 を持つレポートはその接続を失い、代わりにターゲット データセットへの直接バインドを持つことになります。

権限

• 要件が適用されない場合を除き、ユーザーは次のすべてを持っている必要があります。

  • 指定したレポートに対する書き込み アクセス許可。
  • targetModelId パラメーターを使用する場合は、ターゲット データセットに対するビルド アクセス許可が必要です。

• この API 呼び出しは、サービス プリンシパル プロファイルによって呼び出すことができます。 詳細については、「Power BI Embeddedでのサービス プリンシパル プロファイルの 」を参照してください。

必要なスコープ

Content.Create

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

URI パラメーター

名前	/	必須	型	説明
groupId	path	True	string (uuid)	ワークスペース ID
reportId	path	True	string (uuid)	レポート ID

要求本文

名前	必須	型	説明
name	True	string	新しいレポート名
targetModelId		string	任意 ターゲットに関連付けられたデータセット ID を指定するためのパラメーター。 指定しない場合、新しいレポートはソース レポートと同じデータセットに関連付けられます。
targetWorkspaceId		string (uuid)	任意 ターゲット ワークスペース ID を指定するためのパラメーター。 空の GUID (00000000-0000-0000-0000-000000000000) は、[マイ ワークスペース] 示します。 このパラメーターを指定しない場合、新しいレポートはソース レポートと同じワークスペース内に複製されます。

応答

名前	型	説明
200 OK	Report	わかりました

例

Example

要求のサンプル

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Clone

要求本文

{
  "name": "New Report Name",
  "targetModelId": "8e4d5880-81d6-4804-ab97-054665050799",
  "targetWorkspaceId": "2f42a406-a075-4a15-bbf2-97ef958c94cb"
}

応答のサンプル

状態コード:

200

定義

名前	説明
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

Object

Power BI クローン レポート要求

名前	型	説明
name	string	新しいレポート名
targetModelId	string	任意 ターゲットに関連付けられたデータセット ID を指定するためのパラメーター。 指定しない場合、新しいレポートはソース レポートと同じデータセットに関連付けられます。
targetWorkspaceId	string (uuid)	任意 ターゲット ワークスペース ID を指定するためのパラメーター。 空の GUID (00000000-0000-0000-0000-000000000000) は、[マイ ワークスペース] 示します。 このパラメーターを指定しない場合、新しいレポートはソース レポートと同じワークスペース内に複製されます。

PrincipalType

列挙

プリンシパルの種類

値	説明
App	サービス プリンシパルの種類
Group	グループ プリンシパルの種類
None	プリンシパルの種類はありません。 組織全体レベルのアクセスに使用します。
User	ユーザー プリンシパルの種類

Report

Object

Power BI レポート。 この API は、次のレポート プロパティの一覧のサブセットを返します。 サブセットは、呼び出された API、呼び出し元のアクセス許可、および Power BI データベース内のデータの可用性に依存します。

名前	型	説明
appId	string	レポートがアプリに属している場合にのみ返されるアプリ ID
datasetId	string	レポートのデータセット ID
description	string	レポートの説明
embedUrl	string	レポートの埋め込み URL
id	string (uuid)	レポート ID
isOwnedByMe	boolean	現在のユーザーがレポートのコピーを変更または作成できるかどうかを示します。
name	string	レポートの名前。 アプリ レポートはプレフィックス [App] で始まります。
originalReportId	string (uuid)	ワークスペースがアプリとして発行されたときの実際のレポート ID。
reportType	enum: PaginatedReport PowerBIReport	レポートの種類
subscriptions	Subscription[]	(空の値)Power BI アイテム (レポートやダッシュボードなど) のサブスクリプションの詳細。 このプロパティは、今後のリリースでペイロードの応答から削除されます。 Power BI レポートのサブスクリプション情報を取得するには、レポート サブスクリプションを管理者として取得 API 呼び出しを使用します。
users	ReportUser[]	(空の値)Power BI レポートのユーザー アクセスの詳細。 このプロパティは、今後のリリースでペイロードの応答から削除されます。 Power BI レポートのユーザー情報を取得するには、Admin API 呼び出しとしてレポート ユーザーを取得するか、 パラメーターを使用した getArtifactUsers API 呼び出しを使用します。
webUrl	string	レポートの Web URL

ReportUser

Object

レポートの Power BI ユーザー アクセス権エントリ

名前	型	説明
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

列挙

ユーザーがレポートに対して持っているアクセス権 (アクセス許可レベル)

値	説明
None	レポート内のコンテンツに対するアクセス許可がない
Owner	レポート内のコンテンツへの読み取り、書き込み、および再共有アクセスを許可します
Read	レポート内のコンテンツへの読み取りアクセス権を付与します
ReadCopy	レポート内のコンテンツへの読み取りとコピーのアクセス権を付与します
ReadReshare	レポート内のコンテンツへの読み取りと再共有のアクセス権を付与します
ReadWrite	レポート内のコンテンツに対する読み取りと書き込みのアクセス権を付与します

ServicePrincipalProfile

Object

Power BI サービス プリンシパル プロファイル。 Power BI Embedded マルチテナント ソリューションにのみ関連します。

名前	型	説明
displayName	string	サービス プリンシパル プロファイル名
id	string (uuid)	サービス プリンシパル プロファイル ID

Subscription

Object

Power BI アイテムのメール サブスクリプション (レポートやダッシュボードなど)

名前	型	説明
artifactDisplayName	string	サブスクライブされている Power BI アイテムの名前 (レポートやダッシュボードなど)
artifactId	string (uuid)	サブスクライブした Power BI アイテムの ID (レポートやダッシュボードなど)
artifactType	string	Power BI 項目の種類 (Report、Dashboard、Datasetなど)
attachmentFormat	string	電子メール サブスクリプションに添付されているレポートの形式
endDate	string (date-time)	電子メール サブスクリプションの終了日時
frequency	string	電子メール サブスクリプションの頻度
id	string (uuid)	サブスクリプション ID
isEnabled	boolean	電子メール サブスクリプションが有効になっているかどうか
linkToContent	boolean	電子メール サブスクリプションにサブスクリプション リンクが存在するかどうか
previewImage	boolean	レポートのスクリーンショットが電子メール サブスクリプションに存在するかどうか
startDate	string (date-time)	電子メール サブスクリプションの開始日時
subArtifactDisplayName	string	サブスクライブした Power BI アイテムのページ名 (レポートの場合)。
title	string	アプリ名
users	SubscriptionUser[]	各メール サブスクライバーの詳細。 Get User Subscriptions As Admin API 呼び出しを使用する場合、返される値は空の配列 (null) です。 このプロパティは、今後のリリースでペイロードの応答から削除されます。 Power BI レポートまたはダッシュボードでサブスクリプション情報を取得するには、[レポート サブスクリプションを管理者として取得] を使用するか、[ダッシュボード サブスクリプションを管理者として取得] API 呼び出しを します。

SubscriptionUser

Object

Power BI メール サブスクリプション ユーザー

名前	型	説明
displayName	string	プリンシパルの表示名
emailAddress	string	ユーザーのメール アドレス
graphId	string	Microsoft Graph のプリンシパルの識別子。 管理者 API でのみ使用できます。
identifier	string	プリンシパルの識別子
principalType	PrincipalType	プリンシパルの種類
profile	ServicePrincipalProfile	Power BI サービス プリンシパル プロファイル。 Power BI Embedded マルチテナント ソリューションにのみ関連します。
userType	string	ユーザーの種類。