Dashboards - Add Dashboard In Group
지정된 작업 영역에 빈 대시보드를 새로 만듭니다.
권한
이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded
필수 범위
Content.Create
POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dashboardsURI 매개 변수
| Name | In(다음 안에) | 필수 | 형식 | Description |
|---|---|---|---|---|
|
group
|
path | True |
string (uuid) |
작업 영역 ID |
요청 본문
| Name | 필수 | 형식 | Description |
|---|---|---|---|
| name | True |
string |
새 대시보드의 이름 |
응답
| Name | 형식 | Description |
|---|---|---|
| 200 OK |
그래 |
예제
Example
샘플 요청
POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/dashboards{
"name": "SalesMarketing"
}샘플 응답
{
"id": "69ffaa6c-b36d-4d01-96f5-1ed67c64d4af",
"displayName": "SalesMarketing",
"embedUrl": "https://app.powerbi.com/dashboardEmbed?dashboardId=69ffaa6c-b36d-4d01-96f5-1ed67c64d4af&groupId=f089354e-8366-4e18-aea3-4cb4a3a50b48",
"isReadOnly": false
}정의
| Name | Description |
|---|---|
|
Add |
대시보드를 추가하기 위한 Power BI 요청 |
| Dashboard |
Power BI 대시보드. API는 다음 대시보드 속성 목록의 하위 집합을 반환합니다. 하위 집합은 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다. |
|
Dashboard |
대시보드에 대한 Power BI 사용자 액세스 권한 항목 |
|
Dashboard |
사용자가 대시보드에 대해 가지고 있는 액세스 권한(권한 수준) |
|
Principal |
보안 주체 형식 |
|
Service |
Power BI 서비스 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션 관련되어 있습니다. |
| Subscription |
Power BI 항목에 대한 전자 메일 구독(예: 보고서 또는 대시보드) |
|
Subscription |
Power BI 전자 메일 구독 사용자 |
AddDashboardRequest
대시보드를 추가하기 위한 Power BI 요청
| Name | 형식 | Description |
|---|---|---|
| name |
string |
새 대시보드의 이름 |
Dashboard
Power BI 대시보드. API는 다음 대시보드 속성 목록의 하위 집합을 반환합니다. 하위 집합은 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
| Name | 형식 | Description |
|---|---|---|
| appId |
string |
대시보드가 앱에 속하는 경우에만 반환되는 앱 ID |
| displayName |
string |
대시보드의 표시 이름 |
| embedUrl |
string |
대시보드의 포함 URL |
| id |
string (uuid) |
대시보드 ID |
| isReadOnly |
boolean |
대시보드가 읽기 전용인지 여부 |
| subscriptions |
(빈 값) Power BI 항목(예: 보고서 또는 대시보드)에 대한 구독 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독 가져오기를 관리자 API 호출로 사용하여 Power BI 보고서에 대한 구독 정보를 검색할 수 있습니다. |
|
| users |
(빈 값) 대시보드 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다.
대시보드 사용자를 관리자 API 호출로 가져오기 또는 매개 변수를 사용하여 |
|
| webUrl |
string |
대시보드의 웹 URL |
DashboardUser
대시보드에 대한 Power BI 사용자 액세스 권한 항목
DashboardUserAccessRight
사용자가 대시보드에 대해 가지고 있는 액세스 권한(권한 수준)
| 값 | Description |
|---|---|
| None |
대시보드의 콘텐츠에 대한 사용 권한 없음 |
| Owner |
보고서의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여 |
| Read |
대시보드의 콘텐츠에 대한 읽기 액세스 권한 부여 |
| ReadCopy |
대시보드의 콘텐츠에 대한 읽기 및 복사 액세스 권한 부여 |
| ReadReshare |
대시보드의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여 |
| ReadWrite |
대시보드의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여 |
PrincipalType
보안 주체 형식
| 값 | Description |
|---|---|
| App |
서비스 주체 유형 |
| Group |
그룹 보안 주체 유형 |
| None |
보안 주체 형식이 없습니다. 전체 조직 수준 액세스에 사용합니다. |
| User |
사용자 계정 유형 |
ServicePrincipalProfile
Power BI 서비스 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션 관련되어 있습니다.
| Name | 형식 | Description |
|---|---|---|
| displayName |
string |
서비스 주체 프로필 이름 |
| id |
string (uuid) |
서비스 주체 프로필 ID |
Subscription
Power BI 항목에 대한 전자 메일 구독(예: 보고서 또는 대시보드)
| Name | 형식 | Description |
|---|---|---|
| artifactDisplayName |
string |
구독된 Power BI 항목의 이름(예: 보고서 또는 대시보드) |
| artifactId |
string (uuid) |
구독된 Power BI 항목의 ID(예: 보고서 또는 대시보드) |
| artifactType |
string |
Power BI 항목의 형식(예: |
| 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 |
각 전자 메일 구독자의 세부 정보입니다. User Subscriptions As Admin API 호출을 사용하는 경우 반환된 값은 빈 배열(null)입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독을 관리자로 가져오기 사용하거나 대시보드 구독을 관리자로 API 호출을 사용하여 Power BI 보고서 또는 대시보드에서 구독 정보를 검색할 수 있습니다. |
SubscriptionUser
Power BI 전자 메일 구독 사용자