power.bi
Module power.bi
API
Definitions
![](https://bcentral-packageicons.azureedge.net/images/ballerinax_power.bi_1.4.0.png)
ballerinax/power.bi Ballerina library
Overview
This is a generated connector for Power BI API v1.0 OpenAPI specification.
Power BI REST API provides service endpoints for embedding, administration, and user resources.
Prerequisites
Before using this connector in your Ballerina application, complete the following:
- Create an Azure account.
- Obtain tokens by following this guide.
Quickstart
To use the Power BI connector in your Ballerina application, update the .bal file as follows:
Step 1: Import connector
First, import the ballerinax/power.bi
module into the Ballerina project.
import ballerinax/power.bi;
Step 2: Create a new connector instance
Create a bi:ClientConfiguration
with the <ACCESS_TOKEN>
obtained, and initialize the connector with it.
bi:ClientConfiguration clientConfig = { auth : { token: `<ACCESS_TOKEN>` } }; bi:Client baseClient = check new Client(clientConfig);
Step 3: Invoke connector operation
-
Now you can use the operations available within the connector. Note that they are in the form of remote operations.
Following is an example to list Attributes under a project using the connector.
public function main() { bi:Datasets|error response = baseClient->datasetsGetdatasets(); if (response is bi:Datasets) { log:printInfo(response.toString()); } else { log:printError(response.message()); } }
-
Use
bal run
command to compile and run the Ballerina program.
Clients![](/images/permalink.svg)
power.bi: Client![](/images/permalink.svg)
This is a generated connector for Power BI API v1.0 OpenAPI specification. Power BI REST API provides service endpoints for embedding, administration, and user resources.
Constructor![](/images/permalink.svg)
Gets invoked to initialize the connector
.
The connector initialization requires setting the API credentials.
Create an Azure account and obtain tokens by following this guide.
init (ConnectionConfig config, string serviceUrl)
- config ConnectionConfig - The configurations to be used when initializing the
connector
- serviceUrl string "https://api.powerbi.com/v1.0/myorg/" - URL of the target service
datasetsGetdatasets![](/images/permalink.svg)
Returns a list of datasets from "My Workspace".
datasetsPostdataset![](/images/permalink.svg)
function datasetsPostdataset(CreateDatasetRequest payload, string? defaultRetentionPolicy) returns Dataset|error
Creates a new dataset on "My Workspace".
Parameters
- payload CreateDatasetRequest - Dataset definition to create
- defaultRetentionPolicy string? (default ()) - The default retention policy
datasetsGetdataset![](/images/permalink.svg)
Returns the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
datasetsDeletedataset![](/images/permalink.svg)
Deletes the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
datasetsGettables![](/images/permalink.svg)
Returns a list of tables tables within the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
datasetsPuttable![](/images/permalink.svg)
Updates the metadata and schema for the specified table within the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
- tableName string - The table name
- payload Table - Table name and columns to update existing table
datasetsPostrows![](/images/permalink.svg)
function datasetsPostrows(string datasetId, string tableName, PostRowsRequest payload) returns Response|error
Adds new data rows to the specified table within the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
- tableName string - The table name
- payload PostRowsRequest - The request message
datasetsDeleterows![](/images/permalink.svg)
Deletes all rows from the specified table within the specified dataset from "My Workspace".
datasetsGetrefreshhistory![](/images/permalink.svg)
Returns the refresh history of the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
- top int? (default ()) - The requested number of entries in the refresh history. If not provided, the default is all available entries.
datasetsRefreshdataset![](/images/permalink.svg)
function datasetsRefreshdataset(string datasetId, RefreshRequest payload) returns Response|error
Triggers a refresh for the specified dataset from "My Workspace".
datasetsGetrefreshschedule![](/images/permalink.svg)
function datasetsGetrefreshschedule(string datasetId) returns RefreshSchedule|error
Returns the refresh schedule of the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
Return Type
- RefreshSchedule|error - OK
datasetsUpdaterefreshschedule![](/images/permalink.svg)
function datasetsUpdaterefreshschedule(string datasetId, RefreshScheduleRequest payload) returns Response|error
Updates the refresh schedule for the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
- payload RefreshScheduleRequest - Update Refresh Schedule parameters, by specifying all or some of the parameters
datasetsGetdirectqueryrefreshschedule![](/images/permalink.svg)
function datasetsGetdirectqueryrefreshschedule(string datasetId) returns DirectQueryRefreshSchedule|error
Returns the refresh schedule of a specified DirectQuery or LiveConnection dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
Return Type
datasetsUpdatedirectqueryrefreshschedule![](/images/permalink.svg)
function datasetsUpdatedirectqueryrefreshschedule(string datasetId, DirectQueryRefreshScheduleRequest payload) returns Response|error
Updates the refresh schedule for the specified DirectQuery or LiveConnection dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
- payload DirectQueryRefreshScheduleRequest - Patch DirectQuery or LiveConnection Refresh Schedule parameters, by specifying all or some of the parameters
datasetsGetparameters![](/images/permalink.svg)
function datasetsGetparameters(string datasetId) returns MashupParameters|error
Returns a list of parameters for the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
Return Type
- MashupParameters|error - OK
datasetsUpdateparameters![](/images/permalink.svg)
function datasetsUpdateparameters(string datasetId, UpdateMashupParametersRequest payload) returns Response|error
Updates the parameters values for the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
- payload UpdateMashupParametersRequest - Update mashup parameter request
datasetsGetdatasources![](/images/permalink.svg)
function datasetsGetdatasources(string datasetId) returns Datasources|error
Returns a list of datasources for the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
Return Type
- Datasources|error - OK
datasetsUpdatedatasources![](/images/permalink.svg)
function datasetsUpdatedatasources(string datasetId, UpdateDatasourcesRequest payload) returns Response|error
Updates the datasources of the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
- payload UpdateDatasourcesRequest - Update datasource request
datasetsSetalldatasetconnections![](/images/permalink.svg)
function datasetsSetalldatasetconnections(string datasetId, ConnectionDetails payload) returns Response|error
Updates all connections for the specified dataset from "My Workspace". This API only supports SQL DirectQuery datasets.
Note: This API is deprecated and no longer supported
datasetsBindtogateway![](/images/permalink.svg)
function datasetsBindtogateway(string datasetId, BindToGatewayRequest payload) returns Response|error
Binds the specified dataset from "My Workspace" to the specified gateway with (optional) given set of datasource Ids. This only supports the On-Premises Data Gateway.
Parameters
- datasetId string - The dataset id
- payload BindToGatewayRequest - The bind to gateway request
datasetsGetgatewaydatasources![](/images/permalink.svg)
function datasetsGetgatewaydatasources(string datasetId) returns GatewayDatasources|error
Returns a list of gateway datasources for the specified dataset from "My Workspace".
Parameters
- datasetId string - The dataset id
Return Type
- GatewayDatasources|error - OK
datasetsDiscovergateways![](/images/permalink.svg)
Returns a list of gateways which the specified dataset from "My Workspace" can be bound to.
Parameters
- datasetId string - The dataset id
usersRefreshuserpermissions![](/images/permalink.svg)
Refreshes user permissions in Power BI.
importsGetimports![](/images/permalink.svg)
Returns a list of imports from "My Workspace".
importsPostimport![](/images/permalink.svg)
function importsPostimport(string datasetDisplayName, ImportInfo payload, string? nameConflict, boolean? skipReport) returns Import|error
Creates new content on "My Workspace" from PBIX (Power BI Desktop), JSON, XLSX (Excel), RDL or file path in OneDrive for Business.
Parameters
- datasetDisplayName string - The display name of the dataset, should include file extension. Not supported when importing from OneDrive for Business.
- payload ImportInfo - The import to post
- nameConflict string? (default ()) - Determines what to do if a dataset with the same name already exists. Default value is 'Ignore'.<br/>Only Abort and Overwrite are supported with Rdl files.
- skipReport boolean? (default ()) - Determines whether to skip report import, if specified value must be 'true'. Only supported for PBIX files.
importsGetimport![](/images/permalink.svg)
Returns the specified import from "My Workspace".
Parameters
- importId string - The import id
importsCreatetemporaryuploadlocation![](/images/permalink.svg)
function importsCreatetemporaryuploadlocation() returns TemporaryUploadLocation|error
Creates a temporary blob storage to be used to import large .pbix files larger than 1 GB and up to 10 GB.
Return Type
reportsGetreports![](/images/permalink.svg)
Returns a list of reports from "My Workspace".
reportsGetreport![](/images/permalink.svg)
Returns the specified report from "My Workspace".
Parameters
- reportId string - The report id
reportsDeletereport![](/images/permalink.svg)
Deletes the specified report from "My Workspace".
Parameters
- reportId string - The report id
reportsClonereport![](/images/permalink.svg)
function reportsClonereport(string reportId, CloneReportRequest payload) returns Report|error
Clones the specified report from "My Workspace".
reportsExportreport![](/images/permalink.svg)
Exports the specified report from "My Workspace" to a .pbix file.
Parameters
- reportId string - The report id
reportsUpdatereportcontent![](/images/permalink.svg)
function reportsUpdatereportcontent(string reportId, UpdateReportContentRequest payload) returns Report|error
Updates the specified report from "My Workspace" to have the same content as the report in the request body.
Parameters
- reportId string - The report id
- payload UpdateReportContentRequest - UpdateReportContent parameters
reportsRebindreport![](/images/permalink.svg)
function reportsRebindreport(string reportId, RebindReportRequest payload) returns Response|error
Rebinds the specified report from "My Workspace" to the requested dataset.
reportsGetpages![](/images/permalink.svg)
Returns a list of pages within the specified report from "My Workspace".
Parameters
- reportId string - The report id
reportsGetpage![](/images/permalink.svg)
Returns the specified page within the specified report from "My Workspace".
reportsGetdatasources![](/images/permalink.svg)
function reportsGetdatasources(string reportId) returns Datasources|error
Returns a list of datasources for the specified RDL report from "My Workspace".
Parameters
- reportId string - The report id
Return Type
- Datasources|error - OK
reportsUpdatedatasources![](/images/permalink.svg)
function reportsUpdatedatasources(string reportId, UpdateRdlDatasourcesRequest payload) returns Response|error
Updates the datasources of the specified paginated report from "My Workspace". (Preview)
Parameters
- reportId string - The report id
- payload UpdateRdlDatasourcesRequest - Update RDL datasources request
reportsExporttofile![](/images/permalink.svg)
function reportsExporttofile(string reportId, ExportReportRequest payload) returns Export|error
Exports the specified report from "My Workspace" to the requested format.
Parameters
- reportId string - The report id
- payload ExportReportRequest - Export to file request parameters
reportsGetexporttofilestatus![](/images/permalink.svg)
Returns the status of the Export to file job from "My Workspace".
reportsGetfileofexporttofile![](/images/permalink.svg)
Returns the file of the Export to file job of the specified report from "My Workspace".
dashboardsGetdashboards![](/images/permalink.svg)
function dashboardsGetdashboards() returns Dashboards|error
Returns a list of dashboards from "My Workspace".
Return Type
- Dashboards|error - OK
dashboardsAdddashboard![](/images/permalink.svg)
function dashboardsAdddashboard(AddDashboardRequest payload) returns Dashboard|error
Creates a new empty dashboard on "My Workspace".
Parameters
- payload AddDashboardRequest - Add dashboard parameters
dashboardsGetdashboard![](/images/permalink.svg)
Returns the specified dashboard from "My Workspace".
Parameters
- dashboardId string - The dashboard id
dashboardsGettiles![](/images/permalink.svg)
Returns a list of tiles within the specified dashboard from "My Workspace".
Parameters
- dashboardId string - The dashboard id
dashboardsGettile![](/images/permalink.svg)
Returns the specified tile within the specified dashboard from "My Workspace".
dashboardsClonetile![](/images/permalink.svg)
function dashboardsClonetile(string dashboardId, string tileId, CloneTileRequest payload) returns Tile|error
Clones the specified tile from "My Workspace".
Parameters
- dashboardId string - The dashboard id
- tileId string - The tile id
- payload CloneTileRequest - Clone tile parameters
datasetsGetdatasetsingroup![](/images/permalink.svg)
Returns a list of datasets from the specified workspace.
Parameters
- groupId string - The workspace id
datasetsPostdatasetingroup![](/images/permalink.svg)
function datasetsPostdatasetingroup(string groupId, CreateDatasetRequest payload, string? defaultRetentionPolicy) returns Dataset|error
Creates a new dataset in the specified workspace.
Parameters
- groupId string - The workspace id
- payload CreateDatasetRequest - Create dataset parameters
- defaultRetentionPolicy string? (default ()) - The default retention policy
datasetsGetdatasettodataflowslinksingroup![](/images/permalink.svg)
function datasetsGetdatasettodataflowslinksingroup(string groupId) returns DatasetToDataflowLinksResponse|error
Returns a list of upstream dataflows for datasets from the specified workspace.
Parameters
- groupId string - The workspace id
Return Type
datasetsGetdatasetingroup![](/images/permalink.svg)
Returns the specified dataset from the specified workspace.
datasetsDeletedatasetingroup![](/images/permalink.svg)
Deletes the specified dataset from the specified workspace.
datasetsGettablesingroup![](/images/permalink.svg)
Returns a list of tables within the specified dataset from the specified workspace.
datasetsPuttableingroup![](/images/permalink.svg)
function datasetsPuttableingroup(string groupId, string datasetId, string tableName, Table payload) returns Table|error
Updates the metadata and schema for the specified table, within the specified dataset, from the specified workspace.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- tableName string - The table name
- payload Table - The request message
datasetsPostrowsingroup![](/images/permalink.svg)
function datasetsPostrowsingroup(string groupId, string datasetId, string tableName, PostRowsRequest payload) returns Response|error
Adds new data rows to the specified table, within the specified dataset, from the specified workspace.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- tableName string - The table name
- payload PostRowsRequest - The request message
datasetsDeleterowsingroup![](/images/permalink.svg)
function datasetsDeleterowsingroup(string groupId, string datasetId, string tableName) returns Response|error
Deletes all rows from the specified table, within the specified dataset, from the specified workspace.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- tableName string - The table name
datasetsGetrefreshhistoryingroup![](/images/permalink.svg)
function datasetsGetrefreshhistoryingroup(string groupId, string datasetId, int? top) returns Refreshes|error
Returns the refresh history of the specified dataset from the specified workspace.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- top int? (default ()) - The requested number of entries in the refresh history. If not provided, the default is all available entries.
datasetsRefreshdatasetingroup![](/images/permalink.svg)
function datasetsRefreshdatasetingroup(string groupId, string datasetId, RefreshRequest payload) returns Response|error
Triggers a refresh for the specified dataset from the specified workspace.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- payload RefreshRequest - Refresh request
datasetsGetrefreshscheduleingroup![](/images/permalink.svg)
function datasetsGetrefreshscheduleingroup(string groupId, string datasetId) returns RefreshSchedule|error
Returns the refresh schedule of the specified dataset from the specified workspace.
Return Type
- RefreshSchedule|error - OK
datasetsUpdaterefreshscheduleingroup![](/images/permalink.svg)
function datasetsUpdaterefreshscheduleingroup(string groupId, string datasetId, RefreshScheduleRequest payload) returns Response|error
Updates the refresh schedule for the specified dataset from the specified workspace.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- payload RefreshScheduleRequest - Update Refresh Schedule parameters, by specifying all or some of the parameters
datasetsGetdirectqueryrefreshscheduleingroup![](/images/permalink.svg)
function datasetsGetdirectqueryrefreshscheduleingroup(string groupId, string datasetId) returns DirectQueryRefreshSchedule|error
Returns the refresh schedule of a specified DirectQuery or LiveConnection dataset from the specified workspace.
Return Type
datasetsUpdatedirectqueryrefreshscheduleingroup![](/images/permalink.svg)
function datasetsUpdatedirectqueryrefreshscheduleingroup(string groupId, string datasetId, DirectQueryRefreshScheduleRequest payload) returns Response|error
Updates the refresh schedule for the specified DirectQuery or LiveConnection dataset from the specified workspace.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- payload DirectQueryRefreshScheduleRequest - Patch DirectQuery or LiveConnection Refresh Schedule parameters, by specifying all or some of the parameters
datasetsGetparametersingroup![](/images/permalink.svg)
function datasetsGetparametersingroup(string groupId, string datasetId) returns MashupParameters|error
Returns a list of parameters for the specified dataset from the specified workspace.
Return Type
- MashupParameters|error - OK
datasetsUpdateparametersingroup![](/images/permalink.svg)
function datasetsUpdateparametersingroup(string groupId, string datasetId, UpdateMashupParametersRequest payload) returns Response|error
Updates the parameters values for the specified dataset from the specified workspace.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- payload UpdateMashupParametersRequest - Update mashup parameter request
datasetsGetdatasourcesingroup![](/images/permalink.svg)
function datasetsGetdatasourcesingroup(string groupId, string datasetId) returns Datasources|error
Returns a list of datasources for the specified dataset from the specified workspace.
Return Type
- Datasources|error - OK
datasetsUpdatedatasourcesingroup![](/images/permalink.svg)
function datasetsUpdatedatasourcesingroup(string groupId, string datasetId, UpdateDatasourcesRequest payload) returns Response|error
Updates the datasources of the specified dataset from the specified workspace.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- payload UpdateDatasourcesRequest - Update datasource request
datasetsSetalldatasetconnectionsingroup![](/images/permalink.svg)
function datasetsSetalldatasetconnectionsingroup(string groupId, string datasetId, ConnectionDetails payload) returns Response|error
Updates all connections for the specified dataset from the specified workspace. This API only supports SQL DirectQuery datasets.
Note: This API is deprecated and no longer supported
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- payload ConnectionDetails - The body
datasetsBindtogatewayingroup![](/images/permalink.svg)
function datasetsBindtogatewayingroup(string groupId, string datasetId, BindToGatewayRequest payload) returns Response|error
Binds the specified dataset from the specified workspace to the specified gateway with (optional) given set of datasource Ids. This only supports the On-Premises Data Gateway.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- payload BindToGatewayRequest - The bind to gateway request
datasetsGetgatewaydatasourcesingroup![](/images/permalink.svg)
function datasetsGetgatewaydatasourcesingroup(string groupId, string datasetId) returns GatewayDatasources|error
Returns a list of gateway datasources for the specified dataset from the specified workspace.
Return Type
- GatewayDatasources|error - OK
datasetsDiscovergatewaysingroup![](/images/permalink.svg)
Returns a list of gateways that the specified dataset from the specified workspace can be bound to.
datasetsTakeoveringroup![](/images/permalink.svg)
Transfers ownership over the specified dataset to the current authorized user.
importsGetimportsingroup![](/images/permalink.svg)
Returns a list of imports from the specified workspace.
Parameters
- groupId string - The workspace id
importsPostimportingroup![](/images/permalink.svg)
function importsPostimportingroup(string groupId, string datasetDisplayName, ImportInfo payload, string? nameConflict, boolean? skipReport) returns Import|error
Creates new content on the specified workspace from PBIX (Power BI Desktop), JSON, XLSX (Excel), RDL, or file path in OneDrive for Business.
Parameters
- groupId string - The workspace id
- datasetDisplayName string - The display name of the dataset should include file extension. Not supported when importing from OneDrive for Business. For importing or creating dataflows, this parameter should be hardcoded to model.json.
- payload ImportInfo - The import to post
- nameConflict string? (default ()) - Determines what to do if a dataset with the same name already exists. Default value is 'Ignore'.<br/>Only Abort and Overwrite are supported with Rdl files.<br/>Only Abort and GenerateUniqueName are supported with dataflow model.json files.
- skipReport boolean? (default ()) - Determines whether to skip report import, if specified value must be 'true'. Only supported for PBIX files.
importsGetimportingroup![](/images/permalink.svg)
Returns the specified import from the specified workspace.
importsCreatetemporaryuploadlocationingroup![](/images/permalink.svg)
function importsCreatetemporaryuploadlocationingroup(string groupId) returns TemporaryUploadLocation|error
Creates a temporary blob storage to be used to import large .pbix files larger than 1 GB and up to 10 GB.
Parameters
- groupId string - The workspace id
Return Type
reportsGetreportsingroup![](/images/permalink.svg)
Returns a list of reports from the specified workspace.
Parameters
- groupId string - The workspace id
reportsGetreportingroup![](/images/permalink.svg)
Returns the specified report from the specified workspace.
reportsDeletereportingroup![](/images/permalink.svg)
Deletes the specified report from the specified workspace.
reportsClonereportingroup![](/images/permalink.svg)
function reportsClonereportingroup(string groupId, string reportId, CloneReportRequest payload) returns Report|error
Clones the specified report from the specified workspace.
Parameters
- groupId string - The workspace id
- reportId string - The report id
- payload CloneReportRequest - Clone report parameters
reportsExportreportingroup![](/images/permalink.svg)
Exports the specified report from the specified workspace to a .pbix file.
reportsUpdatereportcontentingroup![](/images/permalink.svg)
function reportsUpdatereportcontentingroup(string groupId, string reportId, UpdateReportContentRequest payload) returns Report|error
Updates the specified report from the specified workspace to have the same content as the specified report in the request body.
Parameters
- groupId string - The workspace id
- reportId string - The report id
- payload UpdateReportContentRequest - UpdateReportContent parameters
reportsRebindreportingroup![](/images/permalink.svg)
function reportsRebindreportingroup(string groupId, string reportId, RebindReportRequest payload) returns Response|error
Rebinds the specified report from the specified workspace to the requested dataset.
Parameters
- groupId string - The workspace id
- reportId string - The report id
- payload RebindReportRequest - Rebind report parameters
reportsGetpagesingroup![](/images/permalink.svg)
Returns a list of pages within the specified report from the specified workspace.
reportsGetpageingroup![](/images/permalink.svg)
Returns the specified page within the specified report from the specified workspace.
Parameters
- groupId string - The workspace id
- reportId string - The report id
- pageName string - The page name
reportsGetdatasourcesingroup![](/images/permalink.svg)
function reportsGetdatasourcesingroup(string groupId, string reportId) returns Datasources|error
Returns a list of datasources for the specified RDL report from the specified workspace.
Return Type
- Datasources|error - OK
reportsUpdatedatasourcesingroup![](/images/permalink.svg)
function reportsUpdatedatasourcesingroup(string groupId, string reportId, UpdateRdlDatasourcesRequest payload) returns Response|error
Updates the datasources of the specified paginated report from the specified workspace. (Preview)
Parameters
- groupId string - The workspace id
- reportId string - The report id
- payload UpdateRdlDatasourcesRequest - Update RDL datasources request
reportsExporttofileingroup![](/images/permalink.svg)
function reportsExporttofileingroup(string groupId, string reportId, ExportReportRequest payload) returns Export|error
Exports the specified report from the specified workspace to the requested format.
Parameters
- groupId string - The workspace id
- reportId string - The report id
- payload ExportReportRequest - Export to file request parameters
reportsGetexporttofilestatusingroup![](/images/permalink.svg)
function reportsGetexporttofilestatusingroup(string groupId, string reportId, string exportId) returns Export|error
Returns the status of the Export to file job from the specified workspace.
Parameters
- groupId string - The workspace id
- reportId string - The report id
- exportId string - The export id
reportsGetfileofexporttofileingroup![](/images/permalink.svg)
function reportsGetfileofexporttofileingroup(string groupId, string reportId, string exportId) returns string|error
Returns the file of the Export to file job of the specified report from the specified group.
Parameters
- groupId string - The workspace id
- reportId string - The report id
- exportId string - The export id
dashboardsGetdashboardsingroup![](/images/permalink.svg)
function dashboardsGetdashboardsingroup(string groupId) returns Dashboards|error
Returns a list of dashboards from the specified workspace.
Parameters
- groupId string - The workspace id
Return Type
- Dashboards|error - OK
dashboardsAdddashboardingroup![](/images/permalink.svg)
function dashboardsAdddashboardingroup(string groupId, AddDashboardRequest payload) returns Dashboard|error
Creates a new empty dashboard on the specified workspace.
dashboardsGetdashboardingroup![](/images/permalink.svg)
Returns the specified dashboard from the specified workspace.
dashboardsGettilesingroup![](/images/permalink.svg)
Returns a list of tiles within the specified dashboard from the specified workspace.
dashboardsGettileingroup![](/images/permalink.svg)
function dashboardsGettileingroup(string groupId, string dashboardId, string tileId) returns Tile|error
Returns the specified tile within the specified dashboard from the specified workspace.
Parameters
- groupId string - The workspace id
- dashboardId string - The dashboard id
- tileId string - The tile id
dashboardsClonetileingroup![](/images/permalink.svg)
function dashboardsClonetileingroup(string groupId, string dashboardId, string tileId, CloneTileRequest payload) returns Tile|error
Clones the specified tile from the specified workspace.
Parameters
- groupId string - The workspace id
- dashboardId string - The dashboard id
- tileId string - The tile id
- payload CloneTileRequest - Clone tile parameters
reportsGeneratetokenforcreateingroup![](/images/permalink.svg)
function reportsGeneratetokenforcreateingroup(string groupId, GenerateTokenRequest payload) returns EmbedToken|error
Generates an embed token to allow report creation on the specified workspace based on the specified dataset.
This API is relevant only to 'App owns data' embed scenario. For more information about using this API, see Considerations when generating an embed token.
Return Type
- EmbedToken|error - OK
reportsGeneratetokeningroup![](/images/permalink.svg)
function reportsGeneratetokeningroup(string groupId, string reportId, GenerateTokenRequest payload) returns EmbedToken|error
Generates an embed token to view or edit the specified report from the specified workspace.
This API is relevant only to 'App owns data' embed scenario. For more information about using this API, see Considerations when generating an embed token.
Parameters
- groupId string - The workspace id
- reportId string - The report id
- payload GenerateTokenRequest - Generate token parameters
Return Type
- EmbedToken|error - OK
datasetsGeneratetokeningroup![](/images/permalink.svg)
function datasetsGeneratetokeningroup(string groupId, string datasetId, GenerateTokenRequest payload) returns EmbedToken|error
Generates an embed token to Embed Q&A based on the specified dataset from the specified workspace.
This API is relevant only to 'App owns data' embed scenario. For more information about using this API, see Considerations when generating an embed token.
Parameters
- groupId string - The workspace id
- datasetId string - The dataset id
- payload GenerateTokenRequest - Generate token parameters
Return Type
- EmbedToken|error - OK
dashboardsGeneratetokeningroup![](/images/permalink.svg)
function dashboardsGeneratetokeningroup(string groupId, string dashboardId, GenerateTokenRequest payload) returns EmbedToken|error
Generates an embed token to view the specified dashboard from the specified workspace.
This API is relevant only to the 'App owns data' embed scenario. For more information about using this API, see Considerations when generating an embed token.
Parameters
- groupId string - The workspace id
- dashboardId string - The dashboard id
- payload GenerateTokenRequest - Generate token parameters
Return Type
- EmbedToken|error - OK
tilesGeneratetokeningroup![](/images/permalink.svg)
function tilesGeneratetokeningroup(string groupId, string dashboardId, string tileId, GenerateTokenRequest payload) returns EmbedToken|error
Generates an embed token to view the specified tile from the specified workspace.
This API is relevant only to 'App owns data' embed scenario. Generates an embed token to view the specified tile from the specified workspace.
Parameters
- groupId string - The workspace id
- dashboardId string - The dashboard id
- tileId string - The tile id
- payload GenerateTokenRequest - Generate token parameters
Return Type
- EmbedToken|error - OK
appsGetapps![](/images/permalink.svg)
Returns a list of installed apps.
appsGetapp![](/images/permalink.svg)
Returns the specified installed app.
Parameters
- appId string - The app id
appsGetreports![](/images/permalink.svg)
Returns a list of reports from the specified app.
Parameters
- appId string - The app id
appsGetreport![](/images/permalink.svg)
Returns the specified report from the specified app.
appsGetdashboards![](/images/permalink.svg)
function appsGetdashboards(string appId) returns Dashboards|error
Returns a list of dashboards from the specified app.
Parameters
- appId string - The app id
Return Type
- Dashboards|error - OK
appsGetdashboard![](/images/permalink.svg)
Returns the specified dashboard from the specified app.
appsGettiles![](/images/permalink.svg)
Returns a list of tiles within the specified dashboard from the specified app.
appsGettile![](/images/permalink.svg)
Returns the specified tile within the specified dashboard from the specified app.
dataflowsGetdataflow![](/images/permalink.svg)
Exports the specified dataflow definition to a .json file.
dataflowsDeletedataflow![](/images/permalink.svg)
Deletes a dataflow from the CDS for Analytics storage, including its definition file and actual model.
dataflowsUpdatedataflow![](/images/permalink.svg)
function dataflowsUpdatedataflow(string groupId, string dataflowId, DataflowUpdateRequestMessage payload) returns Response|error
Update dataflow properties, capabilities and settings.
Parameters
- groupId string - The workspace id
- dataflowId string - The dataflow id
- payload DataflowUpdateRequestMessage - Patch dataflow properties, capabilities and settings
dataflowsRefreshdataflow![](/images/permalink.svg)
function dataflowsRefreshdataflow(string groupId, string dataflowId, RefreshRequest payload, string? processType) returns Response|error
Triggers a refresh for the specified dataflow. The only supported mail notification options are either in case of failure, or none. MailOnCompletion is not supported.
Parameters
- groupId string - The workspace id
- dataflowId string - The dataflow id
- payload RefreshRequest - Refresh request
- processType string? (default ()) - Type of refresh process to use.
dataflowsGetdataflowdatasources![](/images/permalink.svg)
function dataflowsGetdataflowdatasources(string groupId, string dataflowId) returns Datasources|error
Returns a list of datasources for the specified dataflow.
Return Type
- Datasources|error - OK
dataflowsGetdataflows![](/images/permalink.svg)
Returns a list of all dataflows from the specified workspace.
Parameters
- groupId string - The workspace id
dataflowsGetupstreamdataflowsingroup![](/images/permalink.svg)
function dataflowsGetupstreamdataflowsingroup(string groupId, string dataflowId) returns DependentDataflows|error
Returns a list of upstream dataflows for the specified dataflow.
Return Type
- DependentDataflows|error - OK
dataflowsUpdaterefreshschedule![](/images/permalink.svg)
function dataflowsUpdaterefreshschedule(string groupId, string dataflowId, RefreshScheduleRequest payload) returns Response|error
Creates or updates the specified dataflow refresh schedule configuration.
Parameters
- groupId string - The workspace id
- dataflowId string - The dataflow id
- payload RefreshScheduleRequest - The dataflow refresh schedule to create or update
dataflowsGetdataflowtransactions![](/images/permalink.svg)
function dataflowsGetdataflowtransactions(string groupId, string dataflowId) returns DataflowTransactions|error
Returns a list of transactions for the specified dataflow.
Return Type
dataflowsCanceldataflowtransaction![](/images/permalink.svg)
function dataflowsCanceldataflowtransaction(string groupId, string transactionId) returns DataflowTransactionStatus|error
Attempts to Cancel the specified transactions.
Return Type
gatewaysGetgateways![](/images/permalink.svg)
Returns a list of gateways for which the user is an admin.
gatewaysGetgateway![](/images/permalink.svg)
Returns the specified gateway.
Parameters
- gatewayId string - The gateway id
gatewaysGetdatasources![](/images/permalink.svg)
function gatewaysGetdatasources(string gatewayId) returns GatewayDatasources|error
Returns a list of datasources from the specified gateway.
Parameters
- gatewayId string - The gateway id
Return Type
- GatewayDatasources|error - OK
gatewaysCreatedatasource![](/images/permalink.svg)
function gatewaysCreatedatasource(string gatewayId, PublishDatasourceToGatewayRequest payload) returns GatewayDatasource|error
Creates a new datasource on the specified gateway.
Parameters
- gatewayId string - The gateway id
- payload PublishDatasourceToGatewayRequest - The datasource requested to create
Return Type
- GatewayDatasource|error - Created
gatewaysGetdatasource![](/images/permalink.svg)
function gatewaysGetdatasource(string gatewayId, string datasourceId) returns GatewayDatasource|error
Returns the specified datasource from the specified gateway.
Return Type
- GatewayDatasource|error - OK
gatewaysDeletedatasource![](/images/permalink.svg)
Deletes the specified datasource from the specified gateway.
gatewaysUpdatedatasource![](/images/permalink.svg)
function gatewaysUpdatedatasource(string gatewayId, string datasourceId, UpdateDatasourceRequest payload) returns Response|error
Updates the credentials of the specified datasource from the specified gateway.
Parameters
- gatewayId string - The gateway id
- datasourceId string - The datasource id
- payload UpdateDatasourceRequest - The update datasource request
gatewaysGetdatasourcestatus![](/images/permalink.svg)
Checks the connectivity status of the specified datasource from the specified gateway.
gatewaysGetdatasourceusers![](/images/permalink.svg)
function gatewaysGetdatasourceusers(string gatewayId, string datasourceId) returns DatasourceUsers|error
Returns a list of users who have access to the specified datasource.
Return Type
- DatasourceUsers|error - OK
gatewaysAdddatasourceuser![](/images/permalink.svg)
function gatewaysAdddatasourceuser(string gatewayId, string datasourceId, DatasourceUser payload) returns Response|error
Grants or updates the permissions required to use the specified datasource for the specified user.
Parameters
- gatewayId string - The gateway id
- datasourceId string - The datasource id
- payload DatasourceUser - The add user to datasource request
gatewaysDeletedatasourceuser![](/images/permalink.svg)
function gatewaysDeletedatasourceuser(string gatewayId, string datasourceId, string emailAdress) returns Response|error
Removes the specified user from the specified datasource.
Parameters
- gatewayId string - The gateway id
- datasourceId string - The datasource id
- emailAdress string - The user's email address or the service principal object id
groupsGetgroups![](/images/permalink.svg)
Returns a list of workspaces the user has access to.
Parameters
- filter string? (default ()) - Filters the results, based on a boolean condition
- top int? (default ()) - Returns only the first n results
- skip int? (default ()) - Skips the first n results
groupsCreategroup![](/images/permalink.svg)
function groupsCreategroup(GroupCreationRequest payload, boolean? workspaceV2) returns Group|error
Creates new workspace.
Parameters
- payload GroupCreationRequest - Create group request parameters
- workspaceV2 boolean? (default ()) - Preview feature: Create a workspace V2. The only supported value is true.
groupsDeletegroup![](/images/permalink.svg)
Deletes the specified workspace.
Parameters
- groupId string - The workspace id to delete
groupsGetgroupusers![](/images/permalink.svg)
function groupsGetgroupusers(string groupId) returns GroupUsers|error
Returns a list of users that have access to the specified workspace.
Parameters
- groupId string - The workspace id
Return Type
- GroupUsers|error - OK
groupsUpdategroupuser![](/images/permalink.svg)
Update the specified user permissions to the specified workspace.
groupsAddgroupuser![](/images/permalink.svg)
Grants the specified user permissions to the specified workspace.
groupsDeleteuseringroup![](/images/permalink.svg)
Deletes the specified user permissions from the specified workspace.
Parameters
- groupId string - The workspace id
- user string - The email address of the user or the service principal object id to delete
capacitiesGetcapacities![](/images/permalink.svg)
function capacitiesGetcapacities() returns Capacities|error
Returns a list of capacities the user has access to.
Return Type
- Capacities|error - OK
capacitiesGetworkloads![](/images/permalink.svg)
Returns the current state of the specified capacity workloads, if a workload is enabled also returns the maximum memory percentage that the workload can consume.
Parameters
- capacityId string - The capacity Id
capacitiesGetworkload![](/images/permalink.svg)
Returns the current state of a workload and if the workload is enabled also returns the maximum memory percentage that the workload can consume.
capacitiesPatchworkload![](/images/permalink.svg)
function capacitiesPatchworkload(string capacityId, string workloadName, PatchWorkloadRequest payload) returns Response|error
Changes the state of a specific workload to Enabled or Disabled. When enabling a workload the maximum memory percentage that the workload can consume must be set.
Parameters
- capacityId string - The capacity Id
- workloadName string - The name of the workload
- payload PatchWorkloadRequest - Patch workload parameters
capacitiesGetrefreshables![](/images/permalink.svg)
function capacitiesGetrefreshables(int top, string? expand, string? filter, int? skip) returns Refreshables|error
Returns a list of refreshables for all capacities of which the user has access to.
Parameters
- top int - Returns only the first n results.
- expand string? (default ()) - Expands related entities inline, receives a comma-separated list of data types. Supported: capacities and groups
- filter string? (default ()) - Filters the results based on a boolean condition
- skip int? (default ()) - Skips the first n results. Use with top to fetch results beyond the first 1000.
Return Type
- Refreshables|error - OK
capacitiesGetrefreshablesforcapacity![](/images/permalink.svg)
function capacitiesGetrefreshablesforcapacity(string capacityId, int top, string? expand, string? filter, int? skip) returns Refreshables|error
Returns a list of refreshables for the specified capacity the user has access to
Parameters
- capacityId string - The capacity id
- top int - Returns only the first n results.
- expand string? (default ()) - Expands related entities inline, receives a comma-separated list of data types. Supported: capacities and groups
- filter string? (default ()) - Filters the results based on a boolean condition
- skip int? (default ()) - Skips the first n results. Use with top to fetch results beyond the first 1000.
Return Type
- Refreshables|error - OK
capacitiesGetrefreshableforcapacity![](/images/permalink.svg)
function capacitiesGetrefreshableforcapacity(string capacityId, string refreshableId, string? expand) returns Refreshables|error
Returns the specified refreshable for the specified capacity the user has access to
Parameters
- capacityId string - The capacity id
- refreshableId string - The refreshable id
- expand string? (default ()) - Expands related entities inline, receives a comma-separated list of data types. Supported: capacities and groups
Return Type
- Refreshables|error - OK
groupsAssignmyworkspacetocapacity![](/images/permalink.svg)
function groupsAssignmyworkspacetocapacity(AssignToCapacityRequest payload) returns Response|error
Assigns "My Workspace" to the specified capacity.
Parameters
- payload AssignToCapacityRequest - Assign to capacity parameters
groupsAssigntocapacity![](/images/permalink.svg)
function groupsAssigntocapacity(string groupId, AssignToCapacityRequest payload) returns Response|error
Assigns the specified workspace to the specified capacity.
Parameters
- groupId string - The workspace id
- payload AssignToCapacityRequest - Assign to capacity parameters
groupsCapacityassignmentstatusmyworkspace![](/images/permalink.svg)
function groupsCapacityassignmentstatusmyworkspace() returns WorkspaceCapacityAssignmentStatus|error
Gets the status of "My Workspace" assignment to capacity operation.
Return Type
groupsCapacityassignmentstatus![](/images/permalink.svg)
function groupsCapacityassignmentstatus(string groupId) returns WorkspaceCapacityAssignmentStatus|error
Gets the status of the assignment to capacity operation of the specified workspace.
Parameters
- groupId string - The workspace id
Return Type
availablefeaturesGetavailablefeatures![](/images/permalink.svg)
function availablefeaturesGetavailablefeatures() returns AvailableFeatures|error
Returns a list of available features for the user
Return Type
- AvailableFeatures|error - OK
availablefeaturesGetavailablefeaturebyname![](/images/permalink.svg)
function availablefeaturesGetavailablefeaturebyname(string featureName) returns AvailableFeature|error
Returns the specified available feature for user by name.
Parameters
- featureName string - The feature name
Return Type
- AvailableFeature|error - OK
dataflowstorageaccountsGetdataflowstorageaccounts![](/images/permalink.svg)
function dataflowstorageaccountsGetdataflowstorageaccounts() returns DataflowStorageAccounts|error
Returns a list of dataflow storage accounts the user has access to.
Return Type
groupsAssigntodataflowstorage![](/images/permalink.svg)
function groupsAssigntodataflowstorage(string groupId, AssignToDataflowStorageRequest payload) returns Response|error
Assigns the specified workspace to the specified dataflow storage account.
Parameters
- groupId string - The workspace id
- payload AssignToDataflowStorageRequest - Assign to Power BI dataflow storage account parameters
workspaceinfoPostworkspaceinfo![](/images/permalink.svg)
function workspaceinfoPostworkspaceinfo(RequiredWorkspaces payload, boolean? lineage, boolean? datasourceDetails) returns ScanRequest|error
Initiate a call to receive metadata for the requested list of workspaces. (Preview)
Parameters
- payload RequiredWorkspaces - Required workspace IDs to get info for
- lineage boolean? (default ()) - Whether to return lineage info (upstream dataflows, tiles, datasource IDs)
- datasourceDetails boolean? (default ()) - Whether to return datasource details
Return Type
- ScanRequest|error - Accepted
workspaceinfoGetscanstatus![](/images/permalink.svg)
function workspaceinfoGetscanstatus(string scanId) returns ScanRequest|error
Gets scan status for the specified scan. (Preview)
Parameters
- scanId string - The scan id
Return Type
- ScanRequest|error - OK
workspaceinfoGetscanresult![](/images/permalink.svg)
function workspaceinfoGetscanresult(string scanId) returns WorkspaceInfoResponse|error
Gets scan result for the specified scan (should be called only after getting status Succeeded in the scan status API). Scan result will be available for up to 24 hours. (Preview)
Parameters
- scanId string - The scan id
Return Type
workspaceinfoGetmodifiedworkspaces![](/images/permalink.svg)
function workspaceinfoGetmodifiedworkspaces(string? modifiedSince) returns ModifiedWorkspaces|error
Gets a list of workspace IDs in the organization. When using modifiedSince, returns only the IDs of workspaces that had changed since the time specified in the modifiedSince parameter. If not provided, returns a list of all workspace IDs in the organization. modifiedSince parameter should range from 30 minutes to 30 days ago. Notice changes can take up to 30 minutes to take effect. (Preview)
Parameters
- modifiedSince string? (default ()) - Last modified date (must be in ISO 8601 compliant UTC format)
Return Type
- ModifiedWorkspaces|error - OK
capacitiesAssignworkspacestocapacity![](/images/permalink.svg)
function capacitiesAssignworkspacestocapacity(AssignWorkspacesToCapacityRequest payload) returns Response|error
Assigns the provided workspaces to the specified capacity.
Parameters
- payload AssignWorkspacesToCapacityRequest - Admin assign workspaces capacity parameters
capacitiesUnassignworkspacesfromcapacity![](/images/permalink.svg)
function capacitiesUnassignworkspacesfromcapacity(UnassignWorkspacesCapacityRequest payload) returns Response|error
Unassigns the provided workspaces from capacity.
Parameters
- payload UnassignWorkspacesCapacityRequest - Admin assign workspaces to shared capacity parameters
datasetsGetdatasetsasadmin![](/images/permalink.svg)
Returns a list of datasets for the organization.
Parameters
- filter string? (default ()) - Filters the results, based on a boolean condition
- top int? (default ()) - Returns only the first n results
- skip int? (default ()) - Skips the first n results
datasetsGetdatasourcesasadmin![](/images/permalink.svg)
function datasetsGetdatasourcesasadmin(string datasetId) returns Datasources|error
Returns a list of datasources for the specified dataset.
Parameters
- datasetId string - The dataset id
Return Type
- Datasources|error - OK
groupsGetgroupsasadmin![](/images/permalink.svg)
function groupsGetgroupsasadmin(int top, string? expand, string? filter, int? skip) returns Groups|error
Returns a list of workspaces for the organization.
Parameters
- top int - Returns only the first n results. This parameter is mandatory and must be in the range of 1-5000.
- expand string? (default ()) - Expands related entities inline, receives a comma-separated list of data types. Supported: users, reports, dashboards, datasets, dataflows, workbooks
- filter string? (default ()) - Filters the results based on a boolean condition
- skip int? (default ()) - Skips the first n results. Use with top to fetch results beyond the first 5000.
groupsUpdategroupasadmin![](/images/permalink.svg)
Updates the specified workspace properties.
groupsAdduserasadmin![](/images/permalink.svg)
Grants user permissions to the specified workspace.
groupsDeleteuserasadmin![](/images/permalink.svg)
Removes user permissions to the specified workspace.
Parameters
- groupId string - The workspace id
- user string - The user principal name (UPN) of the user to remove (usually the user's email).
groupsRestoredeletedgroupasadmin![](/images/permalink.svg)
function groupsRestoredeletedgroupasadmin(string groupId, GroupRestoreRequest payload) returns Response|error
Restores a deleted workspace.
Parameters
- groupId string - The workspace id
- payload GroupRestoreRequest - Details of the group restore request
dataflowsGetupstreamdataflowsingroupasadmin![](/images/permalink.svg)
function dataflowsGetupstreamdataflowsingroupasadmin(string groupId, string dataflowId) returns DependentDataflows|error
Returns a list of upstream dataflows for the specified dataflow.
Return Type
- DependentDataflows|error - OK
dashboardsGetdashboardsingroupasadmin![](/images/permalink.svg)
function dashboardsGetdashboardsingroupasadmin(string groupId, string? filter, int? top, int? skip) returns Dashboards|error
Returns a list of dashboards from the specified workspace.
Parameters
- groupId string - The workspace id
- filter string? (default ()) - Filters the results, based on a boolean condition
- top int? (default ()) - Returns only the first n results
- skip int? (default ()) - Skips the first n results
Return Type
- Dashboards|error - OK
reportsGetreportsingroupasadmin![](/images/permalink.svg)
function reportsGetreportsingroupasadmin(string groupId, string? filter, int? top, int? skip) returns Reports|error
Returns a list of reports from the specified workspace.
Parameters
- groupId string - The workspace id
- filter string? (default ()) - Filters the results, based on a boolean condition
- top int? (default ()) - Returns only the first n results
- skip int? (default ()) - Skips the first n results
datasetsGetdatasetsingroupasadmin![](/images/permalink.svg)
function datasetsGetdatasetsingroupasadmin(string groupId, string? filter, int? top, int? skip, string? expand) returns Datasets|error
Returns a list of datasets from the specified workspace.
Parameters
- groupId string - The workspace id
- filter string? (default ()) - Filters the results, based on a boolean condition
- top int? (default ()) - Returns only the first n results
- skip int? (default ()) - Skips the first n results
- expand string? (default ()) - Expands related entities inline
datasetsGetdatasettodataflowslinksingroupasadmin![](/images/permalink.svg)
function datasetsGetdatasettodataflowslinksingroupasadmin(string groupId) returns DatasetToDataflowLinksResponse|error
Returns a list of upstream dataflows for datasets from the specified workspace.
Parameters
- groupId string - The workspace id
Return Type
dataflowsGetdataflowsingroupasadmin![](/images/permalink.svg)
function dataflowsGetdataflowsingroupasadmin(string groupId, string? filter, int? top, int? skip) returns Dataflows|error
Returns a list of dataflows from the specified workspace.
Parameters
- groupId string - The workspace id
- filter string? (default ()) - Filters the results, based on a boolean condition
- top int? (default ()) - Returns only the first n results
- skip int? (default ()) - Skips the first n results
reportsGetreportsasadmin![](/images/permalink.svg)
Returns a list of reports for the organization.
Parameters
- filter string? (default ()) - Filters the results, based on a boolean condition
- top int? (default ()) - Returns only the first n results
- skip int? (default ()) - Skips the first n results
dashboardsGetdashboardsasadmin![](/images/permalink.svg)
function dashboardsGetdashboardsasadmin(string? expand, string? filter, int? top, int? skip) returns Dashboards|error
Returns a list of dashboards for the organization.
Parameters
- expand string? (default ()) - Expands related entities inline, receives a comma-separated list of data types. Supported: tiles
- filter string? (default ()) - Filters the results, based on a boolean condition
- top int? (default ()) - Returns only the first n results
- skip int? (default ()) - Skips the first n results
Return Type
- Dashboards|error - OK
dashboardsGettilesasadmin![](/images/permalink.svg)
Returns a list of tiles within the specified dashboard.
Parameters
- dashboardId string - The dashboard id
importsGetimportsasadmin![](/images/permalink.svg)
function importsGetimportsasadmin(string? expand, string? filter, int? top, int? skip) returns Imports|error
Returns a list of imports for the organization.
Parameters
- expand string? (default ()) - Expands related entities inline
- filter string? (default ()) - Filters the results, based on a boolean condition
- top int? (default ()) - Returns only the first n results
- skip int? (default ()) - Skips the first n results
adminGetpowerbiencryptionkeys![](/images/permalink.svg)
function adminGetpowerbiencryptionkeys() returns TenantKeys|error
Returns the encryption keys for the tenant.
Return Type
- TenantKeys|error - OK
adminAddpowerbiencryptionkey![](/images/permalink.svg)
function adminAddpowerbiencryptionkey(TenantKeyCreationRequest payload) returns TenantKey|error
Adds an encryption key for Power BI workspaces assigned to a capacity.
Parameters
- payload TenantKeyCreationRequest - Tenant key information
adminRotatepowerbiencryptionkey![](/images/permalink.svg)
function adminRotatepowerbiencryptionkey(string tenantKeyId, TenantKeyRotationRequest payload) returns TenantKey|error
Rotate the encryption key for Power BI workspaces assigned to a capacity.
Parameters
- tenantKeyId string - Tenant key id
- payload TenantKeyRotationRequest - Tenant key information
adminGetcapacitiesasadmin![](/images/permalink.svg)
function adminGetcapacitiesasadmin(string? expand) returns Capacities|error
Returns a list of capacities for the organization.
Parameters
- expand string? (default ()) - Expands related entities inline
Return Type
- Capacities|error - OK
adminPatchcapacityasadmin![](/images/permalink.svg)
function adminPatchcapacityasadmin(string capacityId, CapacityPatchRequest payload) returns Response|error
Changes the specific capacity information. Currently, only supports changing the capacity encryption key
Parameters
- capacityId string - The capacity Id
- payload CapacityPatchRequest - Patch capacity information
adminGetrefreshables![](/images/permalink.svg)
function adminGetrefreshables(int top, string? expand, string? filter, int? skip) returns Refreshables|error
Returns a list of refreshables for the organization within a capacity
Parameters
- top int - Returns only the first n results.
- expand string? (default ()) - Expands related entities inline, receives a comma-separated list of data types. Supported: capacities and groups
- filter string? (default ()) - Filters the results based on a boolean condition
- skip int? (default ()) - Skips the first n results. Use with top to fetch results beyond the first 1000.
Return Type
- Refreshables|error - OK
adminGetrefreshablesforcapacity![](/images/permalink.svg)
function adminGetrefreshablesforcapacity(string capacityId, int top, string? expand, string? filter, int? skip) returns Refreshables|error
Returns a list of refreshables for the specified capacity the user has access to
Parameters
- capacityId string - The capacity id
- top int - Returns only the first n results.
- expand string? (default ()) - Expands related entities inline, receives a comma-separated list of data types. Supported: capacities and groups
- filter string? (default ()) - Filters the results based on a boolean condition
- skip int? (default ()) - Skips the first n results. Use with top to fetch results beyond the first 1000.
Return Type
- Refreshables|error - OK
adminGetrefreshableforcapacity![](/images/permalink.svg)
function adminGetrefreshableforcapacity(string capacityId, string refreshableId, string? expand) returns Refreshables|error
Returns the specified refreshable for the specified capacity the user has access to
Parameters
- capacityId string - The capacity id
- refreshableId string - The refreshable id
- expand string? (default ()) - Expands related entities inline, receives a comma-separated list of data types. Supported: capacities and groups
Return Type
- Refreshables|error - OK
dataflowsGetdataflowsasadmin![](/images/permalink.svg)
Returns a list of dataflows for the organization.
Parameters
- filter string? (default ()) - Filters the results, based on a boolean condition
- top int? (default ()) - Returns only the first n results
- skip int? (default ()) - Skips the first n results
dataflowsExportdataflowasadmin![](/images/permalink.svg)
Exports the specified dataflow definition to a .json file.
Parameters
- dataflowId string - The dataflow id
dataflowsGetdataflowdatasourcesasadmin![](/images/permalink.svg)
function dataflowsGetdataflowdatasourcesasadmin(string dataflowId) returns Datasources|error
Returns a list of datasources for the specified dataflow.
Parameters
- dataflowId string - The dataflow id
Return Type
- Datasources|error - OK
embedtokenGeneratetoken![](/images/permalink.svg)
function embedtokenGeneratetoken(GenerateTokenRequestV2 payload) returns EmbedToken|error
Generates an embed token for multiple reports, datasets and target workspaces. Reports and datasets do not have to be related. The binding of a report to a dataset can be done during embedding. Creating a report can only be done in workspaces specified in targetWrokspaces.
This API is relevant only to 'App owns data' embed scenario. For more information about using this API, see Considerations when generating an embed token.
Parameters
- payload GenerateTokenRequestV2 - Generate token parameters
Return Type
- EmbedToken|error - OK
adminGetactivityevents![](/images/permalink.svg)
function adminGetactivityevents(string? startDateTime, string? endDateTime, string? continuationToken, string? filter) returns ActivityEventResponse|error
Returns a list of audit activity events for a tenant.
Parameters
- startDateTime string? (default ()) - Start date and time of the window for audit event results. Must be in ISO 8601 compliant UTC format.
- endDateTime string? (default ()) - End date and time of the window for audit event results. Must be in ISO 8601 compliant UTC format.
- continuationToken string? (default ()) - Token required to get the next chunk of the result set
- filter string? (default ()) - Filters the results based on a boolean condition, using 'Activity', 'UserId', or both properties. Supports only 'eq' and 'and' operators.
Return Type
informationprotectionRemovelabelsasadmin![](/images/permalink.svg)
function informationprotectionRemovelabelsasadmin(InformationProtectionArtifactsChangeLabel payload) returns InformationProtectionChangeLabelResponse|error
Remove sensitivity labels from artifacts by artifact ID.
Parameters
- payload InformationProtectionArtifactsChangeLabel - Composite of artifact Id lists per Type.
Return Type
informationprotectionSetlabelsasadmin![](/images/permalink.svg)
function informationprotectionSetlabelsasadmin(InformationProtectionChangeLabelDetails payload) returns InformationProtectionChangeLabelResponse|error
Set sensitivity labels on content in Power BI by artifact ID.
Parameters
- payload InformationProtectionChangeLabelDetails - Set label details.
Return Type
templateappsCreateinstallticket![](/images/permalink.svg)
function templateappsCreateinstallticket(CreateInstallTicketRequest payload) returns InstallTicket|error
Generates an installation ticket for Template Apps automated install flow.
Parameters
- payload CreateInstallTicketRequest - Create Install Ticket parameters
Return Type
- InstallTicket|error - OK
reportsTakeoveringroup![](/images/permalink.svg)
Transfers ownership over the specified paginated report datasources to the current authorized user.
Records![](/images/permalink.svg)
power.bi: ActivityEventResponse![](/images/permalink.svg)
Odata response wrapper for audit activity events list
Fields
- activityEventEntities Object[]? - The activity event entities
- continuationUri string? - Uri to get the next chunk of the result set
- continuationToken string? - Token to get the next chunk of the result set
power.bi: AddDashboardRequest![](/images/permalink.svg)
Power BI add dashboard request
Fields
- name string - The name of the new dashboard
power.bi: AdditionalFeatureInfo![](/images/permalink.svg)
Additional feature information
Fields
- Usage int? - The token generation usage (in %) from the limitation on shared capacity
power.bi: App![](/images/permalink.svg)
A Power BI Installed App
Fields
- id string - The app id
- name string? - The app name
- description string? - The app description
- lastUpdate string? - The last time the app was updated
- publishedBy string? - The app publisher
power.bi: Apps![](/images/permalink.svg)
Odata response wrapper for a Power BI installed App list
Fields
- value App[]? - The installed apps
power.bi: ArtifactId![](/images/permalink.svg)
Unique artifact ID: uuid format for dashboards/reports/dataflows.
Fields
- id string - ID
power.bi: ArtifactStringId![](/images/permalink.svg)
Unique artifact ID: string format (can be uuid) for datasets.
Fields
- id string - ID
power.bi: AssignToCapacityRequest![](/images/permalink.svg)
Power BI assign to capacity request
Fields
- capacityId string - The capacity id. To unassign from capacity, use Empty Guid (00000000-0000-0000-0000-000000000000).
power.bi: AssignToDataflowStorageRequest![](/images/permalink.svg)
Power BI assign to Power BI dataflow storage account request
Fields
- dataflowStorageId string - The Power BI dataflow storage account id. To unassign the specified workspace from a Power BI dataflow storage account, an empty GUID (00000000-0000-0000-0000-000000000000) should be provided as dataflowStorageId.
power.bi: AssignWorkspacesToCapacityRequest![](/images/permalink.svg)
Request body for assigning workspaces to a premium capacity as tenant admin
Fields
- capacityMigrationAssignments CapacityMigrationAssignment[] - Assignment contract for migrating workspaces to premium capacity as tenant admin
power.bi: AvailableFeature![](/images/permalink.svg)
Power BI available feature
Fields
- name string - The feature name
- state string - The feature state
- extendedState string - The feature extended state
- additionalInfo AdditionalFeatureInfo? - Additional feature information
power.bi: AvailableFeatures![](/images/permalink.svg)
Odata response wrapper for a Power BI available features list
Fields
- features AvailableFeature[]? - The available features list
power.bi: BindToGatewayRequest![](/images/permalink.svg)
The bind dataset to gateway request
Fields
- gatewayObjectId string - The gateway id
- datasourceObjectIds string[]? - datasourceObjectIds belonging to the gateway
power.bi: Capacities![](/images/permalink.svg)
Odata response wrapper for a Power BI capacity list
Fields
- value Capacity[]? - The Capacity List
power.bi: Capacity![](/images/permalink.svg)
A Power BI capacity
Fields
- id string - The capacity id
- displayName string? - The capacity display name
- admins string[]? - An array of capacity admins.
- sku string? - The capacity SKU.
- state string - The capacity state
- capacityUserAccessRight string - Access right user has on the capacity
- region string? - The Azure region where the capacity is provisioned
- tenantKeyId string? - The id of the encryption key (Only applicable for admin route)
- tenantKey TenantKey? - Encryption key information
power.bi: CapacityMigrationAssignment![](/images/permalink.svg)
Assignment contract for migrating workspaces to shared capacity as tenant admin
Fields
- workspacesToAssign string[] - Workspaces to be migrated to shared capacity
- targetCapacityObjectId string - Capacity id
power.bi: CapacityPatchRequest![](/images/permalink.svg)
Patch capacity request
Fields
- tenantKeyId string? - The id of the encryption key
power.bi: ChangeLabelStatus![](/images/permalink.svg)
Artifact ID with information protection label status
Fields
- id string - Unique artifact Id, uuid format for dashboard/report/dataflow, and string format for dataset.
- status string - Indicates the result of the label change operation
power.bi: ClientHttp1Settings![](/images/permalink.svg)
Provides settings related to HTTP/1.x protocol.
Fields
- keepAlive KeepAlive(default http:KEEPALIVE_AUTO) - Specifies whether to reuse a connection for multiple requests
- chunking Chunking(default http:CHUNKING_AUTO) - The chunking behaviour of the request
- proxy ProxyConfig? - Proxy server related options
power.bi: CloneReportRequest![](/images/permalink.svg)
Power BI clone report request
Fields
- name string - The new report name
- targetWorkspaceId string? - Optional parameter for specifying the target workspace id. Empty Guid (00000000-0000-0000-0000-000000000000) indicates 'My Workspace'. <br/>If not provided, the new report will be cloned within the same workspace as the source report.
- targetModelId string? - Optional parameter for specifying the target associated dataset id. <br/>If not provided, the new report will be associated with the same dataset as the source report
power.bi: CloneTileRequest![](/images/permalink.svg)
Power BI clone tile request
Fields
- targetDashboardId string - The target dashboard id
- targetWorkspaceId string? - Optional parameter for specifying the target workspace id. Empty Guid (00000000-0000-0000-0000-000000000000) indicates 'My Workspace'. <br/>If not provided, tile will be cloned within the same workspace as the source tile.
- targetReportId string? - Optional parameter <br/>When cloning a tile linked to a report, pass the target report id to rebind the new tile to a different report.
- targetModelId string? - Optional parameter <br/>When cloning a tile linked to a dataset, pass the target model id to rebind the new tile to a different dataset.
- positionConflictAction string? - Optional parameter for specifying the action in case of position conflict. <br/>If not provided, 'Tail' is used. <br/>If there is no conflict, clone tile to same position as in source.
power.bi: Column![](/images/permalink.svg)
A dataset column
Fields
- name string - The column name
- dataType string - The column data type
- formatString string? - (Optional) The format of the column as specified in FORMAT_STRING
- sortByColumn string? - (Optional) String name of a column in the same table to be used to order the current column
- dataCategory string? - (Optional) String value to be used for the data category which describes the data within this column
- isHidden boolean? - (Optional) Property indicating if the column is hidden from view. Default is false.
- summarizeBy string? - (Optional) Aggregate Function to use for summarizing this column
power.bi: ConnectionConfig![](/images/permalink.svg)
Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.
Fields
- auth BearerTokenConfig - Configurations related to client authentication
- httpVersion HttpVersion(default http:HTTP_2_0) - The HTTP version understood by the client
- http1Settings ClientHttp1Settings? - Configurations related to HTTP/1.x protocol
- http2Settings ClientHttp2Settings? - Configurations related to HTTP/2 protocol
- timeout decimal(default 60) - The maximum time to wait (in seconds) for a response before closing the connection
- forwarded string(default "disable") - The choice of setting
forwarded
/x-forwarded
header
- poolConfig PoolConfiguration? - Configurations associated with request pooling
- cache CacheConfig? - HTTP caching related configurations
- compression Compression(default http:COMPRESSION_AUTO) - Specifies the way of handling compression (
accept-encoding
) header
- circuitBreaker CircuitBreakerConfig? - Configurations associated with the behaviour of the Circuit Breaker
- retryConfig RetryConfig? - Configurations associated with retrying
- responseLimits ResponseLimitConfigs? - Configurations associated with inbound response size limits
- secureSocket ClientSecureSocket? - SSL/TLS-related options
- proxy ProxyConfig? - Proxy server related options
- validation boolean(default true) - Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default
power.bi: ConnectionDetails![](/images/permalink.svg)
Connection string wrapper.
Fields
- connectionString string - A dataset connection string.
power.bi: CreateDatasetRequest![](/images/permalink.svg)
A Power BI dataset
Fields
- name string - The dataset name
- tables Table[] - The dataset tables.
- relationships Relationship[]? - The dataset relationships.
- datasources Datasource[]? - The datasources associated with this dataset.
- defaultMode string? - The dataset mode or type.
power.bi: CreateInstallTicketRequest![](/images/permalink.svg)
Power BI Create Install Ticket Request
Fields
- installDetails TemplateAppInstallDetails[]? - List of install details
power.bi: CredentialDetails![](/images/permalink.svg)
The credential details
Fields
- credentials string - The credentials. Depends on the 'credentialType' value. See Update Datasource Examples.
- credentialType string - The credential type
- encryptedConnection string - User input for this attribute is currently ignored. Today, regardless of the provided value, we always try to establish an encrypted connection first but fall back to an unencrypted option in case of a failure. <br/>This will be fixed for the following data source types with the June 2019 gateway release causing a value of Encrypted to try only an encrypted connection and NotEncrypted with an unencrypted connection and there would be no fallback behavior <ul><li>Impala</li><li>MySql</li><li>DB2</li><li>Netezza</li><li>PostgreSQL</li><li>Sybase</li><li>Teradata</li><li>GoogleBigQuery</li><li>Amazon Redshift</li></ul>
- encryptionAlgorithm string - The encryption algorithm. For cloud datasource, use 'None'. For on-premises datasource, use gateway public key with 'RSA-OAEP' algorithm.
- privacyLevel string - The privacy level. Relevant when combining data from multiple sources.
- useCallerAADIdentity boolean? - Should the caller's AAD identity be used for OAuth2 credentials configuration
- useEndUserOAuth2Credentials boolean? - Should the end-user OAuth2 credentials be used for connecting to the datasource in DirectQuery mode. Only supported for Direct Query to SQL Azure.
power.bi: Dashboard![](/images/permalink.svg)
A Power BI dashboard. Below is a list of properties that may be returned for a dashboard. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database.
Fields
- id string - The dashboard id
- displayName string? - The dashboard display name
- isReadOnly boolean? - Is ReadOnly dashboard
- embedUrl string? - The dashboard embed url
- tiles Tile[]? - The tiles that belong to the dashboard.
- dataClassification string? - The data classification tag of the dashboard
- sensitivityLabel SensitivityLabel? - Artifact sensitivity label info
power.bi: Dashboards![](/images/permalink.svg)
Odata response wrapper for a Power BI dashboard collection
Fields
- value Dashboard[]? - The dashboard collection
power.bi: Dataflow![](/images/permalink.svg)
The metadata of a dataflow. Below is a list of properties that may be returned for a dataflow. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database.
Fields
- objectId string - The dataflow id
- name string? - The dataflow name
- description string? - The dataflow description
- modelUrl string? - A URL to the dataflow definition file (model.json)
- configuredBy string? - The dataflow owner
- modifiedBy string? - The user that modified this dataflow
- endorsementDetails EndorsementDetails? - Power BI endorsement details
- modifiedDateTime string? - modification date time
- datasourceUsages DatasourceUsage[]? - Datasource usages
- upstreamDataflows DependentDataflow[]? - Upstream Dataflows
- sensitivityLabel SensitivityLabel? - Artifact sensitivity label info
power.bi: Dataflows![](/images/permalink.svg)
Odata response wrapper for a dataflow metadata list
Fields
- value Dataflow[]? - The dataflow metadata List
power.bi: DataflowStorageAccount![](/images/permalink.svg)
A Power BI dataflow storage account
Fields
- id string - The Power BI dataflow storage account id
- name string? - The Power BI dataflow storage account name
- isEnabled boolean - Indicates if workspaces can be assigned to this storage account
power.bi: DataflowStorageAccounts![](/images/permalink.svg)
Odata response wrapper for Power BI dataflow storage account list
Fields
- value DataflowStorageAccount[]? - The Power BI dataflow storage account list
power.bi: DataflowTransaction![](/images/permalink.svg)
A Power BI dataflow transaction
Fields
- id string - The transaction id
- refreshType string? - The type of refresh transaction
- startTime string? - Start time of the transaction
- endTime string? - End time of the transaction
- status string? - Status of the transaction
power.bi: DataflowTransactions![](/images/permalink.svg)
A dataflow transaction odata list wrapper
Fields
- value DataflowTransaction[]? - The dataflow transactions
power.bi: DataflowTransactionStatus![](/images/permalink.svg)
Status of dataflow refresh transaction
Fields
- transactionId string? - Transaction id
- status string? - Status of transaction
power.bi: DataflowUpdateRequestMessage![](/images/permalink.svg)
Request payload for updating dataflow information
Fields
- name string? - New name of the dataflow
- description string? - New description for the dataflow
- allowNativeQueries boolean? - Allow native queries
- computeEngineBehavior string? - Compute Engine Behavior
power.bi: Dataset![](/images/permalink.svg)
A Power BI dataset. Below is a list of properties that may be returned for a dataset. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database.
Fields
- id string - The dataset id
- name string? - The dataset name
- configuredBy string? - The dataset owner
- addRowsAPIEnabled boolean? - Whether the dataset allows adding new rows
- webUrl string? - The dataset web url
- IsRefreshable boolean? - Can this dataset be refreshed
- IsEffectiveIdentityRequired boolean? - Whether the dataset requires an effective identity. This indicates that you must send an effective identity using the GenerateToken API.
- IsEffectiveIdentityRolesRequired boolean? - Whether RLS is defined inside the PBIX file. This indicates that you must specify a role.
- IsOnPremGatewayRequired boolean? - Dataset requires an On-premises Data Gateway
- Encryption Encryption? - Encryption information for a dataset
- CreatedDate string? - DateTime of creation of this dataset
- ContentProviderType string? - The content provider type for the dataset
- CreateReportEmbedURL string? - The dataset create report embed url
- QnaEmbedURL string? - The dataset qna embed url
- description string? - The dataset description
- endorsementDetails EndorsementDetails? - Power BI endorsement details
- datasourceUsages DatasourceUsage[]? - Datasource usages
- upstreamDataflows DependentDataflow[]? - Upstream Dataflows
- sensitivityLabel SensitivityLabel? - Artifact sensitivity label info
power.bi: Datasets![](/images/permalink.svg)
A dataset odata list wrapper
Fields
- value Dataset[]? - The datasets
power.bi: DatasetToDataflowLinkResponse![](/images/permalink.svg)
A Power BI dataset to dataflow link
Fields
- datasetObjectId string? - The dataset object id
- dataflowObjectId string? - The dataflow object id
- workspaceObjectId string? - The workspace object id
power.bi: DatasetToDataflowLinksResponse![](/images/permalink.svg)
Odata response wrapper for a Power BI dataset to dataflow links list
Fields
- value DatasetToDataflowLinkResponse[]? - The dataset to dataflow links
power.bi: Datasource![](/images/permalink.svg)
A Power BI datasource
Fields
- name string? - (Deprecated) The datasource name. Available only for DirectQuery.
- connectionString string? - (Deprecated) The datasource connection string. Available only for DirectQuery.
- datasourceType string? - The datasource type
- connectionDetails DatasourceConnectionDetails? - A Power BI datasource connection details
- gatewayId string? - The bound gateway id. Empty when not bound to a gateway.
- datasourceId string? - The bound datasource id. Empty when not bound to a gateway.
power.bi: DatasourceConnectionDetails![](/images/permalink.svg)
A Power BI datasource connection details
Fields
- server string? - The connection server.
- database string? - The connection database.
- url string? - The connection url
power.bi: Datasources![](/images/permalink.svg)
Odata response wrapper for a Power BI datasource collection
Fields
- value Datasource[]? - The datasource collection
power.bi: DatasourceUsage![](/images/permalink.svg)
Datasource usage
Fields
- datasourceInstanceId string - The datasource instance ID
power.bi: DatasourceUser![](/images/permalink.svg)
A Power BI user access right entry for datasource
Fields
- datasourceAccessRight string - The user access rights for the datasource.
- emailAddress string? - Email address of the user
- displayName string? - Display name of the principal
- principalType string? - The principal type
power.bi: DatasourceUsers![](/images/permalink.svg)
Odata response wrapper for a Power BI user access right for datasource List
Fields
- value DatasourceUser[]? - The user access right for datasource List
power.bi: DelegatedUser![](/images/permalink.svg)
Delegated user details. The user must be an existing user in Power BI and Azure AAD, who has signed in to Power BI during the last 3 months.
Fields
- emailAddress string - Delegated user email address.
power.bi: DependentDataflow![](/images/permalink.svg)
A Power BI Dependent dataflow
Fields
- targetDataflowId string? - The target dataflow id
- groupId string? - The target group id
power.bi: DependentDataflows![](/images/permalink.svg)
Odata response wrapper for a Power BI dependent dataflows list
Fields
- value DependentDataflow[]? - The dependent dataflows
power.bi: DirectQueryRefreshSchedule![](/images/permalink.svg)
A Power BI refresh schedule for DirectQuery or LiveConnection, specified by setting either the frequency or a combination of days and times.
Fields
- frequency int? - the refresh frequency in minutes, supported values are 15, 30, 60, 120, and 180.
- days string[]? - Days to execute the refresh
- times string[]? - Times to execute the refresh within each day
- localTimeZoneId string? - The Id of the Time zone to use. See Time Zone Info.
power.bi: DirectQueryRefreshScheduleRequest![](/images/permalink.svg)
Power BI refresh schedule request for DirectQuery or LiveConnection
Fields
- value DirectQueryRefreshSchedule - A Power BI refresh schedule for DirectQuery or LiveConnection, specified by setting either the frequency or a combination of days and times.
power.bi: EffectiveIdentity![](/images/permalink.svg)
Defines the user identity and roles, for more details see this article
Fields
- username string - The effective username reflected by a token for applying RLS rules (For OnPrem model, username can be composed of alpha-numerical characters or any of the following characters '.', '-', '_', '!', '#', '^', '~', '\', '@', also username cannot contain spaces. For Cloud model, username can be composed of all ASCII characters. username must be up to 256 characters)
- datasets string[]? - An array of datasets for which this identity applies
- roles string[]? - An array of RLS roles reflected by a token when applying RLS rules (identity can contain up to 50 roles, role can be composed of any character besides ',' and must be up to 50 characters)
- customData string? - The value of customdata to be used for applying RLS rules. Only supported for live connections to Azure Analysis Services.
- identityBlob IdentityBlob? - A blob for specifying the identity. Only supported for datasets with Direct Query connection to SQL Azure
- reports string[]? - An array of reports for which this identity applies, Only supported for paginated reports
power.bi: EmbedToken![](/images/permalink.svg)
Power BI embed token
Fields
- token string - Embed token
- tokenId string - Unique token Id. Can be used to correlate operations that use this token with the generate operation through audit logs.
- expiration string - Expiration time of token. In UTC.
power.bi: Encryption![](/images/permalink.svg)
Encryption information for a dataset
Fields
- EncryptionStatus string? - Dataset encryption status
power.bi: EndorsementDetails![](/images/permalink.svg)
Power BI endorsement details
Fields
- endorsement string? - The endorsement status
- certifiedBy string? - The user that certified the artifact
power.bi: Export![](/images/permalink.svg)
An object describing Export to file details and current state
Fields
- id string? - The Export to file job ID
- createdDateTime string? - The start time of the Export to file job
- lastActionDateTime string? - The time of last change in the Export to file job
- reportId string? - The ID of the exported report
- reportName string? - The name of the exported report
- status string? - The current state of the Export to file job
- percentComplete int? - Indicate job progress as percentage
- resourceLocation string? - The URL for retrieving the exported file
- ResourceFileExtension string? - The extension of the exported file
- expirationTime string? - The expiration time of the URL
power.bi: ExportFilter![](/images/permalink.svg)
A filter to be applied during the export operation
Fields
power.bi: ExportReportPage![](/images/permalink.svg)
A single page configuration for the export request
Fields
- pageName string - The page name
- visualName string? - Visual name to be exported. Should be provided in case only a single visual from this page is exported
- bookmark PageBookmark? - The bookmark to apply on a single page. Provide name or state, but not both.
power.bi: ExportReportRequest![](/images/permalink.svg)
The Export to file request
Fields
- format string - Export to file format
- powerBIReportConfiguration PowerBIReportExportConfiguration? - Power BI report Export to file configuration
- paginatedReportConfiguration PaginatedReportExportConfiguration? - Paginated report Export to file configuration
power.bi: ExportReportSettings![](/images/permalink.svg)
Export to file request settings
Fields
- locale string? - The locale to apply
- includeHiddenPages boolean? - A flag indicating whether to include hidden pages when exporting the entire report (when passing specific pages this property will be ignored). If not provided, the default behavior is to exclude hidden pages
power.bi: Gateway![](/images/permalink.svg)
A Power BI gateway
Fields
- id string - The gateway id
- name string? - The gateway name
- 'type string? - The gateway type
- gatewayAnnotation string? - Gateway metadata in json format
- publicKey GatewayPublicKey? - A Power BI gateway public key
- gatewayStatus string? - The gateway connectivity status
power.bi: GatewayDatasource![](/images/permalink.svg)
A Power BI gateway datasource
Fields
- id string - The unique id for this datasource
- gatewayId string - The associated gateway id
- datasourceName string? - The name of the datasource
- datasourceType string? - The type of the datasource
- connectionDetails string? - Connection details in json format
- credentialType string - Type of the datasource credentials
power.bi: GatewayDatasources![](/images/permalink.svg)
Odata response wrapper for a Power BI gateway datasource collection
Fields
- value GatewayDatasource[]? - List of gateway datasources
power.bi: GatewayPublicKey![](/images/permalink.svg)
A Power BI gateway public key
Fields
- exponent string? - The public key exponent
- modulus string? - The public key modulus
power.bi: Gateways![](/images/permalink.svg)
Odata response wrapper for a Power BI gateways list
Fields
- value Gateway[]? - The gateways
power.bi: GenerateTokenRequest![](/images/permalink.svg)
Power BI Generate Token Request
Fields
- accessLevel string? - Required access level for EmbedToken generation
- datasetId string? - Dataset id for report creation. Only applies when generating EmbedToken for report creation.
- allowSaveAs boolean? - Indicates an embedded report can be saved as a new report. Default value is 'false'. Only applies when generating EmbedToken for report embedding.
- identities EffectiveIdentity[]? - List of identities to use for RLS rules.
power.bi: GenerateTokenRequestV2![](/images/permalink.svg)
Power BI Generate Token Request V2
Fields
- datasets GenerateTokenRequestV2Dataset[]? - List of datasets
- reports GenerateTokenRequestV2Report[]? - List of reports
- targetWorkspaces GenerateTokenRequestV2TargetWorkspace[]? - List of workspaces Embed Token allows saving to
- identities EffectiveIdentity[]? - List of identities to use for RLS rules.
power.bi: GenerateTokenRequestV2Dataset![](/images/permalink.svg)
The dataset object for Generate Token Request V2.
Fields
- id string - Dataset Id
power.bi: GenerateTokenRequestV2Report![](/images/permalink.svg)
The report object for Generate Token Request V2.
Fields
- allowEdit boolean? - Indicates that the generated EmbedToken grand editing for this report
- id string - Report Id
power.bi: GenerateTokenRequestV2TargetWorkspace![](/images/permalink.svg)
The workspace object for Generate Token Request V2.
Fields
- id string - Workspace Id
power.bi: Group![](/images/permalink.svg)
A Power BI group
Fields
- id string - The workspace id
- name string? - The group name
- isReadOnly boolean? - Is the group read only
- isOnDedicatedCapacity boolean? - Is the group on dedicated capacity
- capacityId string? - The capacity id
- description string? - The group description. Available only for admin API calls.
- 'type string? - The type of group. Available only for admin API calls.
- state string? - The group state. Available only for admin API calls.
- users GroupUser[]? - The users that belong to the group, and their access rights. Available only for admin API calls.
- reports Report[]? - The reports that belong to the group. Available only for admin API calls.
- dashboards Dashboard[]? - The dashboards that belong to the group. Available only for admin API calls.
- datasets Dataset[]? - The datasets that belong to the group. Available only for admin API calls.
- dataflows Dataflow[]? - The dataflows that belong to the group. Available only for admin API calls.
- dataflowStorageId string? - The Power BI dataflow storage account id
- workbooks Workbook[]? - The workbooks that belong to the group. Available only for admin API calls.
power.bi: GroupCreationRequest![](/images/permalink.svg)
Power BI create a new group request
Fields
- name string - The name of the newly created group
power.bi: GroupRestoreRequest![](/images/permalink.svg)
Power BI request to restore a deleted group
Fields
- name string? - The name of the group to be restored.
- emailAddress string - The email address of the owner of the group to be restored.
power.bi: Groups![](/images/permalink.svg)
Odata response wrapper for a Power BI group list
Fields
- value Group[]? - The groups
power.bi: GroupUser![](/images/permalink.svg)
A Power BI user access right entry for workspace
Fields
- groupUserAccessRight string - Access rights user has for the workspace
- emailAddress string? - Email address of the user
- displayName string? - Display name of the principal
- principalType string? - The principal type
power.bi: GroupUsers![](/images/permalink.svg)
Odata response wrapper for a Power BI user access right for group List
Fields
- value GroupUser[]? - The user access right for group List
power.bi: IdentityBlob![](/images/permalink.svg)
A blob for specifying the identity. Only supported for datasets with Direct Query connection to SQL Azure
Fields
- value string - OAuth2 access token for SQL Azure
power.bi: Import![](/images/permalink.svg)
The import object
Fields
- id string - The import id
- name string? - The import name
- importState string? - The import upload state
- reports Report[]? - The reports associated with this import
- datasets Dataset[]? - The datasets associated with this import
- createdDateTime string? - Import creation time
- updatedDateTime string? - Import last update time
power.bi: ImportInfo![](/images/permalink.svg)
The information about the import
Fields
- filePath string? - The OneDrive for Business .xlsx file path to import, can be absolute or relative. .pbix files are not supported.
- connectionType string? - The import connection type for OneDrive for Business file
- fileUrl string? - The shared access signature (SAS) url of the temporary blob storage, used to import large .pbix files between 1 GB and 10 GB
power.bi: Imports![](/images/permalink.svg)
Odata response wrapper for a Power BI import collection
Fields
- value Import[]? - The imports collection
power.bi: InformationProtectionArtifactsChangeLabel![](/images/permalink.svg)
Composite of artifact IDs that will be used to update the information protection labels of those artifacts.
Fields
- dashboards ArtifactId[]? - List of unique dashboard IDs.
- reports ArtifactId[]? - List of unique report IDs.
- datasets ArtifactStringId[]? - List of unique dataset IDs.
- dataflows ArtifactId[]? - List of unique dataflow IDs.
power.bi: InformationProtectionChangeLabelDetails![](/images/permalink.svg)
Set label details.
Fields
- artifacts InformationProtectionArtifactsChangeLabel - Composite of artifact IDs that will be used to update the information protection labels of those artifacts.
- labelId string - Label ID (must be in the user’s policy).
- delegatedUser DelegatedUser? - Delegated user details. The user must be an existing user in Power BI and Azure AAD, who has signed in to Power BI during the last 3 months.
- assignmentMethod string? - Specifies whether the assigned label is to be regarded as having been set manually or as the result of automatic labeling. (default value is Standard).
power.bi: InformationProtectionChangeLabelResponse![](/images/permalink.svg)
Composite of artifact IDs and label change status.
Fields
- dashboards ChangeLabelStatus[]? - List of unique dashboard IDs with label change status.
- reports ChangeLabelStatus[]? - List of unique report IDs with label change status.
- dataflows ChangeLabelStatus[]? - List of unique dataflow IDs with label change status.
- datasets ChangeLabelStatus[]? - List of unique dataset IDs with label change status.
power.bi: InstallTicket![](/images/permalink.svg)
Power BI Template Apps automated install token
Fields
- ticket string - Install ticket
- ticketId string - Unique ticket Id. Can be used to correlate operations that use this ticket with the generate operation through audit logs.
- expiration string - Expiration time of token. In UTC.
power.bi: MashupParameter![](/images/permalink.svg)
Power BI dataset parameter
Fields
- name string - The parameter name
- 'type string - The parameter type
- currentValue string? - The parameter current value
- isRequired boolean - Is dataset parameter required
- suggestedValues string[]? - List of the parameter suggested values
power.bi: MashupParameters![](/images/permalink.svg)
Odata response wrapper for a Power BI dataset parameter list
Fields
- value MashupParameter[]? - The dataset parameter List
power.bi: Measure![](/images/permalink.svg)
A Power BI measure
Fields
- name string - The measure name
- expression string - A valid DAX expression
- formatString string? - (Optional) A string describing how the value should be formatted when it is displayed as specified in FORMAT_STRING
- description string? - (Optional) Measure description
- isHidden boolean? - (Optional) Is measure hidden
power.bi: ModifiedWorkspace![](/images/permalink.svg)
A modified workspace
Fields
- Id string - The workspace object ID.
power.bi: ModifiedWorkspaces![](/images/permalink.svg)
Odata response wrapper for modified workspaces list
Fields
- value ModifiedWorkspace[]? - The modified workspaces list
power.bi: Object![](/images/permalink.svg)
power.bi: Page![](/images/permalink.svg)
A Power BI report page
Fields
- name string? - The page name
- displayName string? - The page display name
- 'order int? - The page order
power.bi: PageBookmark![](/images/permalink.svg)
The bookmark to apply on a single page. Provide name or state, but not both.
Fields
- name string? - The bookmark name
- state string? - The bookmark state
power.bi: Pages![](/images/permalink.svg)
Odata response wrapper for a Power BI page collection
Fields
- value Page[]? - The page collection
power.bi: PaginatedReportExportConfiguration![](/images/permalink.svg)
Paginated report Export to file configuration
Fields
- identities EffectiveIdentity[]? - A single identity to use when exporting a report. Required when a report uses a Power BI dataset or an Azure AS datasource.
- formatSettings record {}? - Dictionary of format settings. The keys are the device info property names for the requested file format.
- parameterValues ParameterValue[]? - List of report parameters
power.bi: ParameterValue![](/images/permalink.svg)
Data contract for paginated report parameters
Fields
- name string? - The parameter name
- value string? - The parameter value
power.bi: PatchWorkloadRequest![](/images/permalink.svg)
Patch workload setting request
Fields
- state WorkloadState - The capacity workload state
- maxMemoryPercentageSetByUser int? - The memory percentage maximum Limit set by the user
power.bi: PostRowsRequest![](/images/permalink.svg)
Fields
- rows Object[]? - An array of data rows pushed to a dataset table
power.bi: PowerBIApiErrorResponseDetail![](/images/permalink.svg)
A Power BI error response details
Fields
- code string? - The error code.
- message string? - The error message.
- target string? - The error target.
power.bi: PowerBIReportExportConfiguration![](/images/permalink.svg)
Power BI report Export to file configuration
Fields
- settings ExportReportSettings? - Export to file request settings
- defaultBookmark PageBookmark? - The bookmark to apply on a single page. Provide name or state, but not both.
- reportLevelFilters ExportFilter[]? - List of report level filters to apply. Currently only one filter can be provided
- pages ExportReportPage[]? - List of pages to export and their properties. The same page may appear more than once with different visuals
- identities EffectiveIdentity[]? - List of identities to use for RLS rules
power.bi: ProxyConfig![](/images/permalink.svg)
Proxy server configurations to be used with the HTTP client endpoint.
Fields
- host string(default "") - Host name of the proxy server
- port int(default 0) - Proxy server port
- userName string(default "") - Proxy server username
- password string(default "") - Proxy server password
power.bi: PublishDatasourceToGatewayRequest![](/images/permalink.svg)
A publish datasource to gateway request
Fields
- dataSourceType string - The datasource type
- connectionDetails string - The connection details
- credentialDetails CredentialDetails - The credential details
- dataSourceName string - The datasource name
power.bi: RdlDatasourceConnectionDetails![](/images/permalink.svg)
A paginated report datasource connection details.
Fields
- server string? - The connection server.
- database string? - The connection database.
power.bi: RebindReportRequest![](/images/permalink.svg)
Power BI rebind report request
Fields
- datasetId string - The new dataset for the rebound report. If the dataset resides in a different workspace than the report, a shared dataset will be created in the report's workspace
power.bi: Refresh![](/images/permalink.svg)
A Power BI refresh history entry
Fields
- refreshType string? - Type of refresh request
- startTime string? - DateTime of start
- endTime string? - DateTime of termination (may be empty if refresh is progress)
- serviceExceptionJson string? - Failure error code in json format (not empty only on error).
- status string? - 'Unknown' - Unknown completion state or refresh is in progress. endTime will be empty with this status. <br/>'Completed' - refresh completed successfully <br/> 'Failed' - Refresh failed. serviceExceptionJson will contain the error. <br/>'Disabled' - Refresh disabled by Selective Refresh.
- requestId string? - The identifier of the Refresh request. <br/>Please provide this identifier in all service requests
power.bi: Refreshable![](/images/permalink.svg)
A Power BI refreshable
Fields
- id string? - Object id of refreshable
- name string? - Display name of refreshable
- kind string? - The refreshable kind
- startTime string? - The start time of the window for which summary data exists
- endTime string? - The end time of the window for which summary data exists
- refreshCount int? - The number of refreshes within the summary time window
- refreshFailures int? - The number of refresh failures within the summary time window
- averageDuration decimal? - The average duration in seconds of a refresh within the summary time window
- medianDuration decimal? - The median duration in seconds of a refresh within the summary time window
- refreshesPerDay int? - The number of refreshes per day within the summary time window
- lastRefresh Refresh? - A Power BI refresh history entry
- refreshSchedule RefreshSchedule? - A Power BI refresh schedule for cached model
- configuredBy string[]? - Refreshable owners
- capacity Capacity? - A Power BI capacity
- group Group? - A Power BI group
power.bi: Refreshables![](/images/permalink.svg)
Power BI refreshable list
Fields
- value Refreshable[]? - The refreshables
power.bi: Refreshes![](/images/permalink.svg)
Odata response wrapper for a Power BI refresh history
Fields
- value Refresh[]? - The Refresh history list
power.bi: RefreshRequest![](/images/permalink.svg)
Power BI refresh request
Fields
- notifyOption string - Mail notification options (success and/or failure, or none)
power.bi: RefreshSchedule![](/images/permalink.svg)
A Power BI refresh schedule for cached model
Fields
- days string[]? - Days to execute the refresh
- times string[]? - Times to execute the refresh within each day
- enabled boolean? - Is the refresh enabled
- localTimeZoneId string? - The Id of the Time zone to use. See Time Zone Info.
- NotifyOption string? - Notification option at scheduled refresh termination
power.bi: RefreshScheduleRequest![](/images/permalink.svg)
Power BI refresh schedule request
Fields
- value RefreshSchedule - A Power BI refresh schedule for cached model
power.bi: Relationship![](/images/permalink.svg)
A relationship between tables in a dataset
Fields
- name string - The relationship name and identifier
- crossFilteringBehavior string(default "OneDirection") - The filter direction of the relationship
- fromTable string - The name of the foreign key table
- fromColumn string - The name of the foreign key column
- toTable string - The name of the primary key table
- toColumn string - The name of the primary key column
power.bi: Report![](/images/permalink.svg)
A Power BI report. Below is a list of properties that may be returned for a report. Only a subset of the properties will be returned depending on the API called, the caller permissions and the availability of the data in the Power BI database.
Fields
- id string - The report id
- name string? - The report name
- webUrl string? - The report web url
- embedUrl string? - The report embed url
- datasetId string? - The dataset id
- description string? - The report description
- createdBy string? - The report owner
- modifiedBy string? - The user that modified this report
- createdDateTime string? - The report created date time.
- modifiedDateTime string? - The report modified date time.
- endorsementDetails EndorsementDetails? - Power BI endorsement details
- sensitivityLabel SensitivityLabel? - Artifact sensitivity label info
- reportType string? - The report type
power.bi: Reports![](/images/permalink.svg)
Odata response wrapper for a Power BI report collection
Fields
- value Report[]? - The report collection
power.bi: RequiredWorkspaces![](/images/permalink.svg)
A required workspaces request
Fields
- workspaces string[]? - Required workspace IDs to be scaned. It should contain 1-100 workspaces.
power.bi: Row![](/images/permalink.svg)
A data row in a dataset
Fields
- id string? - The unique row id
power.bi: ScanRequest![](/images/permalink.svg)
A scan request
Fields
- id string? - The scan ID.
- createdDateTime string? - The scan created date time.
- status string? - The scan state.
- 'error PowerBIApiErrorResponseDetail? - A Power BI error response details
power.bi: SensitivityLabel![](/images/permalink.svg)
Artifact sensitivity label info
Fields
- labelId string - The sensitivity label ID
power.bi: SourceReport![](/images/permalink.svg)
Source from existing report
Fields
- sourceReportId string - source report id
- sourceWorkspaceId string? - source worksapce id
power.bi: Table![](/images/permalink.svg)
A dataset table
Fields
- name string - The table name
- columns Column[] - The column schema for this table
- rows Row[]? - The data rows within this table
- measures Measure[]? - The measures within this table
power.bi: Tables![](/images/permalink.svg)
Odata response wrapper for a Power BI table collection
Fields
- value Table[]? - The Power BI tables
power.bi: TemplateAppConfigurationRequest![](/images/permalink.svg)
Power BI Template App Automated install configuration. Dictionary of name-value pairs
Fields
- configuration record {}? - Configuration
power.bi: TemplateAppInstallDetails![](/images/permalink.svg)
Power BI Template App Install Details
Fields
- appId string - Unique application Id.
- packageKey string - Application version secure key
- ownerTenantId string - Application owner's tenant object Id
- config TemplateAppConfigurationRequest? - Power BI Template App Automated install configuration. Dictionary of name-value pairs
power.bi: TemporaryUploadLocation![](/images/permalink.svg)
Power BI update report content request
Fields
- Url string - The shared access signature (SAS) url for the temporary blob storage
- ExpirationTime string - The expiration time of the shared access signature (SAS) url
power.bi: TenantKey![](/images/permalink.svg)
Encryption key information
Fields
- id string? - The id of the encryption key
- name string? - The name of the encryption key
- keyVaultKeyIdentifier string? - Uri to the version of the Azure Key Vault key
- isDefault boolean? - Indicates that this key is set as default for the entire tenant. Any new capacity creation will inherit this key upon creation
- createdAt string? - Encryption key creation time
- updatedAt string? - Encryption key last update time
power.bi: TenantKeyCreationRequest![](/images/permalink.svg)
Add encryption key request
Fields
- name string? - The name of the encryption key
- keyVaultKeyIdentifier string? - Uri to the version of the Azure Key Vault key to be used
- isDefault boolean? - Indicates that this key is set as default for the entire tenant. Any new capacity creation will inherit this key upon creation
- activate boolean? - Indicates to activate any inactivated capacities to use this key for its encryption
power.bi: TenantKeyRotationRequest![](/images/permalink.svg)
Rotate encryption key request
Fields
- keyVaultKeyIdentifier string? - Uri to the version of the Azure Key Vault key to be used
power.bi: TenantKeys![](/images/permalink.svg)
Encryption keys information
Fields
- value TenantKey[]? - Encryption keys
power.bi: Tile![](/images/permalink.svg)
A Power BI tile
Fields
- id string - The tile id
- title string? - The dashboard display name
- rowSpan int? - number of rows a tile should span
- colSpan int? - number of columns a tile should span
- embedUrl string? - The tile embed url
- embedData string? - The tile embed data
- reportId string? - The report id. Available only for tiles created from a report.
- datasetId string? - The dataset id. Available only for tiles created from a report or using a dataset; for example, Q&A tiles.
power.bi: Tiles![](/images/permalink.svg)
Odata response wrapper for a Power BI tile collection
Fields
- value Tile[]? - The tile collection
power.bi: UnassignWorkspacesCapacityRequest![](/images/permalink.svg)
Request body for migrating workspaces to shared capacity as tenant admin
Fields
- workspacesToUnassign string[] - Workspaces to be migrated to shared capacity
power.bi: UpdateDatasourceConnectionRequest![](/images/permalink.svg)
Fields
- connectionDetails DatasourceConnectionDetails - A Power BI datasource connection details
- datasourceSelector Datasource? - A Power BI datasource
power.bi: UpdateDatasourceRequest![](/images/permalink.svg)
An update datasource to gateway request
Fields
- credentialDetails CredentialDetails - The credential details
power.bi: UpdateDatasourcesRequest![](/images/permalink.svg)
Fields
- updateDetails UpdateDatasourceConnectionRequest[] - The connection server
power.bi: UpdateMashupParameterDetails![](/images/permalink.svg)
Power BI dataset parameter update details
Fields
- name string - The parameter name
- newValue string? - The parameter new value
power.bi: UpdateMashupParametersRequest![](/images/permalink.svg)
Power BI dataset parameter update request
Fields
- updateDetails UpdateMashupParameterDetails[] - The dataset parameter list to update
power.bi: UpdateRdlDatasourceDetails![](/images/permalink.svg)
The new connection details and the target datasource name to be updated.
Fields
- connectionDetails RdlDatasourceConnectionDetails - A paginated report datasource connection details.
- datasourceName string - The target datasource name to be updated.
power.bi: UpdateRdlDatasourcesRequest![](/images/permalink.svg)
A paginated report datasources update request.
Fields
- updateDetails UpdateRdlDatasourceDetails[] - The paginated report datasources update details.
power.bi: UpdateReportContentRequest![](/images/permalink.svg)
Power BI update report content request
Fields
- sourceType string - The source type for the content update.
- sourceReport SourceReport - Source from existing report
power.bi: Workbook![](/images/permalink.svg)
A Power BI workbook
Fields
- name string? - The workbook name
- datasetId string? - DatasetId for workbooks. Only applies for workbooks that has an associated dataset.
power.bi: Workbooks![](/images/permalink.svg)
Power BI workbook list
Fields
- value Workbook[]? - The workbooks
power.bi: Workload![](/images/permalink.svg)
Capacity workload setting
Fields
- name string? - The workload name
- state WorkloadState - The capacity workload state
- maxMemoryPercentageSetByUser int? - The memory percentage maximum Limit set by the user
power.bi: Workloads![](/images/permalink.svg)
Odata response wrapper for capacity workload settings list
Fields
- value Workload[]? - The capacity workload settings list
power.bi: WorkspaceCapacityAssignmentStatus![](/images/permalink.svg)
Power BI workspace assignment status to capacity response
Fields
- status string - Workspace assignment status
- startTime string? - Start time of workspace assignment operation
- endTime string? - End time of workspace assignment operation
- capacityId string? - The capacity id
- activityId string? - The activity id of the acctual assignment operation, can be provided in case of assignment failures
power.bi: WorkspaceInfo![](/images/permalink.svg)
Workspace info details
Fields
- id string - The workspace object ID
- name string? - The workspace name
- description string? - The workspace description
- 'type string? - The workspace type
- state string? - The workspace state
- dataRetrievalState string? - The workspace data retrieval state
- isOnDedicatedCapacity boolean? - Whether the workspace is on dedicated capacity
- capacityId string? - The workspace capacity ID
- reports Report[]? - The reports associated with this workspace. The list of properties returned varies between APIs, thus you may not see them all as part of the API response.
- dashboards Dashboard[]? - The dashboards associated with this workspace. The list of properties returned varies between APIs, thus you may not see them all as part of the API response.
- datasets Dataset[]? - The datasets associated with this workspace. The list of properties returned varies between APIs, thus you may not see them all as part of the API response.
- dataflows Dataflow[]? - The dataflows associated with this workspace. The list of properties returned varies between APIs, thus you may not see them all as part of the API response.
power.bi: WorkspaceInfoResponse![](/images/permalink.svg)
Workspace info response
Fields
- workspaces WorkspaceInfo[]? - The workspace info associated with this scan
- datasourceInstances Datasource[]? - The datasources' instances associated with this scan
String types![](/images/permalink.svg)
power.bi: WorkloadState![](/images/permalink.svg)
WorkloadState
The capacity workload state
Import
import ballerinax/power.bi;
Metadata
Released date: almost 2 years ago
Version: 1.4.0
License: Apache-2.0
Compatibility
Platform: any
Ballerina version: 2201.2.1
GraalVM compatible: Yes
Pull count
Total: 2
Current verison: 1
Weekly downloads
Keywords
Business Intelligence/Analytics
Cost/Paid
Vendor/Microsoft
Contributors