Udostępnij przez


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 usłudze Power BI Embedded.

Wymagany zakres

Workspace.Read.All lub Workspace.ReadWrite.All

Ograniczenia

  • Czas aktualizacji uprawnień użytkownika dla obszarów roboczych i 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ż uprawnienia 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

Przykładowe żądanie

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

Przykładowa odpowiedź

{
  "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ź z opisem zasobu platformy Azure należącego do użytkownika, takiego jak obszar roboczy usługi Log Analytics.

DefaultDatasetStorageFormat

Domyślny format magazynu zestawu danych w grupie

Group

Grupa usługi Power BI

AzureResource

Odpowiedź z opisem zasobu platformy Azure należącego do użytkownika, takiego jak obszar roboczy usługi Log Analytics.

Nazwa Typ Opis
id

string (uuid)

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 (uuid)

Subskrypcja platformy Azure, w której znajduje się zasób.

DefaultDatasetStorageFormat

Domyślny format magazynu zestawu danych w grupie

Wartość Opis
Small

Format magazynu małych zestawów danych

Large

Format magazynu dużych zestawów danych

Group

Grupa usługi Power BI

Nazwa Typ Opis
capacityId

string (uuid)

Identyfikator pojemności

dataflowStorageId

string (uuid)

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 (uuid)

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