Groups - Get Group

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca określony obszar roboczy.

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Wymagany zakres

Workspace.Read.All lub Workspace.ReadWrite.All

Ograniczenia

• Czas aktualizowania uprawnień użytkownika dla obszarów roboczych może nie być natychmiast dostępny podczas korzystania z wywołań interfejsu API. Aby odświeżyć uprawnienia użytkownika, użyj wywołania interfejsu API odświeżania uprawnień użytkownika .
  
  

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
groupId	path	True	string uuid	Identyfikator obszaru roboczego

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Group	OK

Przykłady

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"
}

Definicje

Nazwa	Opis
AzureResource	Odpowiedź opisująca zasób platformy Azure należący do użytkownika, taki jak obszar roboczy usługi Log Analytics.
DefaultDatasetStorageFormat	Domyślny format magazynu zestawu danych w grupie
Group	Grupa usługi Power BI

AzureResource

Odpowiedź opisująca zasób platformy Azure należący do użytkownika, taki jak obszar roboczy usługi Log Analytics.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu w usłudze Power BI.
resourceGroup	string	Grupa zasobów w ramach subskrypcji, w której znajduje się zasób.
resourceName	string	Nazwa zasobu.
subscriptionId	string	Subskrypcja platformy Azure, w której znajduje się zasób.

DefaultDatasetStorageFormat

Domyślny format magazynu zestawu danych w grupie

Nazwa	Typ	Opis
Large	string	Format dużego magazynu zestawu danych
Small	string	Format magazynu małych zestawów danych

Group

Grupa usługi Power BI

Nazwa	Typ	Opis
capacityId	string	Identyfikator pojemności
dataflowStorageId	string	Identyfikator konta magazynu przepływu danych usługi Power BI
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Domyślny format magazynu zestawu danych w obszarze roboczym. Zwracane tylko wtedy, gdy isOnDedicatedCapacity jest true
id	string	Identyfikator obszaru roboczego
isOnDedicatedCapacity	boolean	Czy grupa jest przypisana do pojemności dedykowanej
isReadOnly	boolean	Czy grupa jest tylko do odczytu
logAnalyticsWorkspace	AzureResource	Obszar roboczy usługi Log Analytics przypisany do grupy. Jest to zwracane tylko w przypadku pobierania pojedynczej grupy.
name	string	Nazwa grupy