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 |
|---|---|---|---|---|
|
group
|
path | True |
string (uuid) |
Identyfikator obszaru roboczego |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
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 |
|---|---|
|
Azure |
Odpowiedź z opisem zasobu platformy Azure należącego do użytkownika, takiego jak obszar roboczy usługi Log Analytics. |
|
Default |
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 |
Domyślny format magazynu zestawu danych w obszarze roboczym. Zwracane tylko wtedy, gdy |
|
| 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 |
Obszar roboczy usługi Log Analytics przypisany do grupy. Jest to zwracane tylko w przypadku pobierania pojedynczej grupy. |
|
| name |
string |
Nazwa grupy |