Pipelines - Get Pipeline Operations

Referenz

Service:: Power BI REST APIs

API Version:: v1.0

Gibt eine Liste der bis zu 20 letzten Bereitstellungsvorgänge zurück, die für die angegebene Bereitstellungspipeline ausgeführt wurden.

Erforderlicher Bereich

Pipeline.ReadWrite.All oder Pipeline.Read.All

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
pipelineId	path	True	string uuid	Die ID der Bereitstellungspipeline

Antworten

Name	Typ	Beschreibung
200 OK	PipelineOperations	OK

Beispiele

Get pipeline operations example

Sample Request

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

Sample Response

Status code:: 200

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

Definitionen

Name	Beschreibung
DeploymentError	Fehlerdetails für den Bereitstellungsschritt
DeploymentExecutionPlan	Ein Bereitstellungsausführungsplan
DeploymentExecutionStep	Ein Bereitstellungsausführungsschritt
DeploymentExecutionStepPreDeploymentDiffState	Ist ein Element neu, anders oder identisch mit Elementen in der Zielphase vor der Bereitstellung.
DeploymentSourceAndTarget	Quell- und Zielelemente
DeploymentStepType	Der Typ des Bereitstellungsschritts
PipelineOperation	Ein Power BI-Bereitstellungspipelinevorgang
PipelineOperationNote	Ein Hinweis, der die Bereitstellung beschreibt.
PipelineOperations	OData-Antwortwrapper für eine Sammlung von Power BI-Bereitstellungspipelinevorgängen
PipelineOperationStatus	Der Status des Pipelinevorgangs
PipelineOperationType	Der Vorgangstyp
PipelineOperationUser	Benutzer oder Dienstprinzipal, der den Pipelinevorgang ausgeführt hat.
PreDeploymentDiffInformation	Die Menge der neuen, unterschiedlichen und identischen bereitgestellten Elemente vor der Bereitstellung.
PrincipalType	Der Prinzipaltyp

DeploymentError

Fehlerdetails für den Bereitstellungsschritt

Name	Typ	Beschreibung
errorCode	string	Den Fehlercode
errorDetails	string	Zusätzliche Fehlerdetails

DeploymentExecutionPlan

Ein Bereitstellungsausführungsplan

Name	Typ	Beschreibung
steps	DeploymentExecutionStep[]	Die Auflistung der Ausführungsplanschritte

DeploymentExecutionStep

Ein Bereitstellungsausführungsschritt

Name	Typ	Beschreibung
error	DeploymentError	Die Fehlerdetails. Gilt nur, wenn der Pipelinevorgang fehlgeschlagen ist.
index	integer	Der Schrittindex
preDeploymentDiffState	DeploymentExecutionStepPreDeploymentDiffState	Ist ein Element neu, anders oder identisch mit Elementen in der Zielphase vor der Bereitstellung.
sourceAndTarget	DeploymentSourceAndTarget	Die Quell- und Zielelemente des Schritts
status	PipelineOperationStatus	Der Status des Pipelinevorgangs
type	DeploymentStepType	Der Typ des Bereitstellungsschritts

DeploymentExecutionStepPreDeploymentDiffState

Ist ein Element neu, anders oder identisch mit Elementen in der Zielphase vor der Bereitstellung.

Name	Typ	Beschreibung
Different	string	Vor der Bereitstellung war das Element in der Quellphase nicht mit dem Element in der Zielphase identisch.
New	string	Ein neues bereitgestelltes Element, das in der Zielphase nicht vorhanden ist.
NoDifference	string	Vor der Bereitstellung war das Element in der Quellphase mit dem Element in der Zielphase identisch.

DeploymentSourceAndTarget

Quell- und Zielelemente

Name	Typ	Beschreibung
source	string	Die ID des Power BI-Elements, das aus der Quellphase bereitgestellt wird.
sourceDisplayName	string	Der Anzeigename des Power BI-Elements, das aus der Quellphase bereitgestellt wird.
target	string	Die ID des Power BI-Elements, das in der Zielphase überschrieben wird. Gilt nur beim Überschreiben eines Power BI-Elements.
targetDisplayName	string	Der Name des Power BI-Elements, das in der Zielphase überschrieben wird. Gilt nur beim Überschreiben eines Power BI-Elements.
type	string	Der Typ des Power BI-Elements, das in der Zielphase überschrieben wird. Gilt nur beim Überschreiben eines Power BI-Elements.

DeploymentStepType

Der Typ des Bereitstellungsschritts

Name	Typ	Beschreibung
DashboardDeployment	string	Ein Schritt zum Bereitstellen eines einzelnen Dashboards
DataflowDeployment	string	Ein Schritt zum Bereitstellen eines einzelnen Dataflows
DatamartDeployment	string	Ein Schritt zum Bereitstellen eines einzelnen Datamart
DatasetDeployment	string	Ein Schritt zum Bereitstellen eines einzelnen Datasets
ReportDeployment	string	Ein Schritt zum Bereitstellen eines einzelnen Berichts

PipelineOperation

Ein Power BI-Bereitstellungspipelinevorgang

Name	Typ	Beschreibung
executionEndTime	string	Datum und Uhrzeit des Vorgangsendes
executionPlan	DeploymentExecutionPlan	Der Bereitstellungsausführungsplan. Gilt nur für einen einzelnen Pipelinevorgang.
executionStartTime	string	Datum und Uhrzeit des Vorgangsstarts
id	string	Die Vorgangs-ID
lastUpdatedTime	string	Datum und Uhrzeit der letzten Aktualisierung des Vorgangs
note	PipelineOperationNote	Ein Hinweis, der eine Beschreibung des Vorgangs darstellt.
performedBy	PipelineOperationUser	Benutzer oder Dienstprinzipal, der den Pipelinevorgang ausgeführt hat.
preDeploymentDiffInformation	PreDeploymentDiffInformation	Die Menge der bereitgestellten Elemente in der Quellphase, die neu, identisch oder sich von Elementen in der Zielphase unterscheiden, vor der Bereitstellung.
sourceStageOrder	integer	Der numerische Bezeichner einer Bereitstellungsphase der Quellpipeline. Entwicklung (0), Test (1), Produktion (2).
status	PipelineOperationStatus	Der Status des Pipelinevorgangs
targetStageOrder	integer	Der numerische Bezeichner einer Bereitstellungsphase einer Zielpipeline. Entwicklung (0), Test (1), Produktion (2).
type	PipelineOperationType	Der Vorgangstyp

PipelineOperationNote

Ein Hinweis, der die Bereitstellung beschreibt.

Name	Typ	Beschreibung
content	string	Text, der die Bereitstellung beschreibt.
isTruncated	boolean	Gibt an, ob die Notiz unvollständig ist. True, nur ein Teil der Notiz wird zurückgegeben. False, die Notiz ist abgeschlossen.

PipelineOperations

OData-Antwortwrapper für eine Sammlung von Power BI-Bereitstellungspipelinevorgängen

Name	Typ	Beschreibung
odata.context	string	OData-Kontext
value	PipelineOperation[]	Die Sammlung von Bereitstellungspipelinevorgängen

PipelineOperationStatus

Der Status des Pipelinevorgangs

Name	Typ	Beschreibung
Executing	string	Ausführen des Vorgangs
Failed	string	Fehler beim Vorgang
NotStarted	string	Vorgang nicht gestartet
Succeeded	string	Vorgang erfolgreich

PipelineOperationType

Der Vorgangstyp

Name	Typ	Beschreibung
Deploy	string	Bereitstellen von Inhalten zwischen Phasen

PipelineOperationUser

Benutzer oder Dienstprinzipal, der den Pipelinevorgang ausgeführt hat.

Name	Typ	Beschreibung
principalObjectID	string	Die ID des Dienstprinzipals, der die Bereitstellung ausgeführt hat.
principalType	PrincipalType	Der Typ des Benutzers, der die Bereitstellung ausgeführt hat.
userPrincipalName	string	Der UPN des Benutzers, der die Bereitstellung ausgeführt hat.

PreDeploymentDiffInformation

Die Menge der neuen, unterschiedlichen und identischen bereitgestellten Elemente vor der Bereitstellung.

Name	Typ	Beschreibung
differentArtifactsCount	integer	Die Anzahl der bereitgestellten Elemente mit Unterschieden zwischen Quell- und Zielphasen vor der Bereitstellung.
newArtifactsCount	integer	Die Anzahl der neuen Elemente, die in der Zielphase bereitgestellt werden.
noDifferenceArtifactsCount	integer	Die Anzahl identischer bereitgestellter Elemente in der Quell- und Zielphase vor der Bereitstellung.

PrincipalType

Der Prinzipaltyp

Name	Typ	Beschreibung
App	string	Dienstprinzipaltyp
Group	string	Gruppenprinzipaltyp
None	string	Kein Prinzipaltyp. Verwenden Sie für den Gesamten Zugriff auf Organisationsebene.
User	string	Benutzerprinzipaltyp