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	Log Analytics ワークスペースなどのユーザー所有の Azure リソースを詳しく説明する応答。
DefaultDatasetStorageFormat	グループ内の既定のデータセット ストレージ形式
Group	Power BI グループ
GroupCreationRequest	新しいグループを作成するための Power BI 要求

AzureResource

Log Analytics ワークスペースなどのユーザー所有の Azure リソースを詳しく説明する応答。

名前	型	説明
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 ワークスペース。 これは、1 つのグループを取得する場合にのみ返されます。
name	string	グループ名

GroupCreationRequest

新しいグループを作成するための Power BI 要求

名前	型	説明
name	string	新しく作成されたグループの名前