Pipelines - Get Pipeline Stage Artifacts

参考

服务:: Power BI REST APIs

API 版本:: v1.0

返回分配给指定部署管道指定阶段的工作区中支持的项。

若要了解部署管道中不支持的项目，请参阅不受支持的项。

权限

用户至少必须是分配给指定阶段的工作区的参与者。有关详细信息，请参阅权限。

所需范围

Pipeline.ReadWrite.All 或 Pipeline.Read.All

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

URI 参数

名称	在	必需	类型	说明
pipelineId	path	True	string uuid	部署管道 ID
stageOrder	path	True	integer int32	部署管道阶段顺序。开发 (0) 、测试 (1) 、生产 (2) 。

响应

名称	类型	说明
200 OK	PipelineStageArtifacts	确定

示例

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

示例请求

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

示例响应

状态代码:: 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"
    }
  ]
}

定义

名称	说明
PipelineStageArtifacts	分配给部署管道阶段的工作区中支持的项
PipelineStageDashboard	部署管道仪表板的元数据
PipelineStageDataflow	部署管道数据流的元数据
PipelineStageDatamart	部署管道 Datamart 的元数据
PipelineStageDataset	部署管道数据集的元数据
PipelineStageReport	部署管道报表的元数据

PipelineStageArtifacts

Object

分配给部署管道阶段的工作区中支持的项

名称	类型	说明
dashboards	PipelineStageDashboard[]	仪表板集合
dataflows	PipelineStageDataflow[]	数据流集合
datamarts	PipelineStageDatamart[]	Datamarts 集合
datasets	PipelineStageDataset[]	数据集集合
reports	PipelineStageReport[]	报表集合

PipelineStageDashboard

Object

部署管道仪表板的元数据

名称	类型	说明
artifactDisplayName	string	Power BI 项显示名称
artifactId	string	Power BI 项 ID
lastDeploymentTime	string	Power BI 项的最后一个部署日期和时间
sourceArtifactId	string	Power BI 项的 ID (（例如报表或仪表板）从分配给源阶段的工作区) ，这将在部署时更新当前 Power BI 项。仅当用户至少具有对源阶段工作区的参与者访问权限时适用。
targetArtifactId	string	Power BI 项的 ID (（例如报表或仪表板）从目标阶段的工作区) ，将在部署时由当前 Power BI 项更新。仅当用户至少具有对目标阶段工作区的参与者访问权限时适用。

PipelineStageDataflow

Object

部署管道数据流的元数据

名称	类型	说明
artifactDisplayName	string	Power BI 项显示名称
artifactId	string	Power BI 项 ID
lastDeploymentTime	string	Power BI 项的最后一个部署日期和时间
sourceArtifactId	string	Power BI 项的 ID (（例如报表或仪表板）从分配给源阶段的工作区) ，这将在部署时更新当前 Power BI 项。仅当用户至少具有对源阶段工作区的参与者访问权限时适用。
targetArtifactId	string	Power BI 项的 ID (（例如报表或仪表板）从目标阶段的工作区) ，将在部署时由当前 Power BI 项更新。仅当用户至少具有对目标阶段工作区的参与者访问权限时适用。

PipelineStageDatamart

Object

部署管道 Datamart 的元数据

名称	类型	说明
artifactDisplayName	string	Power BI 项显示名称
artifactId	string	Power BI 项 ID
lastDeploymentTime	string	Power BI 项的最后一个部署日期和时间
sourceArtifactId	string	Power BI 项的 ID (（例如报表或仪表板）从分配给源阶段的工作区) ，这将在部署时更新当前 Power BI 项。仅当用户至少具有对源阶段工作区的参与者访问权限时适用。
targetArtifactId	string	Power BI 项的 ID (（例如报表或仪表板）从目标阶段的工作区) ，将在部署时由当前 Power BI 项更新。仅当用户至少具有对目标阶段工作区的参与者访问权限时适用。

PipelineStageDataset

Object

部署管道数据集的元数据

名称	类型	说明
artifactDisplayName	string	Power BI 项显示名称
artifactId	string	Power BI 项 ID
lastDeploymentTime	string	Power BI 项的最后一个部署日期和时间
sourceArtifactId	string	Power BI 项的 ID (（例如报表或仪表板）从分配给源阶段的工作区) ，这将在部署时更新当前 Power BI 项。仅当用户至少具有对源阶段工作区的参与者访问权限时适用。
targetArtifactId	string	Power BI 项的 ID (（例如报表或仪表板）从目标阶段的工作区) ，将在部署时由当前 Power BI 项更新。仅当用户至少具有对目标阶段工作区的参与者访问权限时适用。

PipelineStageReport

Object

部署管道报表的元数据

名称	类型	说明
artifactDisplayName	string	Power BI 项显示名称
artifactId	string	Power BI 项 ID
lastDeploymentTime	string	Power BI 项的最后一个部署日期和时间
sourceArtifactId	string	Power BI 项的 ID (（例如报表或仪表板）从分配给源阶段的工作区) ，这将在部署时更新当前 Power BI 项。仅当用户至少具有对源阶段工作区的参与者访问权限时适用。
targetArtifactId	string	Power BI 项的 ID (（例如报表或仪表板）从目标阶段的工作区) ，将在部署时由当前 Power BI 项更新。仅当用户至少具有对目标阶段工作区的参与者访问权限时适用。

通过

Pipelines - Get Pipeline Stage Artifacts

权限

所需范围

URI 参数

响应

示例

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

示例请求

示例响应

定义

PipelineStageArtifacts

PipelineStageDashboard

PipelineStageDataflow

PipelineStageDatamart

PipelineStageDataset

PipelineStageReport

其他资源