Groups - Get Group

サービス:

Power BI REST APIs

API バージョン:

v1.0

指定したワークスペースを返します。

権限

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

必要なスコープ

Workspace.Read.All または Workspace.ReadWrite.All

制限事項

• ワークスペースのユーザーアクセス許可は更新に時間がかかるため、API 呼び出しを使用するときにすぐに使用できない場合があります。 ユーザーのアクセス許可を更新するには、api 呼び出し ユーザーのアクセス許可の更新 を使用します。
  
  

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}

URI パラメーター

名前	/	必須	型	説明
groupId	path	True	string (uuid)	ワークスペース ID

応答

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

例

Example

要求のサンプル

GET https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48

応答のサンプル

状態コード:

200

{
  "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
  "isReadOnly": false,
  "isOnDedicatedCapacity": true,
  "capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
  "defaultDatasetStorageFormat": "Small",
  "name": "Sample Group 1"
}

定義

名前	説明
AzureResource	Log Analytics ワークスペースなどのユーザー所有の Azure リソースの詳細を示す応答。
DefaultDatasetStorageFormat	グループ内の既定のデータセット ストレージ形式
Group	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	グループ名