Reports - Update Datasources In Group

Service:

Power BI REST APIs

API Version:

v1.0

從指定的工作區 (RDL) ，更新指定分頁報表的資料來源。

重要

原始資料來源和新資料來源必須有完全相同的架構。

權限

• 使用者必須是資料來源擁有者。
• 此 API 呼叫可由服務主體設定檔呼叫。 如需詳細資訊，請參閱：Power BI Embedded中的服務主體設定檔。

必要範圍

Reports.ReadWrite.All

限制

• 僅支援編頁報表。
• 不支援變更資料來源類型。
  
  

POST https://api.powerbi.com/v1.0/myorg/groups/{groupId}/reports/{reportId}/Default.UpdateDatasources

URI 參數

名稱	位於	必要	類型	Description
groupId	path	True	string uuid	工作區識別碼
reportId	path	True	string uuid	報表識別碼

要求本文

名稱	必要	類型	Description
updateDetails	True	UpdateRdlDatasourceDetails[]	編頁報表資料來源的更新詳細資料

回應

名稱	類型	Description
200 OK		確定

範例

Example

Sample Request

POST https://api.powerbi.com/v1.0/myorg/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/reports/cfafbeb1-8037-4d0c-896e-a46fb27ff229/Default.UpdateDatasources

Request Body

{
  "updateDetails": [
    {
      "datasourceName": "SqlDatasource",
      "connectionDetails": {
        "server": "New-Sql-Server",
        "database": "New-Sql-Database"
      }
    },
    {
      "datasourceName": "SqlAzureDatasource",
      "connectionDetails": {
        "server": "New-SqlAzure-Server.windows.net",
        "database": "New-SqlAzure-Database"
      }
    }
  ]
}

Sample Response

Status code:

200

定義

名稱	Description
RdlDatasourceConnectionDetails	編頁報表資料來源的連接詳細資料
UpdateRdlDatasourceDetails	更新編頁報表資料來源的詳細資料
UpdateRdlDatasourcesRequest	更新編頁報表資料來源的要求

RdlDatasourceConnectionDetails

編頁報表資料來源的連接詳細資料

名稱	類型	Description
database	string	連接資料庫
server	string	連接伺服器

UpdateRdlDatasourceDetails

更新編頁報表資料來源的詳細資料

名稱	類型	Description
connectionDetails	RdlDatasourceConnectionDetails	編頁報表資料來源的新連線詳細資料
datasourceName	string	編頁報表資料來源的名稱

UpdateRdlDatasourcesRequest

更新編頁報表資料來源的要求

名稱	類型	Description
updateDetails	UpdateRdlDatasourceDetails[]	編頁報表資料來源的更新詳細資料