Condividi tramite

Groups - Create Group

  • Riferimento
Servizio:
Power BI REST APIs
Versione API:
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
Con parametri facoltativi: 
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

Esempio di richiesta

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

Risposta di esempio

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

Example

Esempio di richiesta

POST https://api.powerbi.com/v1.0/myorg/groups
Corpo della richiesta
{
  "name": "sample group"
}

Risposta di esempio

Codice di stato:
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

Object

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

Enumeration

Formato di archiviazione del set di dati predefinito nel gruppo

Valore Descrizione
Large

Formato di archiviazione del set di dati Large
Small

Formato di archiviazione di set di dati di piccole dimensioni

Group

Object

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

Object

Richiesta di Power BI per creare un nuovo gruppo

Nome Tipo Descrizione
name

string

Nome del gruppo appena creato