Admin - Groups GetGroupsAsAdmin
Restituisce un elenco di aree di lavoro per l'organizzazione.
Autorizzazioni
- L'utente deve disporre dei diritti di amministratore( ad esempio Office 365 amministratore globale o amministratore del servizio Power BI) o eseguire l'autenticazione tramite un'entità servizio.
- Le autorizzazioni delegate sono supportate.
Quando viene eseguita con l'autenticazione priniciale del servizio, un'app non deve avere premissioni necessarie per il consenso amministratore per Power BI impostate nel portale di Azure.
Ambito obbligatorio
Tenant.Read.All o Tenant.ReadWrite.All
Rilevante solo quando si esegue l'autenticazione tramite un token di accesso amministratore delegato standard. Non deve essere presente quando viene usata l'autenticazione tramite un'entità servizio.
Limitazioni
Numero massimo di 50 richieste all'ora o 15 richieste al minuto, per tenant. Questa chiamata si verifica anche dopo 30 secondi per evitare effetti negativi sul servizio Power BI.
GET https://api.powerbi.com/v1.0/myorg/admin/groups?$top={$top}
GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand={$expand}&$filter={$filter}&$top={$top}&$skip={$skip}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
$top
|
query | True |
integer int32 |
Restituisce solo i primi n risultati. Questo parametro è obbligatorio e deve essere compreso nell'intervallo compreso tra 1 e 5000. |
$expand
|
query |
string |
Accetta un elenco delimitato da virgole di tipi di dati, che verranno espansi inline nella risposta. Supporta |
|
$filter
|
query |
string |
Filtra i risultati in base a una condizione booleana |
|
$skip
|
query |
integer int32 |
Ignora i primi n risultati. Usare con top per recuperare i risultati oltre i primi 5000. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK |
Esempio
Get deleted workspaces example.
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups?$filter=state eq 'Deleted'&$top=100
Sample Response
{
"value": [
{
"id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"name": "Sample Group 2",
"description": "Deleted sample group",
"type": "Workspace",
"state": "Deleted"
}
]
}
Get orphaned workspaces example.
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=users&$filter=(not users/any()) or (not users/any(u: u/groupUserAccessRight eq Microsoft.PowerBI.ServiceContracts.Api.GroupUserAccessRight'Admin'))&$top=100
Sample Response
{
"value": [
{
"id": "d5caa808-8c91-400a-911d-06af08dbcc31",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"name": "Orphaned Group",
"description": "Sample orphan group",
"type": "Workspace",
"state": "Active",
"hasWorkspaceLevelSettings": false,
"users": []
}
]
}
Get workspaces with their 'dashboards' expanded example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=dashboards&$top=100
Sample Response
{
"value": [
{
"id": "94E57E92-CEE2-486D-8CC8-218C97200579",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"capacityMigrationStatus": "Migrated",
"description": "shorter description",
"type": "Workspace",
"state": "Removing",
"name": "a",
"hasWorkspaceLevelSettings": false,
"dashboards": [
{
"id": "4668133c-ae3f-42fb-ad7c-214a8623280c",
"displayName": "SQlAzure-Refresh.pbix",
"isReadOnly": false
},
{
"id": "a8f18ca7-63e8-4220-bc1c-f576ec180b98",
"displayName": "cdvc",
"isReadOnly": false
}
]
}
]
}
Get workspaces with their 'datasets' expanded example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=datasets&$top=100
Sample Response
{
"value": [
{
"id": "94E57E92-CEE2-486D-8CC8-218C97200579",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"capacityMigrationStatus": "Migrated",
"description": "shorter description",
"type": "Workspace",
"state": "Removing",
"name": "a",
"hasWorkspaceLevelSettings": false,
"datasets": [
{
"id": "8ce96c50-85a0-4db3-85c6-7ccc3ed46523",
"name": "SQlAzure-Refresh",
"addRowsAPIEnabled": false,
"configuredBy": "admin@granularcontrols.ccsctp.net",
"isRefreshable": true,
"isEffectiveIdentityRequired": false,
"isEffectiveIdentityRolesRequired": false,
"isOnPremGatewayRequired": false,
"targetStorageMode": "Abf",
"createdDate": "2019-04-30T21:35:15.867-07:00",
"ContentProviderType": "PbixInImportMode",
"isInPlaceSharingEnabled": false
},
{
"id": "7d6a4f72-1906-4e08-a469-bd6bc1ab7b69",
"name": "NESGames",
"addRowsAPIEnabled": false,
"configuredBy": "admin@granularcontrols.ccsctp.net",
"isRefreshable": true,
"isEffectiveIdentityRequired": false,
"isEffectiveIdentityRolesRequired": false,
"isOnPremGatewayRequired": false,
"targetStorageMode": "Abf",
"createdDate": "2019-04-30T21:35:15.867-07:00",
"ContentProviderType": "PbixInImportMode",
"isInPlaceSharingEnabled": false
}
]
}
]
}
Get workspaces with their 'datasets' expanded example.
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=datasets
Sample Response
{
"value": [
{
"id": "e380d1d0-1fa6-460b-9a90-1a5c6b02414c",
"isReadOnly": false,
"isOnDedicatedCapacity": true,
"capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
"defaultDatasetStorageFormat": "Small",
"name": "Sample Group 1",
"description": "Sample group",
"type": "Workspace",
"state": "Active",
"hasWorkspaceLevelSettings": true,
"datasets": [
{
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"name": "SalesMarketing",
"addRowsAPIEnabled": false,
"configuredBy": "john@contoso.com",
"isRefreshable": true,
"isEffectiveIdentityRequired": false,
"isEffectiveIdentityRolesRequired": false,
"isOnPremGatewayRequired": false,
"isInPlaceSharingEnabled": false,
"encryption": {
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"encryptionStatus": "InSyncWithWorkspace"
}
}
]
},
{
"id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"name": "Sample Group 2",
"description": "Deleted sample group",
"type": "Workspace",
"state": "Deleted",
"datasets": []
}
]
}
Get workspaces with their 'reports' expanded example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=reports&$top=100
Sample Response
{
"value": [
{
"id": "EC1EE11F-845D-495E-82A3-9DAC2072305A",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"capacityMigrationStatus": "Migrated",
"description": "cvcv",
"type": "Workspace",
"state": "Active",
"name": "WSv2Test12",
"hasWorkspaceLevelSettings": true,
"reports": []
},
{
"id": "94E57E92-CEE2-486D-8CC8-218C97200579",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"capacityMigrationStatus": "Migrated",
"description": "shorter description",
"type": "Workspace",
"state": "Removing",
"name": "a",
"hasWorkspaceLevelSettings": false,
"reports": [
{
"id": "5DBA60B0-D9A7-42AE-B12C-6D9D51E7739A",
"reportType": "PowerBIReport",
"name": "SQlAzure-Refresh",
"datasetId": "8ce96c50-85a0-4db3-85c6-7ccc3ed46523"
},
{
"id": "197E5C3C-D2F3-42D8-A536-875FB6D7D48C",
"reportType": "PowerBIReport",
"name": "NESGames",
"datasetId": "7d6a4f72-1906-4e08-a469-bd6bc1ab7b69"
}
]
}
]
}
Get workspaces with their 'users' expanded example.
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=users&$top=100
Sample Response
{
"value": [
{
"id": "e380d1d0-1fa6-460b-9a90-1a5c6b02414c",
"isReadOnly": false,
"isOnDedicatedCapacity": true,
"capacityId": "0f084df7-c13d-451b-af5f-ed0c466403b2",
"defaultDatasetStorageFormat": "Small",
"name": "Sample Group 1",
"description": "Sample group",
"type": "Workspace",
"state": "Active",
"hasWorkspaceLevelSettings": false,
"users": [
{
"emailAddress": "john@contoso.com",
"groupUserAccessRight": "Admin"
}
]
},
{
"id": "183dcf10-47b8-48c4-84aa-f0bf9d5f8fcf",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"name": "Sample Group 2",
"description": "Deleted sample group",
"type": "Workspace",
"state": "Deleted",
"users": []
}
]
}
Get workspaces with their 'workbooks' expanded example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/groups?$expand=workbooks&$top=100
Sample Response
{
"value": [
{
"id": "94E57E92-CEE2-486D-8CC8-218C97200579",
"isReadOnly": false,
"isOnDedicatedCapacity": false,
"description": "shorter description",
"type": "Workspace",
"state": "Removing",
"hasWorkspaceLevelSettings": false,
"name": "a",
"workbooks": [
{
"name": "My Excel sheet",
"datasetId": "8ce96c50-85a0-4db3-85c6-7ccc3ed46523"
}
]
}
]
}
Definizioni
Nome | Descrizione |
---|---|
Admin |
Un dashboard di Power BI restituito dalle API di Amministrazione. L'API restituisce un subset dell'elenco seguente di proprietà del dashboard. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI. |
Admin |
Metadati di un flusso di dati restituito dalle API di Amministrazione. Di seguito è riportato un elenco di proprietà che possono essere restituite per un flusso di dati. Solo un subset delle proprietà verrà restituito a seconda dell'API chiamata, delle autorizzazioni del chiamante e della disponibilità dei dati nel database di Power BI. |
Admin |
Set di dati di Power BI restituito dalle API di Amministrazione. L'API restituisce un subset dell'elenco seguente di proprietà del set di dati. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI. |
Admin |
Un gruppo di Power BI restituito dalle API di amministrazione |
Admin |
Wrapper di risposta OData per un elenco di gruppi di Power BI restituiti dalle API di Amministrazione |
Admin |
Report di Power BI restituito dalle API di Amministrazione. L'API restituisce un subset dell'elenco seguente di proprietà del report. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI. |
Admin |
Un riquadro di Power BI restituito dalle API di Amministrazione. |
Azure |
Risposta che illustra in dettaglio una risorsa di Azure di proprietà dell'utente, ad esempio un'area di lavoro Log Analytics. |
Dashboard |
Voce di diritto di accesso utente di Power BI per un dashboard |
Dashboard |
Diritto di accesso a cui l'utente ha per il dashboard (livello di autorizzazione) |
Dataflow |
Immissione del diritto di accesso utente di Power BI per un flusso di dati |
Dataflow |
Diritto di accesso a cui un utente ha per il flusso di dati (livello di autorizzazione) |
Dataset |
Eseguire query su impostazioni di scalabilità orizzontale di un set di dati |
Dataset |
Immissione del diritto di accesso utente di Power BI per un set di dati |
Dataset |
Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione) |
Default |
Formato di archiviazione del set di dati predefinito nel gruppo |
Dependent |
Flusso di dati dipendente da Power BI |
Encryption |
Informazioni di crittografia per un set di dati |
Encryption |
Stato della crittografia del set di dati |
Group |
Tipo di gruppo |
Group |
Un utente di Power BI con accesso all'area di lavoro |
Group |
Diritto di accesso (livello di autorizzazione) che un utente ha nell'area di lavoro |
Principal |
Tipo principale |
Report |
Voce a destra dell'accesso utente di Power BI per un report |
Report |
Diritto di accesso a cui l'utente ha per il report (livello di autorizzazione) |
Service |
Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy. |
Subscription |
Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard) |
Subscription |
Un utente della sottoscrizione di posta elettronica di Power BI |
Workbook |
Cartella di lavoro di Power BI |
AdminDashboard
Un dashboard di Power BI restituito dalle API di Amministrazione. L'API restituisce un subset dell'elenco seguente di proprietà del dashboard. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.
Nome | Tipo | Descrizione |
---|---|---|
appId |
string |
ID app, restituito solo se il dashboard appartiene a un'app |
displayName |
string |
Nome visualizzato del dashboard |
embedUrl |
string |
URL di incorporamento del dashboard |
id |
string |
The dashboard ID |
isReadOnly |
boolean |
Indica se il dashboard è di sola lettura |
subscriptions |
(Valore vuoto) Dettagli della sottoscrizione per un elemento di Power BI, ad esempio un report o un dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni sulla sottoscrizione per un report di Power BI usando Get Report Subscriptions (Ottieni sottoscrizioni report) come Amministrazione chiamata API. |
|
tiles |
Riquadri che appartengono al dashboard |
|
users |
(Valore vuoto) Dettagli di accesso utente del dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni utente in un dashboard di Power BI usando Get Dashboard Users (Ottieni utenti dashboard) come chiamata API Amministrazione o l'API PostWorkspaceInfo con il |
|
webUrl |
string |
URL Web del dashboard |
workspaceId |
string |
ID area di lavoro (GUID) del dashboard. Questa proprietà verrà restituita solo in GetDashboardsAsAdmin. |
AdminDataflow
Metadati di un flusso di dati restituito dalle API di Amministrazione. Di seguito è riportato un elenco di proprietà che possono essere restituite per un flusso di dati. Solo un subset delle proprietà verrà restituito a seconda dell'API chiamata, delle autorizzazioni del chiamante e della disponibilità dei dati nel database di Power BI.
Nome | Tipo | Descrizione |
---|---|---|
configuredBy |
string |
Proprietario del flusso di dati |
description |
string |
Descrizione del flusso di dati |
modelUrl |
string |
URL del file di definizione del flusso di dati (model.json) |
modifiedBy |
string |
Utente che ha modificato il flusso di dati |
modifiedDateTime |
string |
Data e ora dell'ultima modifica del flusso di dati |
name |
string |
Nome del flusso di dati |
objectId |
string |
ID flusso di dati |
users |
(Valore vuoto) Dettagli dell'accesso utente del flusso di dati. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni utente su un flusso di dati di Power BI usando Get Dataflow Users come chiamata API Amministrazione o la chiamata API PostWorkspaceInfo con il |
|
workspaceId |
string |
ID area di lavoro flusso di dati. |
AdminDataset
Set di dati di Power BI restituito dalle API di Amministrazione. L'API restituisce un subset dell'elenco seguente di proprietà del set di dati. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.
Nome | Tipo | Descrizione |
---|---|---|
ContentProviderType |
string |
Tipo di provider di contenuto per il set di dati |
CreateReportEmbedURL |
string |
URL di incorporamento del report per il set di dati |
CreatedDate |
string |
Data e ora di creazione del set di dati |
Encryption |
Informazioni sulla crittografia dei set di dati. Applicabile solo quando |
|
IsEffectiveIdentityRequired |
boolean |
Se il set di dati richiede un'identità efficace, che è necessario inviare in una chiamata API GenerateToken . |
IsEffectiveIdentityRolesRequired |
boolean |
Se la sicurezza a livello di riga è definita all'interno del file pbix di Power BI. In tal caso, è necessario specificare un ruolo. |
IsInPlaceSharingEnabled |
boolean |
Se il set di dati può essere condiviso con utenti esterni da usare nel proprio tenant |
IsOnPremGatewayRequired |
boolean |
Se il set di dati richiede un gateway dati locale |
IsRefreshable |
boolean |
Se il set di dati è aggiornabile o meno. Un set di dati aggiornabile di Power BI è un set di dati aggiornato almeno una volta o per il quale esiste una pianificazione di aggiornamento valida. |
QnaEmbedURL |
string |
Il set di dati Q&UN URL di incorporamento |
addRowsAPIEnabled |
boolean |
Indica se il set di dati consente l'aggiunta di nuove righe |
configuredBy |
string |
Proprietario del set di dati |
description |
string |
Descrizione del set di dati |
id |
string |
ID del set di dati |
name |
string |
Nome del set di dati |
queryScaleOutSettings |
Eseguire query su impostazioni di scalabilità orizzontale di un set di dati |
|
targetStorageMode |
string |
Modalità di archiviazione del set di dati |
upstreamDataflows |
L'elenco di tutti i flussi di dati dipende da |
|
users |
(Valore vuoto) Dettagli di accesso utente del set di dati. Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare informazioni utente su un elemento di Power BI (ad esempio un report o un dashboard) usando l'API Get Dataset Users come API Amministrazione o l'API PostWorkspaceInfo con il |
|
webUrl |
string |
URL Web del set di dati |
workspaceId |
string |
ID area di lavoro del set di dati. Questa proprietà verrà restituita solo in GetDatasetsAsAdmin. |
AdminGroup
Un gruppo di Power BI restituito dalle API di amministrazione
Nome | Tipo | Descrizione |
---|---|---|
capacityId |
string |
ID della capacità |
dashboards |
Dashboard che appartengono al gruppo |
|
dataflowStorageId |
string |
ID dell'account di archiviazione del flusso di dati di Power BI |
dataflows |
Flussi di dati appartenenti al gruppo |
|
datasets |
Set di dati che appartengono al gruppo |
|
defaultDatasetStorageFormat |
Formato di archiviazione del set di dati predefinito nell'area di lavoro. Restituito solo quando |
|
description |
string |
Descrizione del gruppo |
hasWorkspaceLevelSettings |
boolean |
Indica se l'area di lavoro ha impostazioni personalizzate |
id |
string |
ID area di lavoro |
isOnDedicatedCapacity |
boolean |
Indica se il gruppo è assegnato a una capacità dedicata |
isReadOnly |
boolean |
Indica 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 |
pipelineId |
string |
ID della pipeline di distribuzione a cui è assegnata l'area di lavoro. |
reports |
Report che appartengono al gruppo |
|
state |
string |
Stato del gruppo |
type |
Tipo di gruppo restituito. |
|
users |
(Valore vuoto) Gli utenti che appartengono al gruppo e i relativi diritti di accesso. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare informazioni utente su un elemento di Power BI (ad esempio un report o un dashboard) usando la chiamata API Get Group Users As Amministrazione o l'API PostWorkspaceInfo con il |
|
workbooks |
Workbook[] |
Cartelle di lavoro che appartengono al gruppo |
AdminGroups
Wrapper di risposta OData per un elenco di gruppi di Power BI restituiti dalle API di Amministrazione
Nome | Tipo | Descrizione |
---|---|---|
odata.context |
string |
Contesto OData |
value |
Elenco di gruppi |
AdminReport
Report di Power BI restituito dalle API di Amministrazione. L'API restituisce un subset dell'elenco seguente di proprietà del report. Il subset dipende dall'API denominata, dalle autorizzazioni del chiamante e dalla disponibilità dei dati nel database di Power BI.
Nome | Tipo | Descrizione |
---|---|---|
appId |
string |
ID app, restituito solo se il report appartiene a un'app |
createdBy |
string |
Proprietario del report. Disponibile solo per i report creati dopo giugno 2019. |
createdDateTime |
string |
Data e ora di creazione del report |
datasetId |
string |
ID del set di dati del report |
description |
string |
Descrizione del report |
embedUrl |
string |
URL di incorporamento del report |
id |
string |
The report ID |
isOwnedByMe |
boolean |
Determinare se il report viene creato dall'utente corrente. |
modifiedBy |
string |
Ultimo utente che ha modificato il report |
modifiedDateTime |
string |
Data e ora dell'ultima modifica del report |
name |
string |
Nome del report |
originalReportId |
string |
ID del report effettivo quando l'area di lavoro viene pubblicata come app. |
reportType |
enum:
|
Tipo di report |
subscriptions |
(Valore vuoto) Dettagli della sottoscrizione per un elemento di Power BI, ad esempio un report o un dashboard. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni sulla sottoscrizione per un report di Power BI usando Get Report Subscriptions (Ottieni sottoscrizioni report) come Amministrazione chiamata API. |
|
users |
(Valore vuoto) Dettagli di accesso utente per un report di Power BI. Questa proprietà verrà rimossa dalla risposta del payload in una versione futura. È possibile recuperare le informazioni utente in un report di Power BI usando Get Report Users (Ottieni utenti report) come chiamata API Amministrazione o l'API PostWorkspaceInfo con il |
|
webUrl |
string |
URL Web del report |
workspaceId |
string |
ID area di lavoro (GUID) del report. Questa proprietà verrà restituita solo in GetReportsAsAdmin. |
AdminTile
Un riquadro di Power BI restituito dalle API di Amministrazione.
Nome | Tipo | Descrizione |
---|---|---|
colSpan |
integer |
Numero di colonne di intervallo di riquadri |
datasetId |
string |
ID del set di dati. Disponibile solo per i riquadri creati da un report o usando un set di dati, ad esempio Q&riquadri A. |
embedData |
string |
Dati di incorporamento per il riquadro |
embedUrl |
string |
URL di incorporamento del riquadro |
id |
string |
ID riquadro |
reportId |
string |
ID report. Disponibile solo per i riquadri creati da un report. |
rowSpan |
integer |
Numero di righe di intervallo di riquadri |
title |
string |
Nome visualizzato del riquadro |
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. |
DashboardUser
Voce di diritto di accesso utente di Power BI per un dashboard
Nome | Tipo | Descrizione |
---|---|---|
dashboardUserAccessRight |
Diritto di accesso a cui l'utente ha per il dashboard (livello di autorizzazione) |
|
displayName |
string |
Nome visualizzato dell'entità |
emailAddress |
string |
Indirizzo di posta elettronica dell'utente |
graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo di entità |
|
profile |
Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy. |
|
userType |
string |
Tipo di utente. |
DashboardUserAccessRight
Diritto di accesso a cui l'utente ha per il dashboard (livello di autorizzazione)
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
Nessuna autorizzazione per il contenuto nel dashboard |
Owner |
string |
Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel report |
Read |
string |
Concede l'accesso in lettura al contenuto nel dashboard |
ReadCopy |
string |
Concede l'accesso in lettura e copia al contenuto nel dashboard |
ReadReshare |
string |
Concede l'accesso in lettura e ricondivisione al contenuto nel dashboard |
ReadWrite |
string |
Concede l'accesso in lettura e scrittura al contenuto nel dashboard |
DataflowUser
Immissione del diritto di accesso utente di Power BI per un flusso di dati
Nome | Tipo | Descrizione |
---|---|---|
DataflowUserAccessRight |
Diritto di accesso a cui un utente ha per il flusso di dati (livello di autorizzazione) |
|
displayName |
string |
Nome visualizzato dell'entità |
emailAddress |
string |
Indirizzo di posta elettronica dell'utente |
graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo di entità |
|
profile |
Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy. |
|
userType |
string |
Tipo di utente. |
DataflowUserAccessRight
Diritto di accesso a cui un utente ha per il flusso di dati (livello di autorizzazione)
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
Rimuove l'autorizzazione per il contenuto nel flusso di dati |
Owner |
string |
Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel flusso di dati |
Read |
string |
Concede l'accesso in lettura al contenuto nel flusso di dati |
ReadReshare |
string |
Concede l'accesso in lettura e ricondivisione al contenuto nel flusso di dati |
ReadWrite |
string |
Concede l'accesso in lettura e scrittura al contenuto nel flusso di dati |
DatasetQueryScaleOutSettings
Eseguire query su impostazioni di scalabilità orizzontale di un set di dati
Nome | Tipo | Descrizione |
---|---|---|
autoSyncReadOnlyReplicas |
boolean |
Indica se il set di dati sincronizza automaticamente le repliche di sola lettura |
maxReadOnlyReplicas |
integer |
Numero massimo di repliche di sola lettura per il set di dati (0-64, -1 per il numero automatico di repliche) |
DatasetUser
Immissione del diritto di accesso utente di Power BI per un set di dati
Nome | Tipo | Descrizione |
---|---|---|
datasetUserAccessRight |
Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione) |
|
displayName |
string |
Nome visualizzato dell'entità |
emailAddress |
string |
Indirizzo di posta elettronica dell'utente |
graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo di entità |
|
profile |
Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy. |
|
userType |
string |
Tipo di utente. |
DatasetUserAccessRight
Diritto di accesso a cui l'utente ha per il set di dati (livello di autorizzazione)
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
Rimuove l'autorizzazione per il contenuto nel set di dati |
Read |
string |
Concede l'accesso in lettura al contenuto nel set di dati |
ReadExplore |
string |
Concede l'accesso in lettura ed esplora al contenuto nel set di dati |
ReadReshare |
string |
Concede l'accesso in lettura e ricondivisione al contenuto nel set di dati |
ReadReshareExplore |
string |
Concede l'accesso in lettura, ricondivisione ed esplora al contenuto nel set di dati |
ReadWrite |
string |
Concede l'accesso in lettura e scrittura al contenuto nel set di dati |
ReadWriteExplore |
string |
Concede l'accesso in lettura, scrittura ed esplorazione al contenuto nel set di dati |
ReadWriteReshare |
string |
Concede l'accesso in lettura, scrittura e ricondividi al contenuto nel set di dati |
ReadWriteReshareExplore |
string |
Concede l'accesso in lettura, scrittura, ricondivisione ed esplora al contenuto nel set di dati |
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 |
DependentDataflow
Flusso di dati dipendente da Power BI
Nome | Tipo | Descrizione |
---|---|---|
groupId |
string |
ID gruppo di destinazione |
targetDataflowId |
string |
ID del flusso di dati di destinazione |
Encryption
Informazioni di crittografia per un set di dati
Nome | Tipo | Descrizione |
---|---|---|
EncryptionStatus |
Stato della crittografia del set di dati |
EncryptionStatus
Stato della crittografia del set di dati
Nome | Tipo | Descrizione |
---|---|---|
InSyncWithWorkspace |
string |
La crittografia è supportata ed è sincronizzata con le impostazioni di crittografia |
NotInSyncWithWorkspace |
string |
La crittografia è supportata ma non è sincronizzata con le impostazioni di crittografia |
NotSupported |
string |
La crittografia non è supportata per questo set di dati |
Unknown |
string |
Lo stato della crittografia è sconosciuto a causa del danneggiamento del set di dati |
GroupType
Tipo di gruppo
Nome | Tipo | Descrizione |
---|---|---|
Group |
string |
Versione V1 dell'area di lavoro condivisa. Questo tipo di aree di lavoro verrà deprecato perché Microsoft esegue la migrazione di tutte le aree di lavoro alla versione più recente dell'area di lavoro condivisa |
Personal |
string |
Tipo speciale di area di lavoro destinata all'elenco di SharePoint e all'integrazione di OneDrive |
PersonalGroup |
string |
"Area di lavoro personale", nota anche come area di lavoro personale |
Workspace |
string |
Area di lavoro condivisa o area di lavoro semplice usata per condividere contenuto con altri utenti dell'organizzazione |
GroupUser
Un utente di Power BI con accesso all'area di lavoro
Nome | Tipo | Descrizione |
---|---|---|
displayName |
string |
Nome visualizzato dell'entità |
emailAddress |
string |
Indirizzo di posta elettronica dell'utente |
graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
groupUserAccessRight |
Diritto di accesso (livello di autorizzazione) di un utente nell'area di lavoro |
|
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo di entità |
|
profile |
Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy. |
|
userType |
string |
Tipo di utente. |
GroupUserAccessRight
Diritto di accesso (livello di autorizzazione) che un utente ha nell'area di lavoro
Nome | Tipo | Descrizione |
---|---|---|
Admin |
string |
Diritti di amministratore per il contenuto dell'area di lavoro |
Contributor |
string |
Leggere ed esplorare (ReadExplore) l'accesso al contenuto dell'area di lavoro |
Member |
string |
Leggi, ricondividi ed esplora (ReadReshareExplore) diritti di accesso al contenuto dell'area di lavoro |
None |
string |
Nessun accesso al contenuto dell'area di lavoro |
Viewer |
string |
Accesso di sola lettura (lettura) al contenuto dell'area di lavoro |
PrincipalType
Tipo principale
Nome | Tipo | Descrizione |
---|---|---|
App |
string |
Tipo di entità servizio |
Group |
string |
Tipo di entità gruppo |
None |
string |
Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero. |
User |
string |
Tipo di entità utente |
ReportUser
Voce a destra dell'accesso utente di Power BI per un report
Nome | Tipo | Descrizione |
---|---|---|
displayName |
string |
Nome visualizzato dell'entità |
emailAddress |
string |
Indirizzo di posta elettronica dell'utente |
graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo principale |
|
profile |
Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy. |
|
reportUserAccessRight |
Diritto di accesso che l'utente ha per il report (livello di autorizzazione) |
|
userType |
string |
Tipo dell'utente. |
ReportUserAccessRight
Diritto di accesso a cui l'utente ha per il report (livello di autorizzazione)
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
Nessuna autorizzazione per il contenuto nel report |
Owner |
string |
Concede l'accesso in lettura, scrittura e ricondivisione al contenuto nel report |
Read |
string |
Concede l'accesso in lettura al contenuto nel report |
ReadCopy |
string |
Concede l'accesso in lettura e copia al contenuto nel report |
ReadReshare |
string |
Concede l'accesso in lettura e ricondivisione al contenuto nel report |
ReadWrite |
string |
Concede l'accesso in lettura e scrittura al contenuto nel report |
ServicePrincipalProfile
Profilo entità servizio Power BI. Solo pertinente per Power BI Embedded soluzione multi-tenancy.
Nome | Tipo | Descrizione |
---|---|---|
displayName |
string |
Nome del profilo dell'entità servizio |
id |
string |
ID profilo dell'entità servizio |
Subscription
Sottoscrizione di posta elettronica per un elemento di Power BI (ad esempio un report o un dashboard)
Nome | Tipo | Descrizione |
---|---|---|
artifactDisplayName |
string |
Nome dell'elemento Power BI sottoscritto , ad esempio un report o un dashboard. |
artifactId |
string |
ID dell'elemento Power BI sottoscritto , ad esempio un report o un dashboard. |
artifactType |
string |
Tipo di elemento di Power BI (ad esempio , |
attachmentFormat |
string |
Formato del report collegato nella sottoscrizione di posta elettronica |
endDate |
string |
Data e ora di fine della sottoscrizione di posta elettronica |
frequency |
string |
Frequenza della sottoscrizione di posta elettronica |
id |
string |
ID sottoscrizione |
isEnabled |
boolean |
Se la sottoscrizione di posta elettronica è abilitata |
linkToContent |
boolean |
Se esiste un collegamento di sottoscrizione nella sottoscrizione di posta elettronica |
previewImage |
boolean |
Indica se esiste uno screenshot del report nella sottoscrizione di posta elettronica |
startDate |
string |
Data e ora di inizio della sottoscrizione di posta elettronica |
subArtifactDisplayName |
string |
Nome della pagina dell'elemento power BI sottoscritto, se si tratta di un report. |
title |
string |
Nome dell'app |
users |
Dettagli di ogni sottoscrittore di posta elettronica. Quando si usa la chiamata Get User Subscriptions As Amministrazione API, il valore restituito è una matrice vuota (Null). Questa proprietà verrà rimossa dalla risposta del payload in una versione successiva. È possibile recuperare le informazioni sulla sottoscrizione in un report o un dashboard di Power BI usando get report Subscriptions As Amministrazione o Get Dashboard Subscriptions As Amministrazione API call( Get Report Subscriptions As Amministrazione API call). |
SubscriptionUser
Un utente della sottoscrizione di posta elettronica di Power BI
Nome | Tipo | Descrizione |
---|---|---|
displayName |
string |
Nome visualizzato dell'entità |
emailAddress |
string |
Indirizzo di posta elettronica dell'utente |
graphId |
string |
Identificatore dell'entità in Microsoft Graph. Disponibile solo per le API di amministrazione. |
identifier |
string |
Identificatore dell'entità |
principalType |
Tipo di entità |
|
profile |
Profilo principale servizio Power BI. Rilevante solo per Power BI Embedded soluzione multi-tenancy. |
|
userType |
string |
Tipo di utente. |
Workbook
Cartella di lavoro di Power BI
Nome | Tipo | Descrizione |
---|---|---|
datasetId |
string |
ID del set di dati associato a una cartella di lavoro. Si applica solo se la cartella di lavoro ha un set di dati associato. |
name |
string |
Nome della cartella di lavoro |