Share via


Groups - Get Groups

사용자가 액세스할 수 있는 작업 영역 목록을 반환합니다.

사용 권한

이 API 호출은 서비스 주체 프로필에서 호출할 수 있습니다. 자세한 내용은 Power BI Embedded 서비스 주체 프로필을 참조하세요.

필수 범위

Workspace.Read.All 또는 Workspace.ReadWrite.All

제한 사항

  • 작업 영역에 대한 사용자 권한은 업데이트하는 데 시간이 걸리며 API 호출을 사용할 때 즉시 사용할 수 없습니다. 사용자 권한을 새로 고치려면 사용자 권한 새로 고침 API 호출을 사용합니다.

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

URI 매개 변수

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

string

부울 조건에 따라 결과를 필터링합니다.

$skip
query

integer

int32

첫 번째 n 결과 건너뛰기

$top
query

integer

int32

첫 번째 n 결과만 반환합니다.

응답

Name 형식 Description
200 OK

Groups

확인

예제

Example
Get a list of workspaces using a filter example

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups

Sample Response

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "sample group"
    },
    {
      "id": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "isReadOnly": false,
      "isOnDedicatedCapacity": true,
      "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "defaultDatasetStorageFormat": "Small",
      "name": "marketing group"
    },
    {
      "id": "a2f89923-421a-464e-bf4c-25eab39bb09f",
      "isReadOnly": false,
      "isOnDedicatedCapacity": true,
      "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "defaultDatasetStorageFormat": "Large",
      "name": "contoso",
      "dataflowStorageId": "d692ae06-708c-485e-9987-06ff0fbdbb1f"
    }
  ]
}

Get a list of workspaces using a filter example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups?$filter=contains(name,'marketing')%20or%20name%20eq%20'contoso'

Sample Response

{
  "value": [
    {
      "id": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "marketing group"
    },
    {
      "id": "a2f89923-421a-464e-bf4c-25eab39bb09f",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "contoso",
      "dataflowStorageId": "d692ae06-708c-485e-9987-06ff0fbdbb1f"
    }
  ]
}

정의

Name Description
AzureResource

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

DefaultDatasetStorageFormat

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

Group

Power BI 그룹

Groups

Power BI 그룹 목록의 OData 응답 래퍼

AzureResource

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

Name 형식 Description
id

string

Power BI 내의 리소스에 대한 식별자입니다.

resourceGroup

string

리소스가 있는 구독 내의 리소스 그룹입니다.

resourceName

string

리소스의 이름입니다.

subscriptionId

string

리소스가 있는 Azure 구독입니다.

DefaultDatasetStorageFormat

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

Name 형식 Description
Large

string

대용량 데이터 세트 스토리지 형식

Small

string

작은 데이터 세트 스토리지 형식

Group

Power BI 그룹

Name 형식 Description
capacityId

string

용량 ID

dataflowStorageId

string

Power BI 데이터 흐름 스토리지 계정 ID

defaultDatasetStorageFormat

DefaultDatasetStorageFormat

작업 영역의 기본 데이터 세트 스토리지 형식입니다. 가 인 경우에만 반환됩니다.isOnDedicatedCapacitytrue

id

string

작업 영역 ID

isOnDedicatedCapacity

boolean

그룹이 전용 용량에 할당되었는지 여부

isReadOnly

boolean

그룹이 읽기 전용인지 여부

logAnalyticsWorkspace

AzureResource

그룹에 할당된 Log Analytics 작업 영역입니다. 단일 그룹을 검색할 때만 반환됩니다.

name

string

그룹 이름

Groups

Power BI 그룹 목록의 OData 응답 래퍼

Name 형식 Description
odata.context

string

OData 컨텍스트

value

Group[]

그룹 목록