Admin - Users GetUserSubscriptionsAsAdmin
지정된 사용자의 구독 목록을 반환합니다. 미리 보기 API 호출입니다.
사용 권한
- 사용자에게 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있거나 서비스 주체를 사용하여 인증해야 합니다.
- 위임된 권한이 지원됩니다.
필수 범위
Tenant.Read.All 또는 Tenant.ReadWrite.All
제한 사항
시간당 최대 200개의 요청.
GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions
GET https://api.powerbi.com/v1.0/myorg/admin/users/{userId}/subscriptions?continuationToken={continuationToken}
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
user
|
path | True |
string |
사용자의 그래프 ID 또는 UPN(사용자 계정 이름) |
continuation
|
query |
string |
결과 집합의 다음 청크를 가져오는 데 필요한 토큰 |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
정상 |
예제
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/subscriptions
Sample Response
{
"subscriptionEntities": [
{
"id": "9225d0bc-9f5e-4819-a637-799c0c4fh3f1",
"title": "Team Scorecard-test",
"artifactId": "0b50f0bf-b22b-4685-83b9-b6d17f7f4e46",
"artifactDisplayName": "Customer Profitability Sample",
"subArtifactDisplayName": "Team Scorecard",
"artifactType": "Report",
"isEnabled": false,
"frequency": "Daily",
"startDate": "8/10/2021 12:00:00 AM",
"endDate": "8/10/2022 12:00:00 AM",
"linkToContent": false,
"previewImage": true,
"attachmentFormat": "PNG",
"users": []
}
],
"continuationUri": "https://api.powerbi.com/v1.0/myorg/admin/users/f089354e-8366-4e18-aea3-4cb4a3a50b48/subscriptions?continuationToken='LDEsMTAwMDAwLDA%3D'",
"continuationToken": "LDEsMTAwMDAwLDA%3D"
}
정의
Name | Description |
---|---|
Principal |
보안 주체 유형 |
Service |
Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다. |
Subscription |
Power BI 항목에 대한 전자 메일 구독(예: 보고서 또는 대시보드) |
Subscriptions |
사용자용 Power BI 구독에 대한 OData 응답 래퍼 |
Subscription |
Power BI 전자 메일 구독 사용자 |
PrincipalType
보안 주체 유형
Name | 형식 | Description |
---|---|---|
App |
string |
서비스 주체 유형 |
Group |
string |
그룹 보안 주체 유형 |
None |
string |
보안 주체 유형이 없습니다. 전체 조직 수준 액세스에 사용합니다. |
User |
string |
사용자 계정 유형 |
ServicePrincipalProfile
Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
Name | 형식 | Description |
---|---|---|
displayName |
string |
서비스 주체 프로필 이름 |
id |
string |
서비스 주체 프로필 ID |
Subscription
Power BI 항목에 대한 전자 메일 구독(예: 보고서 또는 대시보드)
Name | 형식 | Description |
---|---|---|
artifactDisplayName |
string |
구독된 Power BI 항목의 이름(예: 보고서 또는 대시보드) |
artifactId |
string |
구독된 Power BI 항목의 ID(예: 보고서 또는 대시보드) |
artifactType |
string |
Power BI 항목의 형식(예: |
attachmentFormat |
string |
전자 메일 구독에 첨부된 보고서의 형식 |
endDate |
string |
전자 메일 구독의 종료 날짜 및 시간 |
frequency |
string |
전자 메일 구독의 빈도 |
id |
string |
구독 ID |
isEnabled |
boolean |
전자 메일 구독을 사용할 수 있는지 여부 |
linkToContent |
boolean |
전자 메일 구독에 구독 링크가 있는지 여부 |
previewImage |
boolean |
보고서의 스크린샷이 전자 메일 구독에 있는지 여부 |
startDate |
string |
전자 메일 구독의 시작 날짜 및 시간 |
subArtifactDisplayName |
string |
구독된 Power BI 항목의 페이지 이름(보고서인 경우)입니다. |
title |
string |
앱 이름 |
users |
각 전자 메일 구독자의 세부 정보입니다. 사용자 구독 가져오기 관리 API 호출을 사용하는 경우 반환된 값은 빈 배열(null)입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독 가져오기 관리 또는 대시보드 구독 가져오기 관리 API 호출을 사용하여 Power BI 보고서 또는 대시보드에서 구독 정보를 검색할 수 있습니다. |
SubscriptionsByUserResponse
사용자용 Power BI 구독에 대한 OData 응답 래퍼
Name | 형식 | Description |
---|---|---|
continuationToken |
string |
결과 집합의 다음 청크를 가져오는 토큰 |
continuationUri |
string |
결과 집합의 다음 청크에 대한 URI |
odata.context |
string |
|
subscriptionEntities |
사용자에 대한 구독 |
SubscriptionUser
Power BI 전자 메일 구독 사용자
Name | 형식 | Description |
---|---|---|
displayName |
string |
보안 주체의 표시 이름 |
emailAddress |
string |
사용자의 이메일 주소입니다. |
graphId |
string |
Microsoft Graph의 보안 주체 식별자입니다. 관리 API에만 사용할 수 있습니다. |
identifier |
string |
보안 주체의 식별자 |
principalType |
보안 주체 유형 |
|
profile |
Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다. |
|
userType |
string |
사용자의 유형입니다. |