Groups - Create Group
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
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 è |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
name | True |
string |
Nome del gruppo appena creato |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
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
{
"name": "sample workspace"
}
Risposta di esempio
{
"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
{
"name": "sample group"
}
Risposta di esempio
{
"value": [
{
"id": "f089354e-8366-4e18-aea3-4cb4a3a50b48",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"name": "sample group"
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Azure |
Risposta che illustra in dettaglio una risorsa di Azure di proprietà dell'utente, ad esempio un'area di lavoro Log Analytics. |
Default |
Formato di archiviazione del set di dati predefinito nel gruppo |
Group |
Un gruppo di Power BI |
Group |
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
Valore | Descrizione |
---|---|
Large |
Formato di archiviazione del set di dati Large |
Small |
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 |
Formato di archiviazione del set di dati predefinito nell'area di lavoro. Restituito solo quando |
|
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 |
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 |