Groups - Update Group
Aktualisiert einen angegebenen Arbeitsbereich.
Erlaubnisse
Dieser API-Aufruf kann von einem Dienstprinzipalprofil aufgerufen werden. Weitere Informationen finden Sie unter: Dienstprinzipalprofile in Power BI Embedded.
Erforderlicher Bereich
Arbeitsbereich.ReadWrite.All
Einschränkungen
- Für gemeinsame Kapazitäten kann nur der Name aktualisiert werden.
- Bei Premium-Kapazitäten kann nur der Name und defaultDatasetStorageFormat aktualisiert werden.
- Der Name muss innerhalb einer Organisation eindeutig sein.
PATCH https://api.powerbi.com/v1.0/myorg/groups/{groupId}
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
group
|
path | True |
string (uuid) |
Die Arbeitsbereichs-ID |
Anforderungstext
| Name | Typ | Beschreibung |
|---|---|---|
| defaultDatasetStorageFormat |
Das Standardmäßige Datasetspeicherformat in der Gruppe |
|
| name |
string |
Der Gruppenname |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
OKAY |
Beispiele
Example
Beispielanforderung
PATCH https://api.powerbi.com/v1.0/myorg/groups/e2284830-c8dc-416b-b19a-8cdcd2729332
{
"name": "Updated Sales Results",
"defaultDatasetStorageFormat": "Large"
}
Beispiel für eine Antwort
Definitionen
| Name | Beschreibung |
|---|---|
|
Default |
Das Standardmäßige Datasetspeicherformat in der Gruppe |
|
Update |
Eine Aktualisierungsanforderung für die Gruppe |
DefaultDatasetStorageFormat
Das Standardmäßige Datasetspeicherformat in der Gruppe
| Wert | Beschreibung |
|---|---|
| Small |
Kleines Dataset-Speicherformat |
| Large |
Großes Dataset-Speicherformat |
UpdateGroupRequest
Eine Aktualisierungsanforderung für die Gruppe
| Name | Typ | Beschreibung |
|---|---|---|
| defaultDatasetStorageFormat |
Das Standardmäßige Datasetspeicherformat in der Gruppe |
|
| name |
string |
Der Gruppenname |