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 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
pipeline
|
path | True |
string (uuid) |
部署管道 ID |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
还行 |
示例
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"
}
}
]
}
定义
名称 | 说明 |
---|---|
Deployment |
部署步骤的错误详细信息 |
Deployment |
部署执行计划 |
Deployment |
部署执行步骤 |
Deployment |
是部署前目标阶段中项的新项、不同项或相同项。 |
Deployment |
源项和目标项 |
Deployment |
部署步骤的类型 |
Pipeline |
Power BI 部署管道作 |
Pipeline |
描述部署的注释。 |
Pipeline |
Power BI 部署管道作集合的 OData 响应包装器 |
Pipeline |
管道作状态 |
Pipeline |
作类型 |
Pipeline |
执行管道作的用户或服务主体。 |
Pre |
部署前新、不同和相同的已部署项的数量。 |
Principal |
主体类型 |
DeploymentError
部署步骤的错误详细信息
名称 | 类型 | 说明 |
---|---|---|
errorCode |
string |
错误代码 |
errorDetails |
string |
其他错误详细信息 |
DeploymentExecutionPlan
部署执行计划
名称 | 类型 | 说明 |
---|---|---|
steps |
执行计划步骤的集合 |
DeploymentExecutionStep
部署执行步骤
名称 | 类型 | 说明 |
---|---|---|
error |
错误详细信息。 仅当管道作失败时适用。 |
|
index |
integer |
步骤索引 |
preDeploymentDiffState |
是部署前目标阶段中项的新项、不同项或相同项。 |
|
sourceAndTarget |
步骤的源项和目标项 |
|
status |
管道作的状态 |
|
type |
部署步骤的类型 |
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 |
部署执行计划。 仅适用于单个管道作。 |
|
executionStartTime |
string (date-time) |
作启动的日期和时间 |
id |
string (uuid) |
作 ID |
lastUpdatedTime |
string (date-time) |
上次更新作的日期和时间 |
note |
表示作说明的注释。 |
|
performedBy |
执行管道作的用户或服务主体。 |
|
preDeploymentDiffInformation |
在部署之前,源阶段中已部署的项量(与目标阶段中的项相同或不同)。 |
|
sourceStageOrder |
integer |
源管道部署阶段的数字标识符。 开发(0)、测试(1)、生产(2)。 |
status |
管道作状态 |
|
targetStageOrder |
integer |
目标管道部署阶段的数字标识符。 开发(0)、测试(1)、生产(2)。 |
type |
作类型 |
PipelineOperationNote
描述部署的注释。
名称 | 类型 | 说明 |
---|---|---|
content |
string |
描述部署的文本。 |
isTruncated |
boolean |
指示注释是否不完整。 如此,只返回注释的一部分。 False,便笺已完成。 |
PipelineOperations
Power BI 部署管道作集合的 OData 响应包装器
名称 | 类型 | 说明 |
---|---|---|
@odata.context |
string |
OData 上下文 |
value |
部署管道作的集合 |
PipelineOperationStatus
管道作状态
值 | 说明 |
---|---|
Executing |
正在执行的作 |
Failed |
操作失败 |
NotStarted |
作未启动 |
Succeeded |
操作成功 |
PipelineOperationType
作类型
值 | 说明 |
---|---|
Deploy |
在各个阶段之间部署内容 |
PipelineOperationUser
执行管道作的用户或服务主体。
名称 | 类型 | 说明 |
---|---|---|
principalObjectID |
string (uuid) |
执行部署的服务主体的 ID。 |
principalType |
执行部署的用户的类型。 |
|
userPrincipalName |
string |
执行部署的用户的 UPN。 |
PreDeploymentDiffInformation
部署前新、不同和相同的已部署项的数量。
名称 | 类型 | 说明 |
---|---|---|
differentArtifactsCount |
integer |
在部署之前,源阶段和目标阶段之间存在差异的已部署项数。 |
newArtifactsCount |
integer |
部署到目标阶段的新项数。 |
noDifferenceArtifactsCount |
integer |
在部署之前,源阶段和目标阶段中相同的已部署项数。 |
PrincipalType
主体类型
值 | 说明 |
---|---|
App |
服务主体类型 |
Group |
组主体类型 |
None |
无主体类型。 用于整个组织级别的访问。 |
User |
用户主体类型 |