Groups - Create Group
新しいワークスペースを作成します。
権限
- この 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 |
(プレビュー機能)ワークスペースを作成するかどうか。 サポートされている値は |
要求本文
| 名前 | 必須 | 型 | 説明 |
|---|---|---|---|
| name | True |
string |
新しく作成されたグループの名前 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
わかりました |
例
| Create a workspace example |
| Example |
Create a workspace example
要求のサンプル
POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True
{
"name": "sample workspace"
}
応答のサンプル
{
"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"
}
応答のサンプル
{
"value": [
{
"id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"name": "sample group"
}
]
}
定義
| 名前 | 説明 |
|---|---|
|
Azure |
Log Analytics ワークスペースなどのユーザー所有の Azure リソースの詳細を示す応答。 |
|
Default |
グループ内の既定のデータセット ストレージ形式 |
| Group |
Power BI グループ |
|
Group |
新しいグループを作成するための Power BI 要求 |
AzureResource
Log Analytics ワークスペースなどのユーザー所有の Azure リソースの詳細を示す応答。
| 名前 | 型 | 説明 |
|---|---|---|
| id |
string (uuid) |
Power BI 内のリソースの識別子。 |
| resourceGroup |
string |
リソースが存在するサブスクリプション内のリソース グループ。 |
| resourceName |
string |
リソースの名前。 |
| subscriptionId |
string (uuid) |
リソースが存在する Azure サブスクリプション。 |
DefaultDatasetStorageFormat
グループ内の既定のデータセット ストレージ形式
| 値 | 説明 |
|---|---|
| Small |
小さなデータセットストレージ形式 |
| Large |
大規模なデータセットストレージ形式 |
Group
Power BI グループ
| 名前 | 型 | 説明 |
|---|---|---|
| capacityId |
string (uuid) |
容量 ID |
| dataflowStorageId |
string (uuid) |
Power BI データフロー ストレージ アカウント ID |
| defaultDatasetStorageFormat |
ワークスペース内の既定のデータセット ストレージ形式。
|
|
| id |
string (uuid) |
ワークスペース ID |
| isOnDedicatedCapacity |
boolean |
グループが専用容量に割り当てられているかどうか |
| isReadOnly |
boolean |
グループが読み取り専用かどうか |
| logAnalyticsWorkspace |
グループに割り当てられている Log Analytics ワークスペース。 これは、1 つのグループを取得する場合にのみ返されます。 |
|
| name |
string |
グループ名 |
GroupCreationRequest
新しいグループを作成するための Power BI 要求
| 名前 | 型 | 説明 |
|---|---|---|
| name |
string |
新しく作成されたグループの名前 |