Pipelines - Get Pipeline Operation

Başvuru

Service:: Power BI REST APIs

API Version:: v1.0

Dağıtım yürütme planı da dahil olmak üzere belirtilen dağıtım işlem hattında gerçekleştirilen belirtilen dağıtım işleminin ayrıntılarını döndürür.

Dağıtım işleminin durumunu izlemek için kullanın.

Gerekli Kapsam

Pipeline.ReadWrite.All veya Pipeline.Read.All

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
operationId	path	True	string uuid	İşlem kimliği
pipelineId	path	True	string uuid	Dağıtım işlem hattı kimliği

Yanıtlar

Name	Tür	Description
200 OK	PipelineOperation	Tamam

Örnekler

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

Tanımlar

Name	Description
DeploymentError	Dağıtım adımı için hata ayrıntıları
DeploymentExecutionPlan	Dağıtım yürütme planı
DeploymentExecutionStep	Dağıtım yürütme adımı
DeploymentExecutionStepPreDeploymentDiffState	Yeni, farklı veya dağıtımdan önceki hedef aşamadaki öğelerle aynı öğedir.
DeploymentSourceAndTarget	Kaynak ve hedef öğeler
DeploymentStepType	Dağıtım adımının türü
PipelineOperation	Power BI dağıtım işlem hattı işlemi
PipelineOperationNote	Dağıtımı açıklayan bir not.
PipelineOperationStatus	İşlem hattı işlem durumu
PipelineOperationType	İşlem türü
PipelineOperationUser	İşlem hattı işlemini gerçekleştiren kullanıcı veya hizmet sorumlusu.
PreDeploymentDiffInformation	Dağıtımdan önce yeni, farklı ve özdeş dağıtılan öğelerin miktarı.
PrincipalType	Sorumlu türü

DeploymentError

Dağıtım adımı için hata ayrıntıları

Name	Tür	Description
errorCode	string	Hata kodu
errorDetails	string	Ek hata ayrıntıları

DeploymentExecutionPlan

Dağıtım yürütme planı

Name	Tür	Description
steps	DeploymentExecutionStep[]	Yürütme planı adımlarının koleksiyonu

DeploymentExecutionStep

Dağıtım yürütme adımı

Name	Tür	Description
error	DeploymentError	Hata ayrıntıları. Yalnızca işlem hattı işlemi başarısız olduğunda geçerlidir.
index	integer	Adım dizini
preDeploymentDiffState	DeploymentExecutionStepPreDeploymentDiffState	Yeni, farklı veya dağıtımdan önceki hedef aşamadaki öğelerle aynı öğedir.
sourceAndTarget	DeploymentSourceAndTarget	Adımın kaynak ve hedef öğeleri
status	PipelineOperationStatus	İşlem hattı işleminin durumu
type	DeploymentStepType	Dağıtım adımının türü

DeploymentExecutionStepPreDeploymentDiffState

Yeni, farklı veya dağıtımdan önceki hedef aşamadaki öğelerle aynı öğedir.

Name	Tür	Description
Different	string	Dağıtımdan önce, kaynak aşamadaki öğe hedef aşamadaki öğeyle aynı değildi.
New	string	Hedef aşamada mevcut olmayan yeni bir dağıtılan öğe.
NoDifference	string	Dağıtımdan önce, kaynak aşamadaki öğe hedef aşamadaki öğeyle aynıydı.

DeploymentSourceAndTarget

Kaynak ve hedef öğeler

Name	Tür	Description
source	string	Kaynak aşamadan dağıtılan Power BI öğesinin kimliği
sourceDisplayName	string	Kaynak aşamadan dağıtılan Power BI öğesinin görünen adı
target	string	Hedef aşamada üzerine yazılacak Power BI öğesinin kimliği. Yalnızca Power BI öğesinin üzerine yazılırken geçerlidir.
targetDisplayName	string	Hedef aşamada üzerine yazılacak Power BI öğesinin adı. Yalnızca Power BI öğesinin üzerine yazılırken geçerlidir.
type	string	Hedef aşamada üzerine yazılacak Power BI öğesinin türü. Yalnızca Power BI öğesinin üzerine yazılırken geçerlidir.

DeploymentStepType

Dağıtım adımının türü

Name	Tür	Description
DashboardDeployment	string	Tek bir panoyu dağıtma adımı
DataflowDeployment	string	Tek bir veri akışını dağıtma adımı
DatamartDeployment	string	Tek bir datamart dağıtma adımı
DatasetDeployment	string	Tek bir veri kümesini dağıtma adımı
ReportDeployment	string	Tek bir raporu dağıtma adımı

PipelineOperation

Power BI dağıtım işlem hattı işlemi

Name	Tür	Description
executionEndTime	string	İşlemin sona ermiş olduğu tarih ve saat
executionPlan	DeploymentExecutionPlan	Dağıtım yürütme planı. Yalnızca tek bir işlem hattı işlemi için geçerlidir.
executionStartTime	string	İşlemin başlatıldığını tarih ve saat
id	string	İşlem kimliği
lastUpdatedTime	string	İşlemin son güncelleştirildiği tarih ve saat
note	PipelineOperationNote	İşlemin açıklamasını temsil eden not.
performedBy	PipelineOperationUser	İşlem hattı işlemini gerçekleştiren kullanıcı veya hizmet sorumlusu.
preDeploymentDiffInformation	PreDeploymentDiffInformation	Dağıtımdan önce, yeni, özdeş veya hedef aşamadaki öğelerden farklı olan, kaynak aşamada dağıtılan öğelerin miktarı.
sourceStageOrder	integer	Kaynak işlem hattı dağıtım aşamasının sayısal tanımlayıcısı. Geliştirme (0), Test (1), Üretim (2).
status	PipelineOperationStatus	İşlem hattı işlem durumu
targetStageOrder	integer	Hedef işlem hattı dağıtım aşamasının sayısal tanımlayıcısı. Geliştirme (0), Test (1), Üretim (2).
type	PipelineOperationType	İşlem türü

PipelineOperationNote

Dağıtımı açıklayan bir not.

Name	Tür	Description
content	string	Dağıtımı açıklayan metin.
isTruncated	boolean	Notunun tamamlanmamış olup olmadığını gösterir. Doğru, notun yalnızca bir bölümü döndürülür. False, not tamamlandı.

PipelineOperationStatus

İşlem hattı işlem durumu

Name	Tür	Description
Executing	string	İşlem yürütülüyor
Failed	string	İşlem başarısız oldu
NotStarted	string	İşlem başlatılmaz
Succeeded	string	İşlem başarılı oldu

PipelineOperationType

İşlem türü

Name	Tür	Description
Deploy	string	Aşamalar arasında içerik dağıtma

PipelineOperationUser

İşlem hattı işlemini gerçekleştiren kullanıcı veya hizmet sorumlusu.

Name	Tür	Description
principalObjectID	string	Dağıtımı gerçekleştiren hizmet sorumlusunun kimliği.
principalType	PrincipalType	Dağıtımı gerçekleştiren kullanıcının türü.
userPrincipalName	string	Dağıtımı gerçekleştiren kullanıcının UPN'i.

PreDeploymentDiffInformation

Dağıtımdan önce yeni, farklı ve özdeş dağıtılan öğelerin miktarı.

Name	Tür	Description
differentArtifactsCount	integer	Dağıtımdan önce kaynak ve hedef aşamalar arasındaki farklara sahip dağıtılan öğelerin sayısı.
newArtifactsCount	integer	Hedef aşamaya dağıtılan yeni öğelerin sayısı.
noDifferenceArtifactsCount	integer	Dağıtımdan önce kaynak ve hedef aşamalardaki aynı dağıtılan öğelerin sayısı.

PrincipalType

Sorumlu türü

Name	Tür	Description
App	string	Hizmet sorumlusu türü
Group	string	Grup sorumlusu türü
None	string	Sorumlu türü yok. Tüm kuruluş düzeyinde erişim için kullanın.
User	string	Kullanıcı asıl türü

Aracılığıyla paylaş