Pipelines - Get Pipeline Operations

返回对指定部署管道执行的 up-to-20 最新部署作的列表。

所需范围

Pipeline.ReadWrite.All 或 Pipeline.Read.All

GET https://api.powerbi.com/v1.0/myorg/pipelines/{pipelineId}/operations

URI 参数

名称 必需 类型 说明
pipelineId
path True

string (uuid)

部署管道 ID

响应

名称 类型 说明
200 OK

PipelineOperations

还行

示例

Get pipeline operations example

示例请求

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

示例响应

{
  "value": [
    {
      "id": "1065e6a3-a020-4c0c-ada7-92b5fe99eec5",
      "type": "Deploy",
      "status": "Succeeded",
      "lastUpdatedTime": "2020-12-13T09:26:43.153",
      "executionStartTime": "2020-12-13T09:25:43.153Z",
      "executionEndTime": "2020-12-13T09:26:43.153Z",
      "sourceStageOrder": 0,
      "targetStageOrder": 1,
      "note": {
        "content": "Sample note",
        "isTruncated": false
      },
      "preDeploymentDiffInformation": {
        "newArtifactsCount": 0,
        "differentArtifactsCount": 0,
        "noDifferenceArtifactsCount": 1
      },
      "performedBy": {
        "userPrincipalName": "john@contoso.com",
        "principalType": "User"
      }
    }
  ]
}

定义

名称 说明
DeploymentError

部署步骤的错误详细信息

DeploymentExecutionPlan

部署执行计划

DeploymentExecutionStep

部署执行步骤

DeploymentExecutionStepPreDeploymentDiffState

是部署前目标阶段中项的新项、不同项或相同项。

DeploymentSourceAndTarget

源项和目标项

DeploymentStepType

部署步骤的类型

PipelineOperation

Power BI 部署管道作

PipelineOperationNote

描述部署的注释。

PipelineOperations

Power BI 部署管道作集合的 OData 响应包装器

PipelineOperationStatus

管道作状态

PipelineOperationType

作类型

PipelineOperationUser

执行管道作的用户或服务主体。

PreDeploymentDiffInformation

部署前新、不同和相同的已部署项的数量。

PrincipalType

主体类型

DeploymentError

部署步骤的错误详细信息

名称 类型 说明
errorCode

string

错误代码

errorDetails

string

其他错误详细信息

DeploymentExecutionPlan

部署执行计划

名称 类型 说明
steps

DeploymentExecutionStep[]

执行计划步骤的集合

DeploymentExecutionStep

部署执行步骤

名称 类型 说明
error

DeploymentError

错误详细信息。 仅当管道作失败时适用。

index

integer

步骤索引

preDeploymentDiffState

DeploymentExecutionStepPreDeploymentDiffState

是部署前目标阶段中项的新项、不同项或相同项。

sourceAndTarget

DeploymentSourceAndTarget

步骤的源项和目标项

status

PipelineOperationStatus

管道作的状态

type

DeploymentStepType

部署步骤的类型

DeploymentExecutionStepPreDeploymentDiffState

是部署前目标阶段中项的新项、不同项或相同项。

说明
Different

在部署之前,源阶段中的项与目标阶段中的项不同。

New

目标阶段中不存在的新部署项。

NoDifference

在部署之前,源阶段中的项与目标阶段中的项相同。

DeploymentSourceAndTarget

源项和目标项

名称 类型 说明
source

string (uuid)

从源阶段部署的 Power BI 项的 ID

sourceDisplayName

string

从源阶段部署的 Power BI 项的显示名称

target

string (uuid)

将在目标阶段覆盖的 Power BI 项的 ID。 仅当覆盖 Power BI 项时适用。

targetDisplayName

string

将在目标阶段覆盖的 Power BI 项的名称。 仅当覆盖 Power BI 项时适用。

type

string

将在目标阶段覆盖的 Power BI 项的类型。 仅当覆盖 Power BI 项时适用。

DeploymentStepType

部署步骤的类型

说明
DashboardDeployment

部署单个仪表板的步骤

DataflowDeployment

部署单个数据流的步骤

DatamartDeployment

部署单个 Datamart 的步骤

DatasetDeployment

部署单个数据集的步骤

ReportDeployment

部署单个报表的步骤

PipelineOperation

Power BI 部署管道作

名称 类型 说明
executionEndTime

string (date-time)

作结束的日期和时间

executionPlan

DeploymentExecutionPlan

部署执行计划。 仅适用于单个管道作。

executionStartTime

string (date-time)

作启动的日期和时间

id

string (uuid)

作 ID

lastUpdatedTime

string (date-time)

上次更新作的日期和时间

note

PipelineOperationNote

表示作说明的注释。

performedBy

PipelineOperationUser

执行管道作的用户或服务主体。

preDeploymentDiffInformation

PreDeploymentDiffInformation

在部署之前,源阶段中已部署的项量(与目标阶段中的项相同或不同)。

sourceStageOrder

integer

源管道部署阶段的数字标识符。 开发(0)、测试(1)、生产(2)。

status

PipelineOperationStatus

管道作状态

targetStageOrder

integer

目标管道部署阶段的数字标识符。 开发(0)、测试(1)、生产(2)。

type

PipelineOperationType

作类型

PipelineOperationNote

描述部署的注释。

名称 类型 说明
content

string

描述部署的文本。

isTruncated

boolean

指示注释是否不完整。 如此,只返回注释的一部分。 False,便笺已完成。

PipelineOperations

Power BI 部署管道作集合的 OData 响应包装器

名称 类型 说明
@odata.context

string

OData 上下文

value

PipelineOperation[]

部署管道作的集合

PipelineOperationStatus

管道作状态

说明
Executing

正在执行的作

Failed

操作失败

NotStarted

作未启动

Succeeded

操作成功

PipelineOperationType

作类型

说明
Deploy

在各个阶段之间部署内容

PipelineOperationUser

执行管道作的用户或服务主体。

名称 类型 说明
principalObjectID

string (uuid)

执行部署的服务主体的 ID。

principalType

PrincipalType

执行部署的用户的类型。

userPrincipalName

string

执行部署的用户的 UPN。

PreDeploymentDiffInformation

部署前新、不同和相同的已部署项的数量。

名称 类型 说明
differentArtifactsCount

integer

在部署之前,源阶段和目标阶段之间存在差异的已部署项数。

newArtifactsCount

integer

部署到目标阶段的新项数。

noDifferenceArtifactsCount

integer

在部署之前,源阶段和目标阶段中相同的已部署项数。

PrincipalType

主体类型

说明
App

服务主体类型

Group

组主体类型

None

无主体类型。 用于整个组织级别的访问。

User

用户主体类型