Groups - Create Group

Service:

Power BI REST APIs

API Version:

v1.0

Crea una nuova area di lavoro.

Autorizzazioni

Questa chiamata API può essere chiamata da un profilo dell'entità servizio. Per altre informazioni, vedere: Profili dell'entità servizio in Power BI Embedded.

Ambito obbligatorio

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}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
workspaceV2	query		boolean	(Funzionalità di anteprima) Se creare un'area di lavoro. L'unico valore supportato è true.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
name	True	string	Nome del gruppo appena creato

Risposte

Nome	Tipo	Descrizione
200 OK	Group	OK

Esempio

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

Definizioni

Nome	Descrizione
AzureResource	Risposta che illustra in dettaglio una risorsa di Azure di proprietà dell'utente, ad esempio un'area di lavoro Log Analytics.
DefaultDatasetStorageFormat	Formato di archiviazione del set di dati predefinito nel gruppo
Group	Un gruppo di Power BI
GroupCreationRequest	Richiesta di Power BI per creare un nuovo gruppo

AzureResource

Risposta che illustra in dettaglio una risorsa di Azure di proprietà dell'utente, ad esempio un'area di lavoro Log Analytics.

Nome	Tipo	Descrizione
id	string	Identificatore della risorsa all'interno di Power BI.
resourceGroup	string	Gruppo di risorse all'interno della sottoscrizione in cui risiede la risorsa.
resourceName	string	Nome della risorsa.
subscriptionId	string	Sottoscrizione di Azure in cui risiede la risorsa.

DefaultDatasetStorageFormat

Formato di archiviazione del set di dati predefinito nel gruppo

Nome	Tipo	Descrizione
Large	string	Formato di archiviazione del set di dati Large
Small	string	Formato di archiviazione di set di dati di piccole dimensioni

Group

Un gruppo di Power BI

Nome	Tipo	Descrizione
capacityId	string	ID capacità
dataflowStorageId	string	ID dell'account di archiviazione del flusso di dati di Power BI
defaultDatasetStorageFormat	DefaultDatasetStorageFormat	Formato di archiviazione del set di dati predefinito nell'area di lavoro. Restituito solo quando isOnDedicatedCapacity è true
id	string	ID area di lavoro
isOnDedicatedCapacity	boolean	Se il gruppo viene assegnato a una capacità dedicata
isReadOnly	boolean	Se il gruppo è di sola lettura
logAnalyticsWorkspace	AzureResource	Area di lavoro Log Analytics assegnata al gruppo. Viene restituito solo quando si recupera un singolo gruppo.
name	string	Nome del gruppo

GroupCreationRequest

Richiesta di Power BI per creare un nuovo gruppo

Nome	Tipo	Descrizione
name	string	Nome del gruppo appena creato