Pipelines - Get Pipeline Stage Artifacts

參考

Service:: Power BI REST APIs

API Version:: v1.0

從指派給指定部署管線之指定階段的工作區傳回支援的專案。

若要瞭解部署管線中不支援的專案，請參閱不支援的專案。

權限

使用者至少必須是指派給指定階段之工作區的參與者。如需詳細資訊，請參閱權限。

必要範圍

Pipeline.ReadWrite.All 或 Pipeline.Read.All

GET https://api.powerbi.com/v1.0/myorg/pipelines/{pipelineId}/stages/{stageOrder}/artifacts

URI 參數

名稱	位於	必要	類型	Description
pipelineId	path	True	string uuid	部署管線識別碼
stageOrder	path	True	integer int32	部署管線階段順序。開發 (0) 、測試 (1) 、生產 (2) 。

回應

名稱	類型	Description
200 OK	PipelineStageArtifacts	確定

範例

Example of getting 'Test' stage Power BI items (such as reports or dashboards)

Sample Request

GET https://api.powerbi.com/v1.0/myorg/pipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/stages/1/artifacts

Sample Response

Status code:: 200

{
  "dataflows": [
    {
      "artifactId": "527700ab-3cdb-4637-8402-912a129b2a92",
      "artifactDisplayName": "Sales Dataflow",
      "sourceArtifactId": "29efcfb0-0063-44af-a4ed-6c0bee3417d3",
      "lastDeploymentTime": "2021-06-06T11:55:59.057Z"
    }
  ],
  "datamarts": [
    {
      "artifactId": "a7654a17-c5d1-4539-b9ec-022075545e50",
      "artifactDisplayName": "Sales Datamart",
      "sourceArtifactId": "6bfe235c-6d7b-41b7-98a6-2b8276b3e82b",
      "lastDeploymentTime": "2021-06-06T11:55:59.057Z"
    }
  ],
  "datasets": [
    {
      "artifactId": "dd3b6aa1-4d40-405c-a19b-48314a27e8ee",
      "artifactName": "Sales Dataset",
      "sourceArtifactId": "1a201f2a-d1d8-45c0-8c61-1676338517de",
      "targetArtifactId": "a5cf347e-7b49-4198-8a2b-0aa92c37d8f8",
      "lastDeploymentTime": "2020-12-13T09:26:41.153Z"
    }
  ],
  "reports": [
    {
      "artifactId": "9d5c1f0f-f85c-48f4-8a8e-4c77547116b3",
      "artifactName": "Sales Report",
      "sourceArtifactId": "2d225191-65f8-4ec3-b77d-06100602b1f7",
      "lastDeploymentTime": "2020-12-13T09:26:41.153Z"
    }
  ],
  "dashboards": [
    {
      "artifactId": "9046e4cc-8aea-4a7a-a3b5-1a78b1447d82",
      "artifactName": "Sales Dashboard"
    }
  ]
}

定義

名稱	Description
PipelineStageArtifacts	指派給部署管線階段之工作區的支援專案
PipelineStageDashboard	部署管線儀表板的中繼資料
PipelineStageDataflow	部署管線資料流程的中繼資料
PipelineStageDatamart	部署管線資料超市的中繼資料
PipelineStageDataset	部署管線資料集的中繼資料
PipelineStageReport	部署管線報告的中繼資料

PipelineStageArtifacts

指派給部署管線階段之工作區的支援專案

名稱	類型	Description
dashboards	PipelineStageDashboard[]	儀表板集合
dataflows	PipelineStageDataflow[]	資料流程集合
datamarts	PipelineStageDatamart[]	Datamarts 集合
datasets	PipelineStageDataset[]	資料集集合
reports	PipelineStageReport[]	reports 集合

PipelineStageDashboard

部署管線儀表板的中繼資料

名稱	類型	Description
artifactDisplayName	string	Power BI 專案顯示名稱
artifactId	string	Power BI 專案識別碼
lastDeploymentTime	string	Power BI 專案的最後一個部署日期和時間
sourceArtifactId	string	Power BI 專案 (識別碼，例如指派給來源階段之工作區的報表或儀表板) ，這會在部署時更新目前的 Power BI 專案。只有在使用者至少有來源階段工作區的參與者存取權時，才適用。
targetArtifactId	string	Power BI 專案 (識別碼，例如來自目標階段工作區的報表或儀表板) ，這會在部署時由目前的 Power BI 專案更新。只有在使用者至少有目標階段工作區的參與者存取權時，才適用。

PipelineStageDataflow

部署管線資料流程的中繼資料

名稱	類型	Description
artifactDisplayName	string	Power BI 專案顯示名稱
artifactId	string	Power BI 專案識別碼
lastDeploymentTime	string	Power BI 專案的最後一個部署日期和時間
sourceArtifactId	string	Power BI 專案 (識別碼，例如指派給來源階段之工作區的報表或儀表板) ，這會在部署時更新目前的 Power BI 專案。只有在使用者至少有來源階段工作區的參與者存取權時，才適用。
targetArtifactId	string	Power BI 專案 (識別碼，例如來自目標階段工作區的報表或儀表板) ，這會在部署時由目前的 Power BI 專案更新。只有在使用者至少有目標階段工作區的參與者存取權時，才適用。

PipelineStageDatamart

部署管線資料超市的中繼資料

名稱	類型	Description
artifactDisplayName	string	Power BI 專案顯示名稱
artifactId	string	Power BI 專案識別碼
lastDeploymentTime	string	Power BI 專案的最後一個部署日期和時間
sourceArtifactId	string	Power BI 專案 (識別碼，例如指派給來源階段之工作區的報表或儀表板) ，這會在部署時更新目前的 Power BI 專案。只有在使用者至少有來源階段工作區的參與者存取權時，才適用。
targetArtifactId	string	Power BI 專案 (識別碼，例如來自目標階段工作區的報表或儀表板) ，這會在部署時由目前的 Power BI 專案更新。只有在使用者至少有目標階段工作區的參與者存取權時，才適用。

PipelineStageDataset

部署管線資料集的中繼資料

名稱	類型	Description
artifactDisplayName	string	Power BI 專案顯示名稱
artifactId	string	Power BI 專案識別碼
lastDeploymentTime	string	Power BI 專案的最後一個部署日期和時間
sourceArtifactId	string	Power BI 專案 (識別碼，例如指派給來源階段之工作區的報表或儀表板) ，這會在部署時更新目前的 Power BI 專案。只有在使用者至少有來源階段工作區的參與者存取權時，才適用。
targetArtifactId	string	Power BI 專案 (識別碼，例如來自目標階段工作區的報表或儀表板) ，這會在部署時由目前的 Power BI 專案更新。只有在使用者至少有目標階段工作區的參與者存取權時，才適用。

PipelineStageReport

部署管線報告的中繼資料

名稱	類型	Description
artifactDisplayName	string	Power BI 專案顯示名稱
artifactId	string	Power BI 專案識別碼
lastDeploymentTime	string	Power BI 專案的最後一個部署日期和時間
sourceArtifactId	string	Power BI 專案 (識別碼，例如指派給來源階段之工作區的報表或儀表板) ，這會在部署時更新目前的 Power BI 專案。只有在使用者至少有來源階段工作區的參與者存取權時，才適用。
targetArtifactId	string	Power BI 專案 (識別碼，例如來自目標階段工作區的報表或儀表板) ，這會在部署時由目前的 Power BI 專案更新。只有在使用者至少有目標階段工作區的參與者存取權時，才適用。

共用方式為