Groups - Create Group

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Vytvoří nový pracovní prostor.

Dovolení

• Toto volání rozhraní API může volat instanční profil. Další informace najdete v tématu: profily instančního objektu v Power BI Embedded.
• Instanční objekty musí mít oprávnění udělená správcem infrastruktury. Další informace najdete v tématu: Instanční objekty můžou vytvářet pracovní prostory, připojení a kanály nasazení.

Požadovaný obor

Workspace.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/groups

S volitelnými parametry:

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

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/groups?workspaceV2=True

Text požadavku

{
  "name": "sample workspace"
}

Ukázková odpověď

Stavový kód:

200

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

Example

Ukázkový požadavek

POST https://api.powerbi.com/v1.0/myorg/groups

Text požadavku

{
  "name": "sample group"
}

Ukázková odpověď

Stavový kód:

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

Objekt

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 (uuid)	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 (uuid)	Předplatné Azure, ve kterém se prostředek nachází.

DefaultDatasetStorageFormat

Výčet

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

Hodnota	Description
Small	Malý formát úložiště datových sad
Large	Formát úložiště velkých datových sad

Group

Objekt

Skupina Power BI

Name	Typ	Description
capacityId	string (uuid)	ID kapacity
dataflowStorageId	string (uuid)	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 isOnDedicatedCapacitytrue
id	string (uuid)	ID pracovního prostoru
isOnDedicatedCapacity	boolean	Určuje, jestli je skupina přiřazená k vyhrazené kapacitě.
isReadOnly	boolean	Jestli je skupina určená jen pro čtení
logAnalyticsWorkspace	AzureResource	Pracovní prostor služby Log Analytics přiřazený ke skupině. Tato funkce se vrátí pouze při načítání jedné skupiny.
name	string	Název skupiny

GroupCreationRequest

Objekt

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

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