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 参数

名称	在	必需	类型	说明
workspaceV2	query		boolean	(预览功能) 是否创建工作区。 唯一支持的值为 true。

请求正文

名称	必需	类型	说明
name	True	string	新创建的组的名称

响应

名称	类型	说明
200 OK	Group	OK

示例

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"
    }
  ]
}

定义

名称	说明
AzureResource	详细说明用户拥有的 Azure 资源（例如 Log Analytics 工作区）的响应。
DefaultDatasetStorageFormat	组中的默认数据集存储格式
Group	Power BI 组
GroupCreationRequest	用于创建新组的 Power BI 请求

AzureResource

详细说明用户拥有的 Azure 资源（例如 Log Analytics 工作区）的响应。

名称	类型	说明
id	string	Power BI 中资源的标识符。
resourceGroup	string	资源所在的订阅中的资源组。
resourceName	string	资源的名称。
subscriptionId	string	资源所在的 Azure 订阅。

DefaultDatasetStorageFormat

组中的默认数据集存储格式

名称	类型	说明
Large	string	大型数据集存储格式
Small	string	小型数据集存储格式

Group

Power BI 组

名称	类型	说明
capacityId	string	容量 ID
dataflowStorageId	string	Power BI 数据流存储帐户 ID
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	工作区中的默认数据集存储格式。 仅当 为 时 isOnDedicatedCapacity 返回 true
id	string	工作区 ID
isOnDedicatedCapacity	boolean	是否将组分配到专用容量
isReadOnly	boolean	组是否为只读
logAnalyticsWorkspace	AzureResource	分配给组的 Log Analytics 工作区。 仅当检索单个组时，才会返回此值。
name	string	组名称

GroupCreationRequest

用于创建新组的 Power BI 请求

名称	类型	说明
name	string	新创建的组的名称