다음을 통해 공유


Datasets - Get Dataset In Group

지정된 작업 영역에서 지정된 데이터 세트를 반환합니다.

사용 권한

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

필수 범위

Dataset.ReadWrite.All 또는 Dataset.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/datasets/{datasetId}

URI 매개 변수

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

string

데이터 세트 ID

groupId
path True

string

uuid

작업 영역 ID

응답

Name 형식 Description
200 OK

Dataset

정상

예제

Example

Sample Request

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

Sample Response

{
  "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "name": "SalesMarketing",
  "addRowsAPIEnabled": false,
  "configuredBy": "john@contoso.com",
  "isRefreshable": true,
  "isEffectiveIdentityRequired": true,
  "isEffectiveIdentityRolesRequired": true,
  "isOnPremGatewayRequired": false,
  "targetStorageMode": "Abf"
}

정의

Name Description
Dataset

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

DatasetQueryScaleOutSettings

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

DatasetUser

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

DatasetUserAccessRight

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

DependentDataflow

Power BI 종속 데이터 흐름

Encryption

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

EncryptionStatus

데이터 세트 암호화 상태

PrincipalType

보안 주체 유형

ServicePrincipalProfile

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

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

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

PrincipalType

보안 주체 유형

Name 형식 Description
App

string

서비스 주체 유형

Group

string

그룹 보안 주체 유형

None

string

보안 주체 유형이 없습니다. 전체 organization 수준 액세스에 사용합니다.

User

string

사용자 계정 유형

ServicePrincipalProfile

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

Name 형식 Description
displayName

string

서비스 주체 프로필 이름

id

string

서비스 주체 프로필 ID