Groups - Get Group
指定したワークスペースを返します。
権限
この API 呼び出しは、サービス プリンシパル プロファイルによって呼び出すことができます。 詳細については、「Power BI Embeddedでのサービス プリンシパル プロファイルの
必要なスコープ
Workspace.Read.All または Workspace.ReadWrite.All
制限事項
- ワークスペースのユーザーアクセス許可は更新に時間がかかるため、API 呼び出しを使用するときにすぐに使用できない場合があります。 ユーザーのアクセス許可を更新するには、api 呼び出し ユーザーのアクセス許可の更新 を使用します。
GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
group
|
path | True |
string (uuid) |
ワークスペース ID |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
わかりました |
例
Example
要求のサンプル
GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48
応答のサンプル
{
"id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
"isReadOnly": false,
"isOnDedicatedCapacity": true,
"capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
"defaultDatasetStorageFormat": "Small",
"name": "Sample Group 1"
}
定義
| 名前 | 説明 |
|---|---|
|
Azure |
Log Analytics ワークスペースなどのユーザー所有の Azure リソースの詳細を示す応答。 |
|
Default |
グループ内の既定のデータセット ストレージ形式 |
| 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 |
グループ名 |