Imports - Post Import

서비스:: Power BI REST APIs

API 버전:: v1.0

내 작업 영역 새 콘텐츠를 만듭니다.

이 API를 사용하는 예제는 큰 파일 가져오기 PowerShell 스크립트를 참조하세요.

비고

지원되는 콘텐츠:

Power BI .pbix 파일
JSON 파일(.json)
Excel 파일(.xlsx)
보고서 정의 언어 파일(.rdl)

파일을 가져오려면 요청 헤더에서 다중 파트/양식 데이터 콘텐츠 형식을 지정하고 요청 본문에 양식 데이터로 파일을 인코딩합니다.
페이지를 매긴 보고서(.rdl) 파일을 가져오려면 datasetDisplayName에 설명된 대로 지정한 paginatedReport.rdl이름에 .rdl 파일 확장명을 포함합니다. 파일 확장명은 datasetDisplayName 페이지를 매긴 보고서(.rdl 파일) 업로드를 다른 업로드와 구분하는 데 도움이 됩니다.
- C# SDK(NuGet 갤러리 | 페이지를 매긴 보고서(.rdl) 업로드용 Microsoft.PowerBI.Api .
비즈니스용 OneDrive에서 .xlsx 파일을 가져오려면 요청 헤더에 응용 프로그램/json 콘텐츠 형식을 포함합니다. 요청 본문의 .xlsx 파일 경로로 설정된 filePath 포함합니다.
크기가 1GB에서 10GB 사이인 큰 Power BI .pbix 파일을 가져오려면 임시 업로드 위치 만들기참조하세요. 프리미엄 용량 작업 영역에 대해서만 지원됩니다.
model.json 파일에서 데이터 흐름을 만들려면 datasetDisplayName설명한 대로 model.json설정합니다.

필수 범위

데이터셋.읽기쓰기.전체

제한점

서비스 주체가 있는 데이터 흐름은 지원되지 않습니다.
OneDrive에서 Power BI .pbix 파일 가져오기는 지원되지 않습니다.
보호된 민감도 레이블이 있는 파일 가져오기는 서비스 주체에 대해 지원되지 않습니다.

POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName={datasetDisplayName}

선택적 매개 변수:

POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName={datasetDisplayName}&nameConflict={nameConflict}&skipReport={skipReport}&overrideReportLabel={overrideReportLabel}&overrideModelLabel={overrideModelLabel}&subfolderObjectId={subfolderObjectId}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
datasetDisplayName	query	True	string	데이터 세트의 표시 이름에는 파일 확장명을 포함해야 합니다. 비즈니스용 OneDrive에서 가져올 때 지원되지 않습니다.
nameConflict	query		ImportConflictHandlerMode	이름이 같은 데이터 세트가 이미 있는 경우 수행할 작업을 지정합니다. 기본값은 `Ignore`입니다. RDL 파일 `Abort` 의 `Overwrite` 경우 지원되는 유일한 옵션이며 다른 옵션은 지원되지 않습니다.
overrideModelLabel	query		boolean	Power BI .pbix 파일을 다시 게시할 때 모델의 기존 레이블을 재정의할지 여부입니다. 서비스 기본값은 `true`.
overrideReportLabel	query		boolean	Power BI .pbix 파일을 다시 게시할 때 기존 보고서 레이블을 재정의할지 여부입니다. 서비스 기본값은 `true`.
skipReport	query		boolean	보고서 가져오기를 건너뛸지 여부입니다. 지정한 경우 값을 `true`합니다. Power BI .pbix 파일에 대해서만 지원합니다.
subfolderObjectId	query		string (uuid)	파일을 하위 폴더로 가져올 하위 폴더 ID입니다.

요청 본문

Name	형식	Description
connectionType	connectionType	비즈니스용 OneDrive 파일의 가져오기 연결 유형
filePath	string	가져올 비즈니스용 OneDrive Excel(.xlsx) 파일의 경로로, 절대적이거나 상대적일 수 있습니다. Power BI .pbix 파일은 지원되지 않습니다.
fileUrl	string	1GB에서 10GB 사이의 큰 Power BI .pbix 파일을 가져오는 데 사용되는 임시 Blob Storage의 공유 액세스 서명 URL입니다.

응답

Name	형식	Description
200 OK	Import	그래
202 Accepted	Import	수락됨

예제

Import dataflow example

Post import example

Post import with 'skipReport' example

Import dataflow example

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName=model.json&nameConflict=Abort

요청 본문

{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data name=model.json; filename=model.json Content-Type: application/json [Contents of Model JSON Encoded] --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

샘플 응답

상태 코드:: 202

{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Post import example

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName=MyReport&nameConflict=Ignore

요청 본문

{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

샘플 응답

상태 코드:: 202

{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

Post import with 'skipReport' example

샘플 요청

POST https://api.powerbi.com/v1.0/myorg/imports?datasetDisplayName=MyReport&nameConflict=Ignore&skipReport=True&overrideReportLabel=True&overrideModelLabel=True

요청 본문

{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

샘플 응답

상태 코드:: 202

{
  "id": "d02b8896-e247-4d83-ae5a-014028cb0665"
}

정의

Name	Description
connectionType	비즈니스용 OneDrive 파일의 가져오기 연결 유형
Dataset	Power BI 데이터 세트입니다. API는 다음 데이터 세트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
DatasetQueryScaleOutSettings	데이터 세트의 쿼리 스케일 아웃 설정
DatasetUser	데이터 세트에 대한 Power BI 사용자 액세스 권한 항목
DatasetUserAccessRight	사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)
DependentDataflow	Power BI 종속 데이터 흐름
Encryption	데이터 세트에 대한 암호화 정보
EncryptionStatus	데이터 세트 암호화 상태
Import	가져오기 개체
ImportConflictHandlerMode	이름이 같은 데이터 세트가 이미 있는 경우 수행할 작업을 지정합니다. 기본값은 `Ignore`입니다. RDL 파일 `Abort` 의 `Overwrite` 경우 지원되는 유일한 옵션이며 다른 옵션은 지원되지 않습니다.
ImportInfo	가져오기에 대한 정보
PrincipalType	보안 주체 형식
Report	Power BI 보고서입니다. API는 다음 보고서 속성 목록의 하위 집합을 반환합니다. 하위 집합은 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
ReportUser	보고서에 대한 Power BI 사용자 액세스 권한 항목
ReportUserAccessRight	사용자가 보고서에 대해 가지고 있는 액세스 권한(권한 수준)
ServicePrincipalProfile	Power BI 서비스 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션 관련되어 있습니다.
Subscription	Power BI 항목에 대한 전자 메일 구독(예: 보고서 또는 대시보드)
SubscriptionUser	Power BI 전자 메일 구독 사용자

connectionType

열거형

비즈니스용 OneDrive 파일의 가져오기 연결 유형

값	Description
import
connect

Dataset

Object

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

Name	형식	Description
ContentProviderType	string	무시해야 하는 사용되지 않는 속성입니다.
Encryption	Encryption	데이터 세트 암호화 정보입니다. `$expand` 지정한 경우에만 적용됩니다.
IsEffectiveIdentityRequired	boolean	데이터 세트에 유효한 ID가 필요한지 여부입니다. 이 ID는 GenerateToken API 호출로 보내야 합니다.
IsEffectiveIdentityRolesRequired	boolean	행 수준 보안이 Power BI .pbix 파일 내에 정의되어 있는지 여부입니다. 그렇다면 역할을 지정해야 합니다.
IsInPlaceSharingEnabled	boolean	자체 테넌트에서 사용할 외부 사용자와 데이터 세트를 공유할 수 있는지 여부
IsOnPremGatewayRequired	boolean	데이터 세트에 온-프레미스 데이터 게이트웨이가 필요한지 여부
IsRefreshable	boolean	이 필드는 데이터 세트가 최근에 새로 고쳐지거나 자동 새로 고침을 위해 구성되고 연결 모드가 특별히 '가져오기'로 설정된 경우 `true` 반환합니다. 이 값은 데이터 세트를 수동으로 새로 고치거나 자동 새로 고침을 위해 설정되었는지 여부에 관계없이 'DirectQuery' 및 'LiveConnection'과 같은 다른 연결 모드에 대한 `false` 반환합니다.
addRowsAPIEnabled	boolean	데이터 세트에서 새 행을 추가할 수 있는지 여부
configuredBy	string	데이터 세트 소유자
createReportEmbedURL	string	데이터 세트 만들기 보고서 포함 URL
createdDate	string (date-time)	데이터 세트 만들기 날짜 및 시간
description	string	데이터 세트 설명
id	string	데이터 세트 ID
name	string	데이터 세트 이름
qnaEmbedURL	string	데이터 세트 Q&포함 URL
queryScaleOutSettings	DatasetQueryScaleOutSettings	데이터 세트의 쿼리 스케일 아웃 설정
targetStorageMode	string	데이터 세트 스토리지 모드
upstreamDataflows	DependentDataflow[]	이 항목이 사용하는 모든 데이터 흐름 목록은
users	DatasetUser[]	(빈 값) 데이터 세트 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 데이터 세트 사용자를 관리자 API로 가져오기 또는 매개 변수와 함께 `getArtifactUsers` API를 사용하여 Power BI 항목(예: 보고서 또는 대시보드)에서 사용자 정보를 검색할 수 있습니다.
webUrl	string	데이터 세트의 웹 URL

DatasetQueryScaleOutSettings

Object

데이터 세트의 쿼리 스케일 아웃 설정

Name	형식	Description
autoSyncReadOnlyReplicas	boolean	데이터 세트가 읽기 전용 복제본을 자동으로 동기화하는지 여부
maxReadOnlyReplicas	integer minimum: -1 maximum: 64	데이터 세트의 최대 읽기 전용 복제본 수(0-64, 자동 복제본 수 -1)

DatasetUser

Object

데이터 세트에 대한 Power BI 사용자 액세스 권한 항목

Name	형식	Description
datasetUserAccessRight	DatasetUserAccessRight	사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리자 API에만 사용할 수 있습니다.
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 형식
profile	ServicePrincipalProfile	Power BI 서비스 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션 관련되어 있습니다.
userType	string	사용자의 유형입니다.

DatasetUserAccessRight

열거형

사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)

값	Description
None	데이터 세트의 콘텐츠에 대한 사용 권한을 제거합니다.
Read	데이터 세트의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadWrite	데이터 세트의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여
ReadReshare	데이터 세트의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadWriteReshare	데이터 세트의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
ReadExplore	데이터 세트의 콘텐츠에 대한 읽기 및 탐색 액세스 권한 부여
ReadReshareExplore	데이터 세트의 콘텐츠에 대한 읽기, 다시 공유 및 탐색 액세스 권한 부여
ReadWriteExplore	데이터 세트의 콘텐츠에 대한 읽기, 쓰기 및 탐색 액세스 권한 부여
ReadWriteReshareExplore	데이터 세트의 콘텐츠에 대한 읽기, 쓰기, 다시 공유 및 탐색 액세스 권한 부여

DependentDataflow

Object

Power BI 종속 데이터 흐름

Name	형식	Description
groupId	string	대상 그룹 ID
targetDataflowId	string	대상 데이터 흐름 ID

Encryption

Object

데이터 세트에 대한 암호화 정보

Name	형식	Description
EncryptionStatus	EncryptionStatus	데이터 세트 암호화 상태

EncryptionStatus

열거형

데이터 세트 암호화 상태

값	Description
Unknown	데이터 세트 손상으로 인해 암호화 상태를 알 수 없음
NotSupported	이 데이터 세트에 대해 암호화가 지원되지 않습니다.
InSyncWithWorkspace	암호화가 지원되며 암호화 설정과 동기화됩니다.
NotInSyncWithWorkspace	암호화가 지원되지만 암호화 설정과 동기화되지 않음

Import

Object

가져오기 개체

Name	형식	Description
createdDateTime	string (date-time)	만들기 날짜 및 시간 가져오기
datasets	Dataset[]	이 가져오기와 연결된 데이터 세트
id	string (uuid)	가져오기 ID
importState	enum: Failed Publishing Succeeded	업로드 가져오기 상태
name	string	가져오기 이름
reports	Report[]	이 가져오기와 연결된 보고서
updatedDateTime	string (date-time)	마지막 업데이트 날짜 및 시간 가져오기

ImportConflictHandlerMode

열거형

이름이 같은 데이터 세트가 이미 있는 경우 수행할 작업을 지정합니다. 기본값은 Ignore입니다. RDL 파일 Abort 의 Overwrite 경우 지원되는 유일한 옵션이며 다른 옵션은 지원되지 않습니다.

값	Description
Ignore	이름이 같은 데이터 세트가 이미 있는 경우 가져오기 작업에서 이름이 같은 새 데이터 세트를 만듭니다.
Abort	이름이 같은 데이터 세트가 이미 있는 경우 가져오기 작업이 취소됩니다.
Overwrite	이름이 같은 데이터 세트가 이미 있는 경우 가져오기 작업은 기존 데이터 세트를 새 데이터 세트로 바꿉니다. 충돌이 없거나 이름이 같은 기존 데이터 세트가 두 개 이상 있는 경우 가져오기 작업이 실패합니다.
CreateOrOverwrite	이름이 같은 데이터 세트가 이미 있는 경우 가져오기 작업은 기존 데이터 세트를 새 데이터 세트로 바꿉니다. 이름이 같은 기존 데이터 세트가 두 개 이상 있는 경우 가져오기 작업이 실패합니다.
GenerateUniqueName	이름이 같은 데이터 흐름이 이미 있는 경우 가져오기 작업은 새 데이터 흐름에 대한 새 고유 이름을 생성합니다.

ImportInfo

Object

가져오기에 대한 정보

Name	형식	Description
connectionType	connectionType	비즈니스용 OneDrive 파일의 가져오기 연결 유형
filePath	string	가져올 비즈니스용 OneDrive Excel(.xlsx) 파일의 경로로, 절대적이거나 상대적일 수 있습니다. Power BI .pbix 파일은 지원되지 않습니다.
fileUrl	string	1GB에서 10GB 사이의 큰 Power BI .pbix 파일을 가져오는 데 사용되는 임시 Blob Storage의 공유 액세스 서명 URL입니다.

PrincipalType

열거형

보안 주체 형식

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

Report

Object

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

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

ReportUser

Object

보고서에 대한 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

열거형

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

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

ServicePrincipalProfile

Object

Power BI 서비스 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션 관련되어 있습니다.

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

Subscription

Object

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

Name	형식	Description
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[]	각 전자 메일 구독자의 세부 정보입니다. User Subscriptions As Admin API 호출을 사용하는 경우 반환된 값은 빈 배열(null)입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독을 관리자로 가져오기 사용하거나 대시보드 구독을 관리자로 API 호출을 사용하여 Power BI 보고서 또는 대시보드에서 구독 정보를 검색할 수 있습니다.

SubscriptionUser

Object

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	사용자의 유형입니다.

다음을 통해 공유

Imports - Post Import

필수 범위

제한점

URI 매개 변수

요청 본문

응답

예제

Import dataflow example

샘플 요청

샘플 응답

Post import example

샘플 요청

샘플 응답

Post import with 'skipReport' example

샘플 요청

샘플 응답

정의

connectionType

Dataset

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DependentDataflow

Encryption

EncryptionStatus

Import

ImportConflictHandlerMode

ImportInfo

PrincipalType

Report

ReportUser

ReportUserAccessRight

ServicePrincipalProfile

Subscription

SubscriptionUser