Pipelines - Get Pipeline Operation

Referência

Service:: Power BI REST APIs

API Version:: v1.0

Retorna os detalhes da operação de implantação especificada executada no pipeline de implantação especificado, incluindo o plano de execução da implantação.

Use para acompanhar o status de uma operação de implantação.

Escopo necessário

Pipeline.ReadWrite.All ou Pipeline.Read.All

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
operationId	path	True	string uuid	A ID da operação
pipelineId	path	True	string uuid	A ID do pipeline de implantação

Respostas

Nome	Tipo	Description
200 OK	PipelineOperation	OK

Exemplos

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"
  }
}

Definições

Nome	Description
DeploymentError	Detalhes do erro para a etapa de implantação
DeploymentExecutionPlan	Um plano de execução de implantação
DeploymentExecutionStep	Uma etapa de execução de implantação
DeploymentExecutionStepPreDeploymentDiffState	É um item novo, diferente ou idêntico aos itens no estágio de destino antes da implantação.
DeploymentSourceAndTarget	Itens de origem e de destino
DeploymentStepType	O tipo de etapa de implantação
PipelineOperation	Uma operação de pipeline de implantação do Power BI
PipelineOperationNote	Uma observação que descreve a implantação.
PipelineOperationStatus	O status da operação do pipeline
PipelineOperationType	O tipo de operação
PipelineOperationUser	Usuário ou entidade de serviço que executou a operação de pipeline.
PreDeploymentDiffInformation	A quantidade de itens novos, diferentes e idênticos implantados antes da implantação.
PrincipalType	O tipo de entidade de segurança

DeploymentError

Detalhes do erro para a etapa de implantação

Nome	Tipo	Description
errorCode	string	O código de erro
errorDetails	string	Detalhes adicionais do erro

DeploymentExecutionPlan

Um plano de execução de implantação

Nome	Tipo	Description
steps	DeploymentExecutionStep[]	A coleção de etapas do plano de execução

DeploymentExecutionStep

Uma etapa de execução de implantação

Nome	Tipo	Description
error	DeploymentError	Os detalhes do erro. Aplicável somente se a operação de pipeline falhou.
index	integer	O índice da etapa
preDeploymentDiffState	DeploymentExecutionStepPreDeploymentDiffState	É um item novo, diferente ou idêntico aos itens no estágio de destino antes da implantação.
sourceAndTarget	DeploymentSourceAndTarget	Os itens de origem e destino da etapa
status	PipelineOperationStatus	O status da operação de pipeline
type	DeploymentStepType	O tipo de etapa de implantação

DeploymentExecutionStepPreDeploymentDiffState

É um item novo, diferente ou idêntico aos itens no estágio de destino antes da implantação.

Nome	Tipo	Description
Different	string	Antes da implantação, o item no estágio de origem não era idêntico ao do estágio de destino.
New	string	Um novo item implantado que não existe no estágio de destino.
NoDifference	string	Antes da implantação, o item no estágio de origem era idêntico ao do estágio de destino.

DeploymentSourceAndTarget

Itens de origem e de destino

Nome	Tipo	Description
source	string	A ID do item do Power BI implantado no estágio de origem
sourceDisplayName	string	O nome de exibição do item do Power BI implantado no estágio de origem
target	string	A ID do item do Power BI que será substituído no estágio de destino. Aplica-se somente ao substituir um item do Power BI.
targetDisplayName	string	O nome do item do Power BI que será substituído no estágio de destino. Aplica-se somente ao substituir um item do Power BI.
type	string	O tipo do item do Power BI que será substituído no estágio de destino. Aplica-se somente ao substituir um item do Power BI.

DeploymentStepType

O tipo de etapa de implantação

Nome	Tipo	Description
DashboardDeployment	string	Uma etapa para implantar um único painel
DataflowDeployment	string	Uma etapa para implantar um único fluxo de dados
DatamartDeployment	string	Uma etapa para implantar um único datamart
DatasetDeployment	string	Uma etapa para implantar um único conjunto de dados
ReportDeployment	string	Uma etapa para implantar um único relatório

PipelineOperation

Uma operação de pipeline de implantação do Power BI

Nome	Tipo	Description
executionEndTime	string	A data e a hora em que a operação terminou
executionPlan	DeploymentExecutionPlan	O plano de execução da implantação. Aplicável somente a uma única operação de pipeline.
executionStartTime	string	A data e a hora em que a operação foi iniciada
id	string	A ID da operação
lastUpdatedTime	string	A data e a hora em que a operação foi atualizada pela última vez
note	PipelineOperationNote	Uma observação que representa uma descrição da operação.
performedBy	PipelineOperationUser	Usuário ou entidade de serviço que executou a operação de pipeline.
preDeploymentDiffInformation	PreDeploymentDiffInformation	A quantidade de itens implantados no estágio de origem, que são novos, idênticos ou diferentes dos itens no estágio de destino, antes da implantação.
sourceStageOrder	integer	O identificador numérico de um estágio de implantação de pipeline de origem. Desenvolvimento (0), Teste (1), Produção (2).
status	PipelineOperationStatus	O status da operação do pipeline
targetStageOrder	integer	O identificador numérico de um estágio de implantação de pipeline de destino. Desenvolvimento (0), Teste (1), Produção (2).
type	PipelineOperationType	O tipo de operação

PipelineOperationNote

Uma observação que descreve a implantação.

Nome	Tipo	Description
content	string	Texto que descreve a implantação.
isTruncated	boolean	Indica se a nota está incompleta. True, apenas parte da nota é retornada. False, a anotação está concluída.

PipelineOperationStatus

O status da operação do pipeline

Nome	Tipo	Description
Executing	string	Operação em execução
Failed	string	Falha na operação
NotStarted	string	Operação não iniciada
Succeeded	string	Operação bem-sucedida

PipelineOperationType

O tipo de operação

Nome	Tipo	Description
Deploy	string	Implantar conteúdo entre estágios

PipelineOperationUser

Usuário ou entidade de serviço que executou a operação de pipeline.

Nome	Tipo	Description
principalObjectID	string	A ID da entidade de serviço que executou a implantação.
principalType	PrincipalType	O tipo de usuário que executou a implantação.
userPrincipalName	string	O UPN do usuário que executou a implantação.

PreDeploymentDiffInformation

A quantidade de itens novos, diferentes e idênticos implantados antes da implantação.

Nome	Tipo	Description
differentArtifactsCount	integer	O número de itens implantados com diferenças entre os estágios de origem e de destino, antes da implantação.
newArtifactsCount	integer	O número de novos itens implantados no estágio de destino.
noDifferenceArtifactsCount	integer	O número de itens implantados idênticos nos estágios de origem e destino, antes da implantação.

PrincipalType

O tipo de entidade de segurança

Nome	Tipo	Description
App	string	Tipo de entidade de serviço
Group	string	Tipo de entidade de grupo
None	string	Nenhum tipo de entidade de segurança. Use para acesso em nível de organização inteiro.
User	string	Tipo de entidade de usuário

Partilhar via