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 參數

名稱	位於	必要	類型	Description
groupId	path	True	string (uuid)	工作區標識碼

回應

名稱	類型	Description
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"
}

定義

名稱	Description
AzureResource	詳細說明用戶擁有的 Azure 資源，例如 Log Analytics 工作區的回應。
DefaultDatasetStorageFormat	群組中的預設數據集記憶體格式
Group	Power BI 群組

AzureResource

Object

詳細說明用戶擁有的 Azure 資源，例如 Log Analytics 工作區的回應。

名稱	類型	Description
id	string (uuid)	Power BI 內資源的標識碼。
resourceGroup	string	資源所在訂用帳戶內的資源群組。
resourceName	string	資源的名稱。
subscriptionId	string (uuid)	資源所在的 Azure 訂用帳戶。

DefaultDatasetStorageFormat

列舉型別

群組中的預設數據集記憶體格式

值	Description
Small	小型數據集記憶體格式
Large	大型數據集記憶體格式

Group

Object

Power BI 群組

名稱	類型	Description
capacityId	string (uuid)	容量標識碼
dataflowStorageId	string (uuid)	Power BI 數據流記憶體帳戶標識碼
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	工作區中的預設數據集記憶體格式。 只有在 isOnDedicatedCapacity 為 true 時才會傳回
id	string (uuid)	工作區標識碼
isOnDedicatedCapacity	boolean	群組是否已指派給專用容量
isReadOnly	boolean	群組是否為唯讀
logAnalyticsWorkspace	AzureResource	指派給群組的Log Analytics工作區。 只有在擷取單一群組時，才會傳回這個值。
name	string	組名