次の方法で共有


Groups - Create Group

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

アクセス許可

この API 呼び出しは、サービス プリンシパル プロファイルによって呼び出すことができます。 詳細については、「Power BI Embeddedのサービス プリンシパル プロファイル」を参照してください。

必要なスコープ

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

OK

Create a workspace example
Example

Create a workspace example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True
{
  "name": "sample workspace"
}

Sample Response

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

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups
{
  "name": "sample group"
}

Sample Response

{
  "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

新しく作成されたグループの名前