Groups - Get Group

Service:

Power BI REST APIs

API Version:

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

Sample Request

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

Sample Response

Status code:

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

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

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

DefaultDatasetStorageFormat

群組中的預設資料集儲存格式

名稱	類型	Description
Large	string	大型資料集儲存格式
Small	string	小型資料集儲存格式

Group

Power BI 群組

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