Groups - Create Group

サービス:: Power BI REST APIs

API バージョン:: v1.0

新しいワークスペースを作成します。

権限

この API 呼び出しは、サービスプリンシパルプロファイルによって呼び出すことができます。詳細については、「Power BI Embeddedでのサービスプリンシパルプロファイルの」を参照してください。
サービスプリンシパルには、Fabric 管理者によって付与されたアクセス許可が必要です。詳細については、「サービスプリンシパルはワークスペース、接続、デプロイパイプラインを作成できます。」を参照してください。

必要なスコープ

Workspace.ReadWrite.All

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

省略可能なパラメーターを含む:

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

URI パラメーター

名前	/	必須	型	説明
workspaceV2	query		boolean	(プレビュー機能)ワークスペースを作成するかどうか。サポートされている値は `true`のみです。

要求本文

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

応答

名前	型	説明
200 OK	Group	わかりました

例

Create a workspace example

Example

Create a workspace example

要求のサンプル

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

要求本文

{
  "name": "sample workspace"
}

応答のサンプル

状態コード:: 200

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

Example

要求のサンプル

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

要求本文

{
  "name": "sample group"
}

応答のサンプル

状態コード:: 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

Object

Log Analytics ワークスペースなどのユーザー所有の Azure リソースの詳細を示す応答。

名前	型	説明
id	string (uuid)	Power BI 内のリソースの識別子。
resourceGroup	string	リソースが存在するサブスクリプション内のリソースグループ。
resourceName	string	リソースの名前。
subscriptionId	string (uuid)	リソースが存在する Azure サブスクリプション。

DefaultDatasetStorageFormat

列挙

グループ内の既定のデータセットストレージ形式

値	説明
Small	小さなデータセットストレージ形式
Large	大規模なデータセットストレージ形式

Group

Object

Power BI グループ

名前	型	説明
capacityId	string (uuid)	容量 ID
dataflowStorageId	string (uuid)	Power BI データフローストレージアカウント ID
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	ワークスペース内の既定のデータセットストレージ形式。 `isOnDedicatedCapacity` が `true` されている場合にのみ返されます
id	string (uuid)	ワークスペース ID
isOnDedicatedCapacity	boolean	グループが専用容量に割り当てられているかどうか
isReadOnly	boolean	グループが読み取り専用かどうか
logAnalyticsWorkspace	AzureResource	グループに割り当てられている Log Analytics ワークスペース。これは、1 つのグループを取得する場合にのみ返されます。
name	string	グループ名

GroupCreationRequest

Object

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

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