Pipelines - Get Pipeline Operation

Reference

Service:: Power BI REST APIs

API Version:: v1.0

Returns the details of the specified deploy operation performed on the specified deployment pipeline, including the deployment execution plan.

Use to track the status of a deploy operation.

Required Scope

Pipeline.ReadWrite.All or Pipeline.Read.All

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

URI Parameters

Name	In	Required	Type	Description
operationId	path	True	string uuid	The operation ID
pipelineId	path	True	string uuid	The deployment pipeline ID

Responses

Name	Type	Description
200 OK	PipelineOperation	OK

Examples

Get a pipeline operation example

Sample request

GET https://api.powerbi.com/v1.0/myorg/pipelines/a5ded933-57b7-41f4-b072-ed4c1f9d5824/operations/1065e6a3-a020-4c0c-ada7-92b5fe99eec5

Sample response

Status code:: 200

{
  "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,
  "executionPlan": {
    "Steps": [
      {
        "index": 0,
        "type": "DataflowDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "New",
        "sourceAndTarget": {
          "source": "29efcfb0-0063-44af-a4ed-6c0bee3417d3",
          "sourceDisplayName": "Source dataflow",
          "type": "dataflow"
        }
      },
      {
        "index": 1,
        "type": "DatamartDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "New",
        "sourceAndTarget": {
          "source": "645cd81f-1b21-4006-82b6-54cc7ec0352e",
          "sourceDisplayName": "Source datamart",
          "type": "datamart"
        }
      },
      {
        "index": 2,
        "type": "DatasetDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "NoDifference",
        "sourceAndTarget": {
          "source": "1a201f2a-d1d8-45c0-8c61-1676338517de",
          "sourceDisplayName": "Source dataset",
          "target": "dd3b6aa1-4d40-405c-a19b-48314a27e8ee",
          "targetDisplayName": "Target dataset",
          "type": "dataset"
        }
      },
      {
        "index": 3,
        "type": "ReportDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "Different",
        "sourceAndTarget": {
          "source": "2d225191-65f8-4ec3-b77d-06100602b1f7",
          "sourceDisplayName": "Source report",
          "target": "9d5c1f0f-f85c-48f4-8a8e-4c77547116b3",
          "targetDisplayName": "Target report",
          "type": "report"
        }
      },
      {
        "index": 4,
        "type": "DashboardDeployment",
        "status": "Succeeded",
        "preDeploymentDiffState": "New",
        "sourceAndTarget": {
          "source": "9046e4cc-8aea-4a7a-a3b5-1a78b1447d82",
          "sourceDisplayName": "Source dashboard",
          "type": "dashboard"
        }
      }
    ]
  },
  "note": {
    "content": "Sample note",
    "isTruncated": false
  },
  "preDeploymentDiffInformation": {
    "newArtifactsCount": 3,
    "differentArtifactsCount": 1,
    "noDifferenceArtifactsCount": 1
  },
  "performedBy": {
    "userPrincipalName": "john@contoso.com",
    "principalType": "User"
  }
}

Definitions

Name	Description
DeploymentError	Error details for the deployment step
DeploymentExecutionPlan	A deployment execution plan
DeploymentExecutionStep	A deployment execution step
DeploymentExecutionStepPreDeploymentDiffState	Is an item new, different or identical to items in the target stage before deployment.
DeploymentSourceAndTarget	Source and target items
DeploymentStepType	The type of deployment step
PipelineOperation	A Power BI deployment pipeline operation
PipelineOperationNote	A note describing the deployment.
PipelineOperationStatus	The pipeline operation status
PipelineOperationType	The operation type
PipelineOperationUser	User or service principal that performed the pipeline operation.
PreDeploymentDiffInformation	The amount of new, different and identical deployed items before deployment.
PrincipalType	The principal type

DeploymentError

Error details for the deployment step

Name	Type	Description
errorCode	string	The error code
errorDetails	string	Additional error details

DeploymentExecutionPlan

A deployment execution plan

Name	Type	Description
steps	DeploymentExecutionStep[]	The collection of execution plan steps

DeploymentExecutionStep

A deployment execution step

Name	Type	Description
error	DeploymentError	The error details. Only applicable if the pipeline operation failed.
index	integer	The step index
preDeploymentDiffState	DeploymentExecutionStepPreDeploymentDiffState	Is an item new, different or identical to items in the target stage before deployment.
sourceAndTarget	DeploymentSourceAndTarget	The source and target items of the step
status	PipelineOperationStatus	The status of the pipeline operation
type	DeploymentStepType	The type of deployment step

DeploymentExecutionStepPreDeploymentDiffState

Is an item new, different or identical to items in the target stage before deployment.

Name	Type	Description
Different	string	Before deployment, the item in the source stage wasn't identical to the one in the target stage.
New	string	A new deployed item that doesn't exist in the target stage.
NoDifference	string	Before deployment, the item in the source stage was identical to the one in the target stage.

DeploymentSourceAndTarget

Source and target items

Name	Type	Description
source	string	The ID of the Power BI item that's deployed from the source stage
sourceDisplayName	string	The display name of the Power BI item that's deployed from the source stage
target	string	The ID of the Power BI item that will be overwritten in the target stage. Only applies when overwriting a Power BI item.
targetDisplayName	string	The name of the Power BI item that will be overwritten in the target stage. Only applies when overwriting a Power BI item.
type	string	The type of the Power BI item that will be overwritten in the target stage. Only applies when overwriting a Power BI item.

DeploymentStepType

The type of deployment step

Name	Type	Description
DashboardDeployment	string	A step for deploying a single dashboard
DataflowDeployment	string	A step for deploying a single dataflow
DatamartDeployment	string	A step for deploying a single datamart
DatasetDeployment	string	A step for deploying a single dataset
ReportDeployment	string	A step for deploying a single report

PipelineOperation

A Power BI deployment pipeline operation

Name	Type	Description
executionEndTime	string	The date and time that the operation ended
executionPlan	DeploymentExecutionPlan	The deployment execution plan. Only applicable to a single pipeline operation.
executionStartTime	string	The date and time that the operation started
id	string	The operation ID
lastUpdatedTime	string	The date and time that the operation was last updated
note	PipelineOperationNote	A note representing a description of the operation.
performedBy	PipelineOperationUser	User or service principal that performed the pipeline operation.
preDeploymentDiffInformation	PreDeploymentDiffInformation	The amount of deployed items in the source stage, that are new, identical or different to items in the target stage, before deployment.
sourceStageOrder	integer	The numeric identifier of a source pipeline deployment stage. Development (0), Test (1), Production (2).
status	PipelineOperationStatus	The pipeline operation status
targetStageOrder	integer	The numeric identifier of a target pipeline deployment stage. Development (0), Test (1), Production (2).
type	PipelineOperationType	The operation type

PipelineOperationNote

A note describing the deployment.

Name	Type	Description
content	string	Text describing the deployment.
isTruncated	boolean	Indicates if the note is incomplete. True, only part of the note is returned. False, the note is complete.

PipelineOperationStatus

The pipeline operation status

Name	Type	Description
Executing	string	Operation executing
Failed	string	Operation failed
NotStarted	string	Operation not started
Succeeded	string	Operation succeeded

PipelineOperationType

The operation type

Name	Type	Description
Deploy	string	Deploy content between stages

PipelineOperationUser

User or service principal that performed the pipeline operation.

Name	Type	Description
principalObjectID	string	The ID of the service principal that performed the deployment.
principalType	PrincipalType	The type of user who performed the deployment.
userPrincipalName	string	The UPN of the user who performed the deployment.

PreDeploymentDiffInformation

The amount of new, different and identical deployed items before deployment.

Name	Type	Description
differentArtifactsCount	integer	The number of deployed items with differences between source and target stages, before deployment.
newArtifactsCount	integer	The number of new items deployed to the target stage.
noDifferenceArtifactsCount	integer	The number of identical deployed items in the source and target stages, before deployment.

PrincipalType

The principal type

Name	Type	Description
App	string	Service principal type
Group	string	Group principal type
None	string	No principal type. Use for whole organization level access.
User	string	User principal type

Share via