Admin - Groups GetGroupsAsAdmin

참조

Service:: Power BI REST APIs

API Version:: v1.0

organization 대한 작업 영역 목록을 반환합니다.

사용 권한

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

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

필수 범위

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

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

제한 사항

시간당 최대 50개 요청 또는 테넌트당 분당 15개의 요청. 또한 이 호출은 Power BI 서비스 부정적인 영향을 방지하기 위해 30초 후에 시간 초과됩니다.

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

With optional parameters:

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
$top	query	True	integer int32	첫 번째 n 결과만 반환합니다. 이 매개 변수는 필수이며 1-5000 범위여야 합니다.
$expand	query		string	응답에서 인라인으로 확장되는 쉼표로 구분된 데이터 형식 목록을 허용합니다. , , `reports`, `dashboards`, `datasetsdataflows`및 `workbooks`를 지원합니다`users`.
$filter	query		string	부울 조건에 따라 결과를 필터링합니다.
$skip	query		integer int32	첫 번째 n개의 결과를 건너뜁니다. 맨 위와 함께 를 사용하여 처음 5000개 이후의 결과를 가져옵니다.

응답

Name	형식	Description
200 OK	AdminGroups	정상

예제

Get deleted workspaces example.

Get orphaned workspaces example.

Get workspaces with their 'dashboards' expanded example

Get workspaces with their 'datasets' expanded example

Get workspaces with their 'datasets' expanded example.

Get workspaces with their 'reports' expanded example

Get workspaces with their 'users' expanded example.

Get workspaces with their 'workbooks' expanded example

Get deleted workspaces example.

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$filter=state eq 'Deleted'&$top=100

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "Sample Group 2",
      "description": "Deleted sample group",
      "type": "Workspace",
      "state": "Deleted"
    }
  ]
}

Get orphaned workspaces example.

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=users&$filter=(not users/any()) or (not users/any(u: u/groupUserAccessRight eq Microsoft.PowerBI.ServiceContracts.Api.GroupUserAccessRight'Admin'))&$top=100

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "d5caa808-8c91-400a-911d-06af08dbcc31",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "Orphaned Group",
      "description": "Sample orphan group",
      "type": "Workspace",
      "state": "Active",
      "hasWorkspaceLevelSettings": false,
      "users": []
    }
  ]
}

Get workspaces with their 'dashboards' expanded example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=dashboards&$top=100

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "94E57E92-CEE2-486D-8CC8-218C97200579",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "capacityMigrationStatus": "Migrated",
      "description": "shorter description",
      "type": "Workspace",
      "state": "Removing",
      "name": "a",
      "hasWorkspaceLevelSettings": false,
      "dashboards": [
        {
          "id": "4668133c-ae3f-42fb-ad7c-214a8623280c",
          "displayName": "SQlAzure-Refresh.pbix",
          "isReadOnly": false
        },
        {
          "id": "a8f18ca7-63e8-4220-bc1c-f576ec180b98",
          "displayName": "cdvc",
          "isReadOnly": false
        }
      ]
    }
  ]
}

Get workspaces with their 'datasets' expanded example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=datasets&$top=100

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "94E57E92-CEE2-486D-8CC8-218C97200579",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "capacityMigrationStatus": "Migrated",
      "description": "shorter description",
      "type": "Workspace",
      "state": "Removing",
      "name": "a",
      "hasWorkspaceLevelSettings": false,
      "datasets": [
        {
          "id": "8ce96c50-85a0-4db3-85c6-7ccc3ed46523",
          "name": "SQlAzure-Refresh",
          "addRowsAPIEnabled": false,
          "configuredBy": "admin@granularcontrols.ccsctp.net",
          "isRefreshable": true,
          "isEffectiveIdentityRequired": false,
          "isEffectiveIdentityRolesRequired": false,
          "isOnPremGatewayRequired": false,
          "targetStorageMode": "Abf",
          "createdDate": "2019-04-30T21:35:15.867-07:00",
          "ContentProviderType": "PbixInImportMode",
          "isInPlaceSharingEnabled": false
        },
        {
          "id": "7d6a4f72-1906-4e08-a469-bd6bc1ab7b69",
          "name": "NESGames",
          "addRowsAPIEnabled": false,
          "configuredBy": "admin@granularcontrols.ccsctp.net",
          "isRefreshable": true,
          "isEffectiveIdentityRequired": false,
          "isEffectiveIdentityRolesRequired": false,
          "isOnPremGatewayRequired": false,
          "targetStorageMode": "Abf",
          "createdDate": "2019-04-30T21:35:15.867-07:00",
          "ContentProviderType": "PbixInImportMode",
          "isInPlaceSharingEnabled": false
        }
      ]
    }
  ]
}

Get workspaces with their 'datasets' expanded example.

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=datasets

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "e380d1d0-1fa6-460b-9a90-1a5c6b02414c",
      "isReadOnly": false,
      "isOnDedicatedCapacity": true,
      "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "defaultDatasetStorageFormat": "Small",
      "name": "Sample Group 1",
      "description": "Sample group",
      "type": "Workspace",
      "state": "Active",
      "hasWorkspaceLevelSettings": true,
      "datasets": [
        {
          "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
          "name": "SalesMarketing",
          "addRowsAPIEnabled": false,
          "configuredBy": "john@contoso.com",
          "isRefreshable": true,
          "isEffectiveIdentityRequired": false,
          "isEffectiveIdentityRolesRequired": false,
          "isOnPremGatewayRequired": false,
          "isInPlaceSharingEnabled": false,
          "encryption": {
            "id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
            "encryptionStatus": "InSyncWithWorkspace"
          }
        }
      ]
    },
    {
      "id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "Sample Group 2",
      "description": "Deleted sample group",
      "type": "Workspace",
      "state": "Deleted",
      "datasets": []
    }
  ]
}

Get workspaces with their 'reports' expanded example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=reports&$top=100

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "EC1EE11F-845D-495E-82A3-9DAC2072305A",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "capacityMigrationStatus": "Migrated",
      "description": "cvcv",
      "type": "Workspace",
      "state": "Active",
      "name": "WSv2Test12",
      "hasWorkspaceLevelSettings": true,
      "reports": []
    },
    {
      "id": "94E57E92-CEE2-486D-8CC8-218C97200579",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "capacityMigrationStatus": "Migrated",
      "description": "shorter description",
      "type": "Workspace",
      "state": "Removing",
      "name": "a",
      "hasWorkspaceLevelSettings": false,
      "reports": [
        {
          "id": "5DBA60B0-D9A7-42AE-B12C-6D9D51E7739A",
          "reportType": "PowerBIReport",
          "name": "SQlAzure-Refresh",
          "datasetId": "8ce96c50-85a0-4db3-85c6-7ccc3ed46523"
        },
        {
          "id": "197E5C3C-D2F3-42D8-A536-875FB6D7D48C",
          "reportType": "PowerBIReport",
          "name": "NESGames",
          "datasetId": "7d6a4f72-1906-4e08-a469-bd6bc1ab7b69"
        }
      ]
    }
  ]
}

Get workspaces with their 'users' expanded example.

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=users&$top=100

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "e380d1d0-1fa6-460b-9a90-1a5c6b02414c",
      "isReadOnly": false,
      "isOnDedicatedCapacity": true,
      "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "defaultDatasetStorageFormat": "Small",
      "name": "Sample Group 1",
      "description": "Sample group",
      "type": "Workspace",
      "state": "Active",
      "hasWorkspaceLevelSettings": false,
      "users": [
        {
          "emailAddress": "john@contoso.com",
          "groupUserAccessRight": "Admin"
        }
      ]
    },
    {
      "id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "Sample Group 2",
      "description": "Deleted sample group",
      "type": "Workspace",
      "state": "Deleted",
      "users": []
    }
  ]
}

Get workspaces with their 'workbooks' expanded example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=workbooks&$top=100

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "94E57E92-CEE2-486D-8CC8-218C97200579",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "description": "shorter description",
      "type": "Workspace",
      "state": "Removing",
      "hasWorkspaceLevelSettings": false,
      "name": "a",
      "workbooks": [
        {
          "name": "My Excel sheet",
          "datasetId": "8ce96c50-85a0-4db3-85c6-7ccc3ed46523"
        }
      ]
    }
  ]
}

정의

Name	Description
AdminDashboard	관리 API에서 반환된 Power BI dashboard. API는 다음 dashboard 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
AdminDataflow	관리 API에서 반환된 데이터 흐름의 메타데이터입니다. 다음은 데이터 흐름에 대해 반환될 수 있는 속성 목록입니다. 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 속성의 하위 집합만 반환됩니다.
AdminDataset	관리 API에서 반환된 Power BI 데이터 세트입니다. API는 다음 데이터 세트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
AdminGroup	관리자 API에서 반환된 Power BI 그룹
AdminGroups	관리 API에서 반환된 Power BI 그룹 목록에 대한 OData 응답 래퍼
AdminReport	관리 API에서 반환된 Power BI 보고서입니다. API는 다음 보고서 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.
AdminTile	관리 API에서 반환된 Power BI 타일입니다.
AzureResource	Log Analytics 작업 영역과 같은 사용자 소유 Azure 리소스를 자세히 설명하는 응답입니다.
DashboardUser	Dashboard 대한 Power BI 사용자 액세스 권한 항목
DashboardUserAccessRight	사용자가 dashboard 대한 액세스 권한(권한 수준)
DataflowUser	데이터 흐름에 대한 Power BI 사용자 액세스 권한 항목
DataflowUserAccessRight	사용자가 데이터 흐름에 대해 갖는 액세스 권한(권한 수준)
DatasetQueryScaleOutSettings	데이터 세트의 스케일 아웃 설정 쿼리
DatasetUser	데이터 세트에 대한 Power BI 사용자 액세스 권한 항목
DatasetUserAccessRight	사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)
DefaultDatasetStorageFormat	그룹의 기본 데이터 세트 스토리지 형식
DependentDataflow	Power BI 종속 데이터 흐름
Encryption	데이터 세트에 대한 암호화 정보
EncryptionStatus	데이터 세트 암호화 상태
GroupType	그룹 유형
GroupUser	작업 영역에 액세스할 수 있는 Power BI 사용자
GroupUserAccessRight	사용자가 작업 영역에 대해 가지고 있는 액세스 권한(권한 수준)
PrincipalType	보안 주체 유형
ReportUser	보고서에 대한 Power BI 사용자 액세스 권한 항목
ReportUserAccessRight	사용자가 보고서에 대해 가지고 있는 액세스 권한(권한 수준)
ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
Subscription	Power BI 항목에 대한 전자 메일 구독(예: 보고서 또는 dashboard)
SubscriptionUser	Power BI 전자 메일 구독 사용자
Workbook	Power BI 통합 문서

AdminDashboard

관리 API에서 반환된 Power BI dashboard. API는 다음 dashboard 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

Name	형식	Description
appId	string	dashboard 앱에 속하는 경우에만 반환되는 앱 ID입니다.
displayName	string	dashboard 표시 이름
embedUrl	string	dashboard 포함 URL
id	string	dashboard ID
isReadOnly	boolean	dashboard 읽기 전용인지 여부
subscriptions	Subscription[]	(빈 값) Power BI 항목(예: 보고서 또는 dashboard)에 대한 구독 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독 가져오기를 관리 API 호출로 사용하여 Power BI 보고서에 대한 구독 정보를 검색할 수 있습니다.
tiles	AdminTile[]	dashboard 속하는 타일
users	DashboardUser[]	(빈 값) dashboard 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 대시보드 사용자를 관리 API 호출로 가져오기 또는 매개 변수를 사용하여 PostWorkspaceInfo API 호출 `getArtifactUsers` 을 사용하여 Power BI dashboard 사용자 정보를 검색할 수 있습니다.
webUrl	string	dashboard 웹 URL
workspaceId	string	dashboard 작업 영역 ID(GUID)입니다. 이 속성은 GetDashboardsAsAdmin에서만 반환됩니다.

AdminDataflow

관리 API에서 반환된 데이터 흐름의 메타데이터입니다. 다음은 데이터 흐름에 대해 반환될 수 있는 속성 목록입니다. 호출된 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 속성의 하위 집합만 반환됩니다.

Name	형식	Description
configuredBy	string	데이터 흐름 소유자
description	string	데이터 흐름 설명
modelUrl	string	데이터 흐름 정의 파일에 대한 URL(model.json)
modifiedBy	string	데이터 흐름을 수정한 사용자
modifiedDateTime	string	데이터 흐름이 마지막으로 수정된 날짜 및 시간
name	string	데이터 흐름 이름
objectId	string	데이터 흐름 ID
users	DataflowUser[]	(빈 값) 데이터 흐름 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. Dataflow 사용자를 관리 API 호출로 가져오기 또는 매개 변수를 사용하여 PostWorkspaceInfo API 호출 `getArtifactUser` 을 사용하여 Power BI 데이터 흐름에 대한 사용자 정보를 검색할 수 있습니다.
workspaceId	string	데이터 흐름 작업 영역 ID입니다.

AdminDataset

관리 API에서 반환된 Power BI 데이터 세트입니다. API는 다음 데이터 세트 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

Name	형식	Description
ContentProviderType	string	데이터 세트의 콘텐츠 공급자 형식
CreateReportEmbedURL	string	데이터 세트 만들기 보고서 포함 URL
CreatedDate	string	데이터 세트 만들기 날짜 및 시간
Encryption	Encryption	데이터 세트 암호화 정보. 가 지정된 경우에만 `$expand` 적용됩니다.
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	DatasetQueryScaleOutSettings	데이터 세트의 스케일 아웃 설정 쿼리
targetStorageMode	string	데이터 세트 스토리지 모드
upstreamDataflows	DependentDataflow[]	이 항목이 사용하는 모든 데이터 흐름 목록
users	DatasetUser[]	(빈 값) 데이터 세트 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 데이터 세트 사용자를 관리 API로 가져오기 또는 매개 변수를 사용하여 PostWorkspaceInfo API `getArtifactUsers` 를 사용하여 Power BI 항목(예: 보고서 또는 dashboard)에서 사용자 정보를 검색할 수 있습니다.
webUrl	string	데이터 세트의 웹 URL
workspaceId	string	데이터 세트 작업 영역 ID입니다. 이 속성은 GetDatasetsAsAdmin에서만 반환됩니다.

AdminGroup

관리자 API에서 반환된 Power BI 그룹

Name	형식	Description
capacityId	string	용량 ID
dashboards	AdminDashboard[]	그룹에 속하는 대시보드
dataflowStorageId	string	Power BI 데이터 흐름 스토리지 계정 ID
dataflows	AdminDataflow[]	그룹에 속하는 데이터 흐름
datasets	AdminDataset[]	그룹에 속하는 데이터 세트
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	작업 영역의 기본 데이터 세트 스토리지 형식입니다. 가 인 경우에만 반환됩니다.`isOnDedicatedCapacitytrue`
description	string	그룹 설명
hasWorkspaceLevelSettings	boolean	작업 영역에 사용자 지정 설정이 있는지 여부
id	string	작업 영역 ID
isOnDedicatedCapacity	boolean	그룹이 전용 용량에 할당되는지 여부
isReadOnly	boolean	그룹이 읽기 전용인지 여부
logAnalyticsWorkspace	AzureResource	그룹에 할당된 Log Analytics 작업 영역입니다. 단일 그룹을 검색할 때만 반환됩니다.
name	string	그룹 이름
pipelineId	string	작업 영역이 할당된 배포 파이프라인 ID입니다.
reports	AdminReport[]	그룹에 속한 보고서
state	string	그룹 상태
type	GroupType	반환되는 그룹의 형식입니다.
users	GroupUser[]	(빈 값) 그룹에 속한 사용자 및 해당 액세스 권한입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 그룹 사용자 가져오기 관리 API 호출 또는 매개 변수를 사용하여 PostWorkspaceInfo API 호출 `getArtifactUsers` 을 사용하여 Power BI 항목(예: 보고서 또는 dashboard)에서 사용자 정보를 검색할 수 있습니다.
workbooks	Workbook[]	그룹에 속하는 통합 문서

AdminGroups

관리 API에서 반환된 Power BI 그룹 목록에 대한 OData 응답 래퍼

Name	형식	Description
odata.context	string	OData 컨텍스트
value	AdminGroup[]	그룹 목록

AdminReport

관리 API에서 반환된 Power BI 보고서입니다. API는 다음 보고서 속성 목록의 하위 집합을 반환합니다. 하위 집합은 라는 API, 호출자 권한 및 Power BI 데이터베이스의 데이터 가용성에 따라 달라집니다.

Name	형식	Description
appId	string	보고서가 앱에 속하는 경우에만 반환되는 앱 ID
createdBy	string	보고서 소유자입니다. 2019년 6월 이후에 생성된 보고서에만 사용할 수 있습니다.
createdDateTime	string	보고서 생성 날짜 및 시간
datasetId	string	보고서의 데이터 세트 ID
description	string	보고서 설명
embedUrl	string	보고서의 포함 URL
id	string	보고서 ID
isOwnedByMe	boolean	현재 사용자가 보고서를 만들었는지 확인합니다.
modifiedBy	string	보고서를 수정한 마지막 사용자
modifiedDateTime	string	보고서가 마지막으로 수정된 날짜 및 시간
name	string	보고서의 이름
originalReportId	string	작업 영역이 앱으로 게시될 때의 실제 보고서 ID입니다.
reportType	enum: PaginatedReport PowerBIReport	보고서 유형
subscriptions	Subscription[]	(빈 값) Power BI 항목(예: 보고서 또는 dashboard)에 대한 구독 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 구독 가져오기를 관리 API 호출로 사용하여 Power BI 보고서에 대한 구독 정보를 검색할 수 있습니다.
users	ReportUser[]	(빈 값) Power BI 보고서에 대한 사용자 액세스 세부 정보입니다. 이 속성은 향후 릴리스에서 페이로드 응답에서 제거됩니다. 보고서 사용자 가져오기를 관리 API 호출로 사용하거나 매개 변수를 사용하여 PostWorkspaceInfo API 호출 `getArtifactUsers` 을 사용하여 Power BI 보고서에서 사용자 정보를 검색할 수 있습니다.
webUrl	string	보고서의 웹 URL
workspaceId	string	보고서의 작업 영역 ID(GUID)입니다. 이 속성은 GetReportsAsAdmin에서만 반환됩니다.

AdminTile

관리 API에서 반환된 Power BI 타일입니다.

Name	형식	Description
colSpan	integer	타일 범위 열 수
datasetId	string	데이터 집합 ID입니다. 보고서에서 만든 타일 또는 Q&A 타일과 같은 데이터 세트를 사용하는 경우에만 사용할 수 있습니다.
embedData	string	타일에 대한 포함 데이터
embedUrl	string	타일의 포함 URL
id	string	타일 ID
reportId	string	보고서 ID입니다. 보고서에서 만든 타일에만 사용할 수 있습니다.
rowSpan	integer	타일 범위 행 수
title	string	타일의 표시 이름

AzureResource

Log Analytics 작업 영역과 같은 사용자 소유 Azure 리소스를 자세히 설명하는 응답입니다.

Name	형식	Description
id	string	Power BI 내의 리소스에 대한 식별자입니다.
resourceGroup	string	리소스가 있는 구독 내의 리소스 그룹입니다.
resourceName	string	리소스의 이름입니다.
subscriptionId	string	리소스가 있는 Azure 구독입니다.

DashboardUser

Dashboard 대한 Power BI 사용자 액세스 권한 항목

Name	형식	Description
dashboardUserAccessRight	DashboardUserAccessRight	사용자가 dashboard 대한 액세스 권한(권한 수준)
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리 API에만 사용할 수 있습니다.
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
userType	string	사용자의 유형입니다.

DashboardUserAccessRight

사용자가 dashboard 대한 액세스 권한(권한 수준)

Name	형식	Description
None	string	dashboard 콘텐츠에 대한 권한 없음
Owner	string	보고서의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
Read	string	dashboard 콘텐츠에 대한 읽기 권한을 부여합니다.
ReadCopy	string	dashboard 콘텐츠에 대한 읽기 및 복사 액세스 권한 부여
ReadReshare	string	dashboard 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadWrite	string	dashboard 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여

DataflowUser

데이터 흐름에 대한 Power BI 사용자 액세스 권한 항목

Name	형식	Description
DataflowUserAccessRight	DataflowUserAccessRight	사용자가 데이터 흐름에 대해 갖는 액세스 권한(권한 수준)
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리 API에만 사용할 수 있습니다.
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
userType	string	사용자의 유형입니다.

DataflowUserAccessRight

사용자가 데이터 흐름에 대해 갖는 액세스 권한(권한 수준)

Name	형식	Description
None	string	데이터 흐름의 콘텐츠에 대한 사용 권한을 제거합니다.
Owner	string	데이터 흐름의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
Read	string	데이터 흐름의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadReshare	string	데이터 흐름의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadWrite	string	데이터 흐름의 콘텐츠에 대한 읽기 및 쓰기 액세스 권한 부여

DatasetQueryScaleOutSettings

데이터 세트의 스케일 아웃 설정 쿼리

Name	형식	Description
autoSyncReadOnlyReplicas	boolean	데이터 세트가 읽기 전용 복제본을 자동으로 동기화하는지 여부
maxReadOnlyReplicas	integer	데이터 세트의 최대 읽기 전용 복제본 수(자동 복제본 수의 경우 0-64, -1)

DatasetUser

데이터 세트에 대한 Power BI 사용자 액세스 권한 항목

Name	형식	Description
datasetUserAccessRight	DatasetUserAccessRight	사용자가 데이터 세트에 대해 가지고 있는 액세스 권한(권한 수준)
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리 API에만 사용할 수 있습니다.
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	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	데이터 세트의 콘텐츠에 대한 읽기, 쓰기, 다시 공유 및 탐색 액세스 권한 부여

DefaultDatasetStorageFormat

그룹의 기본 데이터 세트 스토리지 형식

Name	형식	Description
Large	string	대용량 데이터 세트 스토리지 형식
Small	string	작은 데이터 세트 스토리지 형식

DependentDataflow

Power BI 종속 데이터 흐름

Name	형식	Description
groupId	string	대상 그룹 ID
targetDataflowId	string	대상 데이터 흐름 ID

Encryption

데이터 세트에 대한 암호화 정보

Name	형식	Description
EncryptionStatus	EncryptionStatus	데이터 세트 암호화 상태

EncryptionStatus

데이터 세트 암호화 상태

Name	형식	Description
InSyncWithWorkspace	string	암호화가 지원되며 암호화 설정과 동기화됩니다.
NotInSyncWithWorkspace	string	암호화가 지원되지만 암호화 설정과 동기화되지 않음
NotSupported	string	이 데이터 세트에 대해 암호화가 지원되지 않습니다.
Unknown	string	데이터 세트 손상으로 인해 암호화 상태 알 수 없음

GroupType

그룹 유형

Name	형식	Description
Group	string	공유 작업 영역의 V1 버전입니다. 이 유형의 작업 영역은 Microsoft가 모든 작업 영역을 최신 버전의 공유 작업 영역으로 마이그레이션함에 따라 더 이상 사용되지 않습니다.
Personal	string	SharePoint 목록 및 OneDrive 통합을 위한 특수 작업 영역 유형
PersonalGroup	string	개인 작업 영역이라고도 하는 "내 작업 영역"입니다.
Workspace	string	공유 작업 영역 또는 organization 다른 사용자와 콘텐츠를 공유하는 데 사용되는 간단한 작업 영역

GroupUser

작업 영역에 액세스할 수 있는 Power BI 사용자

Name	형식	Description
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리 API에만 사용할 수 있습니다.
groupUserAccessRight	GroupUserAccessRight	사용자가 작업 영역에 대해 가지고 있는 액세스 권한(권한 수준)
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
userType	string	사용자의 유형입니다.

GroupUserAccessRight

사용자가 작업 영역에 대해 가지고 있는 액세스 권한(권한 수준)

Name	형식	Description
Admin	string	작업 영역 콘텐츠에 대한 관리자 권한
Contributor	string	작업 영역 콘텐츠에 대한 읽기 및 탐색(ReadExplore) 액세스
Member	string	작업 영역 콘텐츠에 대한 읽기, 다시 공유 및 탐색(ReadReshareExplore) 액세스 권한
None	string	작업 영역 콘텐츠에 대한 액세스 권한 없음
Viewer	string	작업 영역 콘텐츠에 대한 읽기 전용(읽기) 액세스

PrincipalType

보안 주체 유형

Name	형식	Description
App	string	서비스 주체 유형
Group	string	그룹 보안 주체 유형
None	string	보안 주체 유형이 없습니다. 전체 organization 수준 액세스에 사용합니다.
User	string	사용자 계정 유형

ReportUser

보고서에 대한 Power BI 사용자 액세스 권한 항목

Name	형식	Description
displayName	string	보안 주체의 표시 이름
emailAddress	string	사용자의 이메일 주소입니다.
graphId	string	Microsoft Graph의 보안 주체 식별자입니다. 관리 API에만 사용할 수 있습니다.
identifier	string	보안 주체의 식별자
principalType	PrincipalType	보안 주체 유형
profile	ServicePrincipalProfile	Power BI 서비스 보안 주체 프로필입니다. Power BI Embedded 다중 테넌트 솔루션과만 관련이 있습니다.
reportUserAccessRight	ReportUserAccessRight	사용자가 보고서에 대해 가지고 있는 액세스 권한(권한 수준)
userType	string	사용자의 유형입니다.

ReportUserAccessRight

사용자가 보고서에 대해 가지고 있는 액세스 권한(권한 수준)

Name	형식	Description
None	string	보고서의 콘텐츠에 대한 사용 권한 없음
Owner	string	보고서의 콘텐츠에 대한 읽기, 쓰기 및 다시 공유 액세스 권한 부여
Read	string	보고서의 콘텐츠에 대한 읽기 액세스 권한 부여
ReadCopy	string	보고서의 콘텐츠에 대한 읽기 및 복사 액세스 권한 부여
ReadReshare	string	보고서의 콘텐츠에 대한 읽기 및 다시 공유 액세스 권한 부여
ReadWrite	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 구독 정보를 검색할 수 있습니다.

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	사용자의 유형입니다.

Workbook

Power BI 통합 문서

Name	형식	Description
datasetId	string	통합 문서와 연결된 데이터 세트의 ID입니다. 통합 문서에 연결된 데이터 세트가 있는 경우에만 적용됩니다.
name	string	통합 문서 이름

다음을 통해 공유

Admin - Groups GetGroupsAsAdmin

사용 권한

필수 범위

제한 사항

URI 매개 변수

응답

예제

Get deleted workspaces example.

Sample Request

Sample Response

Get orphaned workspaces example.

Sample Request

Sample Response

Get workspaces with their 'dashboards' expanded example

Sample Request

Sample Response

Get workspaces with their 'datasets' expanded example

Sample Request

Sample Response

Get workspaces with their 'datasets' expanded example.

Sample Request

Sample Response

Get workspaces with their 'reports' expanded example

Sample Request

Sample Response

Get workspaces with their 'users' expanded example.

Sample Request

Sample Response

Get workspaces with their 'workbooks' expanded example

Sample Request

Sample Response

정의

AdminDashboard

AdminDataflow

AdminDataset

AdminGroup

AdminGroups

AdminReport

AdminTile

AzureResource

DashboardUser

DashboardUserAccessRight

DataflowUser

DataflowUserAccessRight

DatasetQueryScaleOutSettings

DatasetUser

DatasetUserAccessRight

DefaultDatasetStorageFormat

DependentDataflow

Encryption

EncryptionStatus

GroupType

GroupUser

GroupUserAccessRight

PrincipalType

ReportUser

ReportUserAccessRight

ServicePrincipalProfile

Subscription

SubscriptionUser

Workbook

추가 리소스