Groups - Create Group

Service:

Power BI REST APIs

API Version:

v1.0

새 작업 영역을 만듭니다.

사용 권한

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

필수 범위

Workspace.ReadWrite.All

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

With optional parameters:

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2={workspaceV2}

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
workspaceV2	query		boolean	(미리 보기 기능) 작업 영역을 만들지 여부입니다. true 값만 지원됩니다.

요청 본문

Name	필수	형식	Description
name	True	string	새로 만든 그룹의 이름

응답

Name	형식	Description
200 OK	Group	확인

예제

Create a workspace example

Example

Create a workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True

Request Body

{
  "name": "sample workspace"
}

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isOnDedicatedCapacity": false,
      "name": "sample workspace"
    }
  ]
}

Example

Sample Request

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

Request Body

{
  "name": "sample group"
}

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "sample group"
    }
  ]
}

정의

Name	Description
AzureResource	Log Analytics 작업 영역과 같은 사용자 소유 Azure 리소스를 자세히 설명하는 응답입니다.
DefaultDatasetStorageFormat	그룹의 기본 데이터 세트 스토리지 형식
Group	Power BI 그룹
GroupCreationRequest	새 그룹을 만들기 위한 Power BI 요청

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	그룹 이름

GroupCreationRequest

새 그룹을 만들기 위한 Power BI 요청

Name	형식	Description
name	string	새로 만든 그룹의 이름