Udostępnij za pośrednictwem

Groups - Create Group

  • Odwołanie
Service:
Power BI REST APIs
API Version:
v1.0

Tworzy nowy 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.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups
With optional parameters: 
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

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True
Request Body
{
  "name": "sample workspace"
}

Sample Response

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

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups
Request Body
{
  "name": "sample group"
}

Sample Response

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

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
GroupCreationRequest

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

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

GroupCreationRequest

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

Nazwa Typ Opis
name

string

Nazwa nowo utworzonej grupy