Share via


Admin - Apps GetAppsAsAdmin

organization 앱 목록을 반환합니다.

쿼리 매개 변수 $top 필요합니다.

사용 권한

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

서비스 기본 인증으로 실행하는 경우 앱에는 Azure Portal 설정된 Power BI에 대한 관리자 동의 필수 프리미션이 없어야 합니다.

필수 범위

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

표준 위임된 관리자 액세스 토큰을 통해 인증하는 경우에만 관련됩니다. 서비스 주체를 통한 인증을 사용할 때는 존재하지 않아야 합니다.

제한 사항

시간당 최대 200개의 요청.

GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top={$top}
GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top={$top}&$skip={$skip}

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
$top
query True

integer

요청된 앱 수입니다.

$skip
query

integer

건너뛸 숫자 항목입니다.

응답

Name 형식 Description
200 OK

AdminApps

정상

예제

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/apps?$top=10

Sample Response

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "description": "The finance app",
      "name": "Finance",
      "publishedBy": "Bill",
      "lastUpdate": "2019-01-13T09:46:53.094+02:00"
    },
    {
      "id": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "description": "The marketing app",
      "name": "Marketing",
      "publishedBy": "Ben",
      "lastUpdate": "2018-11-13T09:46:53.094+02:00"
    }
  ]
}

정의

Name Description
AdminApp
AdminApps

관리 API용 Power BI 설치된 앱 목록에 대한 OData 응답 래퍼

AdminApp

Name 형식 Description
description

string

앱 설명

id

string

앱 ID

lastUpdate

string

앱이 마지막으로 업데이트된 날짜 및 시간

name

string

앱 이름

publishedBy

string

앱 게시자

workspaceId

string

앱에 연결된 작업 영역

AdminApps

관리 API용 Power BI 설치된 앱 목록에 대한 OData 응답 래퍼

Name 형식 Description
odata.context

string

OData 컨텍스트

value

AdminApp[]

설치된 앱 목록