다음을 통해 공유


Admin - Reports GetReportSubscriptionsAsAdmin

구독자 세부 정보와 함께 보고서 구독 목록을 반환합니다. 미리 보기 API 호출입니다.

사용 권한

  • 사용자는 관리자 권한(예: Office 365 전역 관리자 또는 Power BI 서비스 관리자)이 있거나 서비스 주체를 사용하여 인증해야 합니다.
  • 위임된 권한이 지원됩니다.

필수 범위

Tenant.Read.All 또는 Tenant.ReadWrite.All

제한 사항

시간당 최대 200개 요청.

GET https://api.powerbi.com/v1.0/myorg/admin/reports/{reportId}/subscriptions

URI 매개 변수

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

string

uuid

보고서 ID

응답

Name 형식 Description
200 OK

Subscriptions

정상

예제

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/reports/{reportId}/subscriptions

Sample Response

{
  "value": [
    {
      "id": "18b746fe-c6d5-4a00-9523-05dc91424274",
      "title": "TestReportSubscription-1",
      "artifactId": "7b71b90a-a333-4006-b12c-ef3d767fa4e9",
      "artifactDisplayName": "Customer Profitability Sample",
      "subArtifactDisplayName": "Team Scorecard",
      "artifactType": "Report",
      "isEnabled": true,
      "frequency": "Daily",
      "startDate": "10/13/2021 12:00:00 AM",
      "endDate": "10/13/2022 12:00:00 AM",
      "linkToContent": true,
      "previewImage": true,
      "attachmentFormat": "PNG",
      "users": [
        {
          "displayName": "John Nick",
          "emailAddress": "john@contoso.com",
          "identifier": "john@contoso.com",
          "graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
          "principalType": "User"
        }
      ]
    }
  ]
}

정의

Name Description
PrincipalType

보안 주체 유형

ServicePrincipalProfile

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

Subscription

Power BI 항목에 대한 전자 메일 구독(예: 보고서 또는 dashboard)

Subscriptions

Power BI 구독에 대한 OData 응답 래퍼

SubscriptionUser

Power BI 전자 메일 구독 사용자

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

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 구독 정보를 검색할 수 있습니다.

Subscriptions

Power BI 구독에 대한 OData 응답 래퍼

Name 형식 Description
odata.context

string

value

Subscription[]

Power BI 전자 메일 구독

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

사용자 유형입니다.