Groups - Get Group

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

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