Udostępnij przez

Groups - Create Group

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

Tworzy nowy obszar roboczy.

Uprawnienia

Wymagany zakres

Workspace.ReadWrite.All 

POST https://api.powerbi.com/v1.0/myorg/groups
Z parametrami opcjonalnymi: 
POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2={workspaceV2}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
workspaceV2
 query

boolean

(Funkcja w wersji zapoznawczej) Czy utworzyć obszar roboczy. Jedyną obsługiwaną wartością jest true.

Treść żądania

Nazwa Wymagane Typ Opis
name True

string

Nazwa nowo utworzonej grupy

Odpowiedzi

Nazwa Typ Opis
200 OK

Group

OK

Przykłady

Create a workspace example
Example

Create a workspace example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True
Treść żądania
{
  "name": "sample workspace"
}

Przykładowa odpowiedź

Kod stanu:
200 
{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isOnDedicatedCapacity": false,
      "name": "sample workspace"
    }
  ]
}

Example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/groups
Treść żądania
{
  "name": "sample group"
}

Przykładowa odpowiedź

Kod stanu:
200 
{
  "value": [
    {
      "id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
      "isReadOnly": false,
      "isOnDedicatedCapacity": false,
      "name": "sample group"
    }
  ]
}

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
GroupCreationRequest

Żądanie usługi Power BI dotyczące utworzenia nowej grupy

AzureResource

Objekt

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

Wyliczanie

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

Objekt

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

GroupCreationRequest

Objekt

Żądanie usługi Power BI dotyczące utworzenia nowej grupy

Nazwa Typ Opis
name

string

Nazwa nowo utworzonej grupy