Share via

Imports - Post Import In Group

  • 참조
Service:
Power BI REST APIs
API Version:
v1.0

지정된 작업 영역에 새 콘텐츠를 만듭니다.

참고

지원되는 콘텐츠:

  • Power BI .pbix 파일
  • JSON 파일(.json)
  • Excel 파일(.xlsx)
  • 보고서 정의 언어 파일 SQL Server(.rdl)
  • 파일을 가져오려면 요청 헤더에서 콘텐츠 형식 multipart/form-data 를 지정하고 파일을 요청 본문의 양식 데이터 로 인코딩합니다.
  • .rdl 파일을 가져오려면 URI 매개 변수에 설명된 대로 에서 지정한 datasetDisplayName이름에 파일 확장명을 포함합니다.
  • 비즈니스용 OneDrive .xlsx 파일을 가져오려면 요청 헤더에 콘텐츠 형식 application/json을 포함합니다. 요청 본문의 .xlsx 파일 경로로 설정된 ImportInfofilePath 를 포함합니다.
  • 크기가 1GB에서 10GB 사이인 큰 Power BI .pbix 파일을 가져오려면 그룹 내 임시 업로드 위치 Create및 대용량 파일 가져오기 PowerShell 스크립트를 참조하세요. 프리미엄 용량 작업 영역에 대해서만 지원됩니다.
  • model.json 파일에서 데이터 흐름을 만들려면 URI 매개 변수에 설명된 대로 를 model.json 설정합니다datasetDisplayName.

사용 권한

이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded 서비스 주체 프로필을 참조하세요.

필수 범위

Dataset.ReadWrite.All

제한 사항

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

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
groupId
 path True

string

uuid

작업 영역 ID
datasetDisplayName
 query True

string

데이터 세트의 표시 이름에는 파일 확장명을 포함해야 합니다. 비즈니스용 OneDrive 가져올 때 지원되지 않습니다. 데이터 흐름을 가져오거나 만들려면 이 매개 변수를 model.json 하드 코딩해야 합니다.
nameConflict
 query

ImportConflictHandlerMode

이름이 같은 데이터 세트가 이미 있는 경우 수행할 작업을 지정합니다. 기본값은 Ignore입니다. RDL 파일의 Abort 경우 및 Overwrite 는 유일하게 지원되는 옵션입니다. 데이터 흐름 model.json 파일의 경우 및 AbortGenerateUniqueName 는 유일하게 지원되는 옵션입니다.
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입니다.

요청 본문

Media Types: "application/json", "multipart/form-data"

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 model.json example
Post import example
Post import skip report example

Import dataflow model.json example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=model.json&nameConflict=Abort&skipReport=True
Request Body
{
  "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--"
}

Sample Response

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

Post import example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=MyReport&nameConflict=Ignore
Request Body
{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Sample Response

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

Post import skip report example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/cfafbeb1-8037-4d0c-896e-a46fb27ff229/imports?datasetDisplayName=MyReport&nameConflict=Ignore&skipReport=True&overrideReportLabel=True&overrideModelLabel=True
Request Body
{
  "value": "--f05e5244-f876-43b9-bc87-d71598f6b32a Content-Disposition: form-data AA...ZZ --f05e5244-f876-43b9-bc87-d71598f6b32a--"
}

Sample Response

Status code:
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 는 유일하게 지원되는 옵션입니다. 데이터 흐름 model.json 파일의 경우 및 AbortGenerateUniqueName 는 유일하게 지원되는 옵션입니다.
ImportInfo

가져오기에 대한 정보
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 전자 메일 구독 사용자

connectionType

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

Name 형식 Description
connect

string

import

string

Dataset

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

Name 형식 Description
ContentProviderType

string

데이터 세트의 콘텐츠 공급자 형식
CreateReportEmbedURL

string

데이터 세트 만들기 보고서 포함 URL
CreatedDate

string

데이터 세트 만들기 날짜 및 시간
Encryption

Encryption

데이터 세트 암호화 정보. 가 지정된 경우에만 $expand 적용됩니다.
IsEffectiveIdentityRequired

boolean

데이터 세트에 GenerateToken API 호출에서 보내야 하는 효과적인 ID가 필요한지 여부입니다.
IsEffectiveIdentityRolesRequired

boolean

Power BI .pbix 파일 내에서 행 수준 보안이 정의되는지 여부입니다. 그렇다면 역할을 지정해야 합니다.
IsInPlaceSharingEnabled

boolean

자체 테넌트에서 사용할 외부 사용자와 데이터 세트를 공유할 수 있는지 여부
IsOnPremGatewayRequired

boolean

데이터 세트에 온-프레미스 데이터 게이트웨이가 필요한지 여부
IsRefreshable

boolean

데이터 세트를 새로 고칠 수 있는지 여부입니다. Power BI 새로 고칠 수 있는 데이터 세트는 한 번 이상 새로 고쳐졌거나 유효한 새로 고침 일정이 있는 데이터 세트입니다.
QnaEmbedURL

string

데이터 세트 Q&포함 URL
addRowsAPIEnabled

boolean

데이터 세트가 새 행을 추가할 수 있는지 여부
configuredBy

string

데이터 세트 소유자
description

string

데이터 세트 설명
id

string

데이터 세트 ID
name

string

데이터 세트 이름
queryScaleOutSettings

DatasetQueryScaleOutSettings

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

string

데이터 세트 스토리지 모드
upstreamDataflows

DependentDataflow[]

이 항목에 따라 달라지는 모든 데이터 흐름 목록
users

DatasetUser[]

(빈 값) 데이터 세트 사용자 액세스 세부 정보입니다. 이 속성은 예정된 릴리스에서 페이로드 응답에서 제거됩니다. 데이터 세트 사용자를 관리 API로 가져오기 또는 매개 변수와 함께 getArtifactUsersPostWorkspaceInfo API를 사용하여 Power BI 항목(예: 보고서 또는 dashboard)에 대한 사용자 정보를 검색할 수 있습니다.
webUrl

string

데이터 세트의 웹 URL

DatasetQueryScaleOutSettings

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

Name 형식 Description
autoSyncReadOnlyReplicas

boolean

데이터 세트가 읽기 전용 복제본을 자동으로 동기화하는지 여부
maxReadOnlyReplicas

integer

데이터 세트의 최대 읽기 전용 복제본 수(자동 복제본 수의 경우 0-64, -1)

DatasetUser

데이터 세트에 대한 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

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

Name 형식 Description
None

string

데이터 세트의 콘텐츠에 대한 사용 권한을 제거합니다.
Read

string

데이터 세트의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadExplore

string

데이터 세트의 콘텐츠에 대한 읽기 및 탐색 액세스 권한 부여
ReadReshare

string

데이터 세트의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadReshareExplore

string

데이터 세트의 콘텐츠에 대한 읽기, 다시 공유 및 탐색 액세스 권한 부여
ReadWrite

string

데이터 세트의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여
ReadWriteExplore

string

데이터 세트의 콘텐츠에 대한 읽기, 쓰기 및 탐색 액세스 권한 부여
ReadWriteReshare

string

데이터 세트의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
ReadWriteReshareExplore

string

데이터 세트의 콘텐츠에 대한 읽기, 쓰기, 다시 공유 및 탐색 액세스 권한 부여

DependentDataflow

Power BI 종속 데이터 흐름

Name 형식 Description
groupId

string

대상 그룹 ID
targetDataflowId

string

대상 데이터 흐름 ID

Encryption

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

Name 형식 Description
EncryptionStatus

EncryptionStatus

데이터 세트 암호화 상태

EncryptionStatus

데이터 세트 암호화 상태

Name 형식 Description
InSyncWithWorkspace

string

암호화가 지원되며 암호화 설정과 동기화됩니다.
NotInSyncWithWorkspace

string

암호화가 지원되지만 암호화 설정과 동기화되지 않음
NotSupported

string

이 데이터 세트에 대해 암호화가 지원되지 않습니다.
Unknown

string

데이터 세트 손상으로 인해 암호화 상태 알 수 없음

Import

가져오기 개체

Name 형식 Description
createdDateTime

string

가져오기 만들기 날짜 및 시간
datasets

Dataset[]

이 가져오기와 연결된 데이터 세트
id

string

가져오기 ID
importState enum:
  • Failed
  • Publishing
  • Succeeded

가져오기 업로드 상태
name

string

가져오기 이름
reports

Report[]

이 가져오기와 연결된 보고서
updatedDateTime

string

마지막 업데이트 날짜 및 시간 가져오기

ImportConflictHandlerMode

이름이 같은 데이터 세트가 이미 있는 경우 수행할 작업을 지정합니다. 기본값은 Ignore입니다. RDL 파일 Abort 의 경우 및 Overwrite 는 유일하게 지원되는 옵션입니다. 데이터 흐름 model.json 파일의 경우 및 AbortGenerateUniqueName 는 유일하게 지원되는 옵션입니다.

Name 형식 Description
Abort

string

이름이 같은 데이터 세트 또는 데이터 흐름이 이미 있는 경우 가져오기 작업이 취소됩니다.
CreateOrOverwrite

string

이름이 같은 데이터 세트가 이미 있는 경우 가져오기 작업은 기존 데이터 세트를 새 데이터 세트로 바꿉니다. 이름이 같은 기존 데이터 세트가 두 개 이상 있는 경우 가져오기 작업이 실패합니다.
GenerateUniqueName

string

이름이 같은 데이터 흐름이 이미 있는 경우 가져오기 작업은 새 데이터 흐름에 대한 새 고유 이름을 생성합니다.
Ignore

string

이름이 같은 데이터 세트가 이미 있는 경우 가져오기 작업은 동일한 이름의 새 데이터 세트를 만듭니다.
Overwrite

string

이름이 같은 데이터 세트가 이미 있는 경우 가져오기 작업은 기존 데이터 세트를 새 데이터 세트로 바꿉니다. 충돌이 없거나 이름이 같은 기존 데이터 세트가 두 개 이상 있는 경우 가져오기 작업이 실패합니다.

ImportInfo

가져오기에 대한 정보

Name 형식 Description
connectionType

connectionType

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

string

가져올 비즈니스용 OneDrive Excel(.xlsx) 파일의 경로로, 절대 또는 상대 파일일 수 있습니다. Power BI .pbix 파일은 지원되지 않습니다.
fileUrl

string

크기가 1GB에서 10GB 사이인 대규모 Power BI .pbix 파일을 가져오는 데 사용되는 임시 Blob Storage의 공유 액세스 서명 URL입니다.

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

사용자의 유형입니다.