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 參數

名稱	位於	必要	類型	Description
workspaceV2	query		boolean	(預覽功能) 是否要建立工作區。 唯一支援的值為 true。

要求本文

名稱	必要	類型	Description
name	True	string	新建立的群組名稱

回應

名稱	類型	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"
    }
  ]
}

定義

名稱	Description
AzureResource	詳細說明使用者擁有 Azure 資源的回應，例如 Log Analytics 工作區。
DefaultDatasetStorageFormat	群組中的預設資料集儲存格式
Group	Power BI 群組
GroupCreationRequest	建立新群組的 Power BI 要求

AzureResource

詳細說明使用者擁有 Azure 資源的回應，例如 Log Analytics 工作區。

名稱	類型	Description
id	string	Power BI 中資源的識別碼。
resourceGroup	string	資源所在訂用帳戶內的資源群組。
resourceName	string	資源名稱。
subscriptionId	string	資源所在的 Azure 訂用帳戶。

DefaultDatasetStorageFormat

群組中的預設資料集儲存格式

名稱	類型	Description
Large	string	大型資料集儲存格式
Small	string	小型資料集儲存格式

Group

Power BI 群組

名稱	類型	Description
capacityId	string	容量識別碼
dataflowStorageId	string	Power BI 資料流程儲存體帳戶識別碼
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	工作區中的預設資料集儲存格式。 只有在 為 時 isOnDedicatedCapacity 才會傳回 true
id	string	工作區識別碼
isOnDedicatedCapacity	boolean	群組是否指派給專用容量
isReadOnly	boolean	群組是否為唯讀
logAnalyticsWorkspace	AzureResource	指派給群組的 Log Analytics 工作區。 只有在擷取單一群組時，才會傳回這個值。
name	string	組名

GroupCreationRequest

建立新群組的 Power BI 要求

名稱	類型	Description
name	string	新建立的群組名稱