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 매개 변수

Name	In(다음 안에)	필수	형식	Description
reportId	path	True	string uuid	보고서 ID

요청 본문

Name	필수	형식	Description
name	True	string	새 보고서 이름
targetModelId		string	선택 사항입니다. 대상 관련 데이터 세트 ID를 지정하기 위한 매개 변수입니다. 제공되지 않으면 새 보고서가 원본 보고서와 동일한 데이터 세트와 연결됩니다.
targetWorkspaceId		string	선택 사항입니다. 대상 작업 영역 ID를 지정하기 위한 매개 변수입니다. 빈 GUID(`00000000-0000-0000-0000-000000000000`)는 내 작업 영역을 나타냅니다. 이 매개 변수가 제공되지 않으면 새 보고서가 원본 보고서와 동일한 작업 영역 내에서 복제됩니다.

응답

Name	형식	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

정의

Name	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 항목에 대한 전자 메일 구독(예: 보고서 또는 dashboard)
SubscriptionUser	Power BI 전자 메일 구독 사용자

CloneReportRequest

Power BI 복제 보고서 요청

Name	형식	Description
name	string	새 보고서 이름
targetModelId	string	선택 사항입니다. 대상 관련 데이터 세트 ID를 지정하기 위한 매개 변수입니다. 제공되지 않으면 새 보고서가 원본 보고서와 동일한 데이터 세트와 연결됩니다.
targetWorkspaceId	string	선택 사항입니다. 대상 작업 영역 ID를 지정하기 위한 매개 변수입니다. 빈 GUID(`00000000-0000-0000-0000-000000000000`)는 내 작업 영역을 나타냅니다. 이 매개 변수가 제공되지 않으면 새 보고서가 원본 보고서와 동일한 작업 영역 내에서 복제됩니다.

PrincipalType

보안 주체 유형

Name	형식	Description
App	string	서비스 주체 유형
Group	string	그룹 보안 주체 유형
None	string	보안 주체 유형이 없습니다. 전체 organization 수준 액세스에 사용합니다.
User	string	사용자 계정 유형

Report

Power BI 보고서. API는 다음 보고서 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

Name	형식	Description
appId	string	보고서가 앱에 속하는 경우에만 반환되는 앱 ID입니다.
datasetId	string	보고서의 데이터 세트 ID
description	string	보고서 설명
embedUrl	string	보고서의 포함 URL
id	string	보고서 ID
isOwnedByMe	boolean	현재 사용자가 보고서를 만들었는지 확인합니다.
name	string	보고서의 이름
originalReportId	string	작업 영역이 앱으로 게시될 때의 실제 보고서 ID입니다.
reportType	enum: PaginatedReport PowerBIReport	보고서 유형
subscriptions	Subscription[]	(빈 값) Power BI 항목(예: 보고서 또는 dashboard)에 대한 구독 세부 정보입니다. 이 속성은 예정된 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독 가져오기를 관리 API 호출로 사용하여 Power BI 보고서에 대한 구독 정보를 검색할 수 있습니다.
users	ReportUser[]	(빈 값) Power BI 보고서에 대한 사용자 액세스 세부 정보입니다. 이 속성은 예정된 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 사용자 가져오기를 관리 API 호출로 사용하거나 매개 변수를 사용하여 PostWorkspaceInfo API 호출 `getArtifactUsers` 을 사용하여 Power BI 보고서에서 사용자 정보를 검색할 수 있습니다.
webUrl	string	보고서의 웹 URL

ReportUser

보고서에 대한 Power BI 사용자 액세스 권한 항목

Name	형식	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

사용자가 보고서에 대해 가지고 있는 액세스 권한(권한 수준)

Name	형식	Description
None	string	보고서의 콘텐츠에 대한 사용 권한 없음
Owner	string	보고서의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
Read	string	보고서의 콘텐츠에 대한 읽기 권한 부여
ReadCopy	string	보고서의 콘텐츠에 대한 읽기 및 복사 액세스 권한 부여
ReadReshare	string	보고서의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadWrite	string	보고서의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여

ServicePrincipalProfile

Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.

Name	형식	Description
displayName	string	서비스 주체 프로필 이름
id	string	서비스 주체 프로필 ID

Subscription

Power BI 항목에 대한 전자 메일 구독(예: 보고서 또는 dashboard)

Name	형식	Description
artifactDisplayName	string	구독된 Power BI 항목의 이름(예: 보고서 또는 dashboard)
artifactId	string	구독된 Power BI 항목의 ID(예: 보고서 또는 dashboard)
artifactType	string	Power BI 항목의 형식(예: `Report`, `Dashboard`또는 `Dataset`)입니다.
attachmentFormat	string	전자 메일 구독에 첨부된 보고서의 형식
endDate	string	전자 메일 구독의 종료 날짜 및 시간
frequency	string	전자 메일 구독의 빈도
id	string	구독 ID
isEnabled	boolean	전자 메일 구독을 사용할 수 있는지 여부
linkToContent	boolean	전자 메일 구독에 구독 링크가 있는지 여부
previewImage	boolean	보고서의 스크린샷이 전자 메일 구독에 있는지 여부
startDate	string	전자 메일 구독의 시작 날짜 및 시간
subArtifactDisplayName	string	구독된 Power BI 항목의 페이지 이름(보고서인 경우)입니다.
title	string	앱 이름
users	SubscriptionUser[]	각 전자 메일 구독자의 세부 정보입니다. 사용자 구독 가져오기 관리 API 호출을 사용하는 경우 반환된 값은 빈 배열(null)입니다. 이 속성은 예정된 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독 가져오기 관리 또는 대시보드 구독 가져오기 관리 API 호출을 사용하여 Power BI 보고서 또는 dashboard 구독 정보를 검색할 수 있습니다.

SubscriptionUser

Power BI 전자 메일 구독 사용자

Name	형식	Description
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리자 API에만 사용할 수 있습니다.
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다.
userType	string	사용자 유형입니다.