Groups - Create Group

Service:

Power BI REST APIs

API Version:

v1.0

Vytvoří nový pracovní prostor.

Oprávnění

Toto volání rozhraní API lze volat pomocí profilu instančního objektu. Další informace najdete v tématu Profily instančního objektu v Power BI Embedded.

Požadovaný obor

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 identifikátoru URI

Name	V	Vyžadováno	Typ	Description
workspaceV2	query		boolean	(Funkce Preview) Určuje, jestli chcete vytvořit pracovní prostor. Jediná podporovaná hodnota je true.

Text požadavku

Name	Vyžadováno	Typ	Description
name	True	string	Název nově vytvořené skupiny

Odpovědi

Name	Typ	Description
200 OK	Group	OK

Příklady

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"
    }
  ]
}

Definice

Name	Description
AzureResource	Odpověď s podrobnostmi o prostředku Azure vlastněného uživatelem, jako je pracovní prostor služby Log Analytics.
DefaultDatasetStorageFormat	Výchozí formát úložiště datové sady ve skupině
Group	Skupina Power BI
GroupCreationRequest	Žádost Power BI o vytvoření nové skupiny

AzureResource

Odpověď s podrobnostmi o prostředku Azure vlastněného uživatelem, jako je pracovní prostor služby Log Analytics.

Name	Typ	Description
id	string	Identifikátor prostředku v Power BI.
resourceGroup	string	Skupina prostředků v rámci předplatného, ve kterém se prostředek nachází.
resourceName	string	Název prostředku.
subscriptionId	string	Předplatné Azure, ve kterém se prostředek nachází.

DefaultDatasetStorageFormat

Výchozí formát úložiště datové sady ve skupině

Name	Typ	Description
Large	string	Velký formát úložiště datové sady
Small	string	Formát úložiště malých datových sad

Group

Skupina Power BI

Name	Typ	Description
capacityId	string	ID kapacity
dataflowStorageId	string	ID účtu úložiště toku dat Power BI
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Výchozí formát úložiště datové sady v pracovním prostoru Vráceno pouze v případech, kdy isOnDedicatedCapacity je true
id	string	ID pracovního prostoru
isOnDedicatedCapacity	boolean	Jestli je skupina přiřazená k vyhrazené kapacitě
isReadOnly	boolean	Jestli je skupina jen pro čtení
logAnalyticsWorkspace	AzureResource	Pracovní prostor služby Log Analytics přiřazený ke skupině Vrátí se pouze při načítání jedné skupiny.
name	string	Název skupiny

GroupCreationRequest

Žádost Power BI o vytvoření nové skupiny

Name	Typ	Description
name	string	Název nově vytvořené skupiny