Admin - Datasets GetDatasetsAsAdmin
organization 대한 데이터 세트 목록을 반환합니다.
사용 권한
- 사용자는 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있거나 서비스 주체를 사용하여 인증해야 합니다.
- 위임된 권한이 지원됩니다.
서비스 기본 인증에서 실행하는 경우 앱에는 Azure Portal 설정된 Power BI에 대한 관리자 동의 필수 프리미션이 없어야 합니다.
필수 범위
Tenant.Read.All 또는 Tenant.ReadWrite.All
표준 위임된 관리자 액세스 토큰을 통해 인증하는 경우에만 관련이 있습니다. 서비스 주체를 통한 인증을 사용할 때는 없어야 합니다.
제한 사항
시간당 최대 50개 요청 또는 테넌트당 분당 5개의 요청.
GET https://api.powerbi.com/v1.0/myorg/admin/datasetsGET https://api.powerbi.com/v1.0/myorg/admin/datasets?$filter={$filter}&$top={$top}&$skip={$skip}URI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
$filter
|
query |
string |
부울 조건에 따라 결과를 필터링합니다. |
|
|
$skip
|
query |
integer int32 |
첫 번째 n 결과 건너뛰기 |
|
|
$top
|
query |
integer int32 |
첫 번째 n 결과만 반환합니다. |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
정상 |
예제
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/datasetsSample Response
{
"value": [
{
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"name": "SalesMarketing",
"addRowsAPIEnabled": false,
"configuredBy": "john@contoso.com",
"isRefreshable": true,
"isEffectiveIdentityRequired": false,
"isEffectiveIdentityRolesRequired": false,
"isOnPremGatewayRequired": false,
"isInPlaceSharingEnabled": false,
"workspaceId": "5c968528-70b6-4588-809f-ce811ffa5c23"
}
]
}정의
| Name | Description |
|---|---|
|
Admin |
관리 API에서 반환되는 Power BI 데이터 세트입니다. API는 다음 데이터 세트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다. |
|
Admin |
데이터 세트 odata 목록 래퍼 |
|
Dataset |
데이터 세트의 스케일 아웃 설정 쿼리 |
|
Dataset |
데이터 세트에 대한 Power BI 사용자 액세스 권한 항목 |
|
Dataset |
사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준) |
|
Dependent |
Power BI 종속 데이터 흐름 |
| Encryption |
데이터 세트에 대한 암호화 정보 |
|
Encryption |
데이터 세트 암호화 상태 |
|
Principal |
보안 주체 유형 |
|
Service |
Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션에만 관련됩니다. |
AdminDataset
관리 API에서 반환되는 Power BI 데이터 세트입니다. API는 다음 데이터 세트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
| Name | 형식 | Description |
|---|---|---|
| ContentProviderType |
string |
데이터 세트의 콘텐츠 공급자 형식 |
| CreateReportEmbedURL |
string |
데이터 세트 만들기 보고서 포함 URL |
| CreatedDate |
string |
데이터 세트 만들기 날짜 및 시간 |
| Encryption |
데이터 세트 암호화 정보. 가 지정된 경우에만 |
|
| 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 |
데이터 세트의 스케일 아웃 설정 쿼리 |
|
| targetStorageMode |
string |
데이터 세트 스토리지 모드 |
| upstreamDataflows |
이 항목에 따라 달라지는 모든 데이터 흐름 목록 |
|
| users |
(빈 값) 데이터 세트 사용자 액세스 세부 정보입니다. 이 속성은 예정된 릴리스에서 페이로드 응답에서 제거됩니다. 데이터 세트 사용자를 관리 API로 가져오기 또는 매개 변수와 함께 |
|
| webUrl |
string |
데이터 세트의 웹 URL |
| workspaceId |
string |
데이터 세트 작업 영역 ID입니다. 이 속성은 GetDatasetsAsAdmin에서만 반환됩니다. |
AdminDatasets
데이터 세트 odata 목록 래퍼
| Name | 형식 | Description |
|---|---|---|
| odata.context |
string |
OData 컨텍스트 |
| value |
데이터 세트 |
DatasetQueryScaleOutSettings
데이터 세트의 스케일 아웃 설정 쿼리
| Name | 형식 | Description |
|---|---|---|
| autoSyncReadOnlyReplicas |
boolean |
데이터 세트가 읽기 전용 복제본을 자동으로 동기화하는지 여부 |
| maxReadOnlyReplicas |
integer |
데이터 세트의 최대 읽기 전용 복제본 수(자동 복제본 수의 경우 0-64, -1) |
DatasetUser
데이터 세트에 대한 Power BI 사용자 액세스 권한 항목
| Name | 형식 | Description |
|---|---|---|
| datasetUserAccessRight |
사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준) |
|
| displayName |
string |
보안 주체의 표시 이름 |
| emailAddress |
string |
사용자의 이메일 주소입니다. |
| graphId |
string |
Microsoft Graph의 보안 주체 식별자입니다. 관리자 API에만 사용할 수 있습니다. |
| identifier |
string |
보안 주체의 식별자 |
| principalType |
보안 주체 유형 |
|
| profile |
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
데이터 세트 암호화 상태
| 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 |