Pipelines - Get Pipeline Operations

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Restituisce un elenco delle operazioni di distribuzione fino a 20 più recenti eseguite nella pipeline di distribuzione specificata.

Ambito obbligatorio

Pipeline.ReadWrite.All o Pipeline.Read.All

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
pipelineId	path	True	string uuid	ID della pipeline di distribuzione

Risposte

Nome	Tipo	Descrizione
200 OK	PipelineOperations	OK

Esempio

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

Definizioni

Nome	Descrizione
DeploymentError	Dettagli dell'errore per il passaggio di distribuzione
DeploymentExecutionPlan	Piano di esecuzione della distribuzione
DeploymentExecutionStep	Passaggio di esecuzione della distribuzione
DeploymentExecutionStepPreDeploymentDiffState	Elemento nuovo, diverso o identico agli elementi nella fase di destinazione prima della distribuzione.
DeploymentSourceAndTarget	Elementi di origine e destinazione
DeploymentStepType	Tipo di passaggio della distribuzione
PipelineOperation	Operazione della pipeline di distribuzione di Power BI
PipelineOperationNote	Nota che descrive la distribuzione.
PipelineOperations	Wrapper di risposta OData per una raccolta di operazioni della pipeline di distribuzione di Power BI
PipelineOperationStatus	Stato dell'operazione della pipeline
PipelineOperationType	Tipo di operazione
PipelineOperationUser	Entità servizio o utente che ha eseguito l'operazione della pipeline.
PreDeploymentDiffInformation	Quantità di nuovi elementi distribuiti diversi e identici prima della distribuzione.
PrincipalType	Tipo principale

DeploymentError

Dettagli dell'errore per il passaggio di distribuzione

Nome	Tipo	Descrizione
errorCode	string	Il codice di errore
errorDetails	string	Dettagli di errore aggiuntivi

DeploymentExecutionPlan

Piano di esecuzione della distribuzione

Nome	Tipo	Descrizione
steps	DeploymentExecutionStep[]	Raccolta dei passaggi del piano di esecuzione

DeploymentExecutionStep

Passaggio di esecuzione della distribuzione

Nome	Tipo	Descrizione
error	DeploymentError	Dettagli dell'errore. Applicabile solo se l'operazione della pipeline non è riuscita.
index	integer	Indice passaggio
preDeploymentDiffState	DeploymentExecutionStepPreDeploymentDiffState	Elemento nuovo, diverso o identico agli elementi nella fase di destinazione prima della distribuzione.
sourceAndTarget	DeploymentSourceAndTarget	Elementi di origine e destinazione del passaggio
status	PipelineOperationStatus	Stato dell'operazione della pipeline
type	DeploymentStepType	Tipo di passaggio della distribuzione

DeploymentExecutionStepPreDeploymentDiffState

Elemento nuovo, diverso o identico agli elementi nella fase di destinazione prima della distribuzione.

Nome	Tipo	Descrizione
Different	string	Prima della distribuzione, l'elemento nella fase di origine non era identico a quello nella fase di destinazione.
New	string	Nuovo elemento distribuito che non esiste nella fase di destinazione.
NoDifference	string	Prima della distribuzione, l'elemento nella fase di origine era identico a quello nella fase di destinazione.

DeploymentSourceAndTarget

Elementi di origine e destinazione

Nome	Tipo	Descrizione
source	string	ID dell'elemento di Power BI distribuito dalla fase di origine
sourceDisplayName	string	Nome visualizzato dell'elemento di Power BI distribuito dalla fase di origine
target	string	ID dell'elemento di Power BI sovrascritto nella fase di destinazione. Si applica solo quando si sovrascrive un elemento di Power BI.
targetDisplayName	string	Nome dell'elemento di Power BI sovrascritto nella fase di destinazione. Si applica solo quando si sovrascrive un elemento di Power BI.
type	string	Tipo dell'elemento di Power BI sovrascritto nella fase di destinazione. Si applica solo quando si sovrascrive un elemento di Power BI.

DeploymentStepType

Tipo di passaggio della distribuzione

Nome	Tipo	Descrizione
DashboardDeployment	string	Passaggio per la distribuzione di un singolo dashboard
DataflowDeployment	string	Passaggio per la distribuzione di un singolo flusso di dati
DatamartDeployment	string	Passaggio per la distribuzione di un singolo datamart
DatasetDeployment	string	Passaggio per la distribuzione di un singolo set di dati
ReportDeployment	string	Passaggio per la distribuzione di un singolo report

PipelineOperation

Operazione della pipeline di distribuzione di Power BI

Nome	Tipo	Descrizione
executionEndTime	string	Data e ora di fine dell'operazione
executionPlan	DeploymentExecutionPlan	Piano di esecuzione della distribuzione. Applicabile solo a una singola operazione della pipeline.
executionStartTime	string	Data e ora di avvio dell'operazione
id	string	ID operazione
lastUpdatedTime	string	Data e ora dell'ultimo aggiornamento dell'operazione
note	PipelineOperationNote	Nota che rappresenta una descrizione dell'operazione.
performedBy	PipelineOperationUser	Entità servizio o utente che ha eseguito l'operazione della pipeline.
preDeploymentDiffInformation	PreDeploymentDiffInformation	Quantità di elementi distribuiti nella fase di origine, nuovi, identici o diversi agli elementi nella fase di destinazione, prima della distribuzione.
sourceStageOrder	integer	Identificatore numerico di una fase di distribuzione della pipeline di origine. Sviluppo (0), Test (1), Produzione (2).
status	PipelineOperationStatus	Stato dell'operazione della pipeline
targetStageOrder	integer	Identificatore numerico di una fase di distribuzione della pipeline di destinazione. Sviluppo (0), Test (1), Produzione (2).
type	PipelineOperationType	Tipo di operazione

PipelineOperationNote

Nota che descrive la distribuzione.

Nome	Tipo	Descrizione
content	string	Testo che descrive la distribuzione.
isTruncated	boolean	Indica se la nota è incompleta. True, viene restituita solo una parte della nota. False, la nota è completa.

PipelineOperations

Wrapper di risposta OData per una raccolta di operazioni della pipeline di distribuzione di Power BI

Nome	Tipo	Descrizione
odata.context	string	Contesto OData
value	PipelineOperation[]	Raccolta di operazioni della pipeline di distribuzione

PipelineOperationStatus

Stato dell'operazione della pipeline

Nome	Tipo	Descrizione
Executing	string	Operazione in esecuzione
Failed	string	Operazione non riuscita
NotStarted	string	Operazione non avviata
Succeeded	string	Operazione riuscita

PipelineOperationType

Tipo di operazione

Nome	Tipo	Descrizione
Deploy	string	Distribuire il contenuto tra le fasi

PipelineOperationUser

Entità servizio o utente che ha eseguito l'operazione della pipeline.

Nome	Tipo	Descrizione
principalObjectID	string	ID dell'entità servizio che ha eseguito la distribuzione.
principalType	PrincipalType	Tipo di utente che ha eseguito la distribuzione.
userPrincipalName	string	UPN dell'utente che ha eseguito la distribuzione.

PreDeploymentDiffInformation

Quantità di nuovi elementi distribuiti diversi e identici prima della distribuzione.

Nome	Tipo	Descrizione
differentArtifactsCount	integer	Numero di elementi distribuiti con differenze tra le fasi di origine e di destinazione, prima della distribuzione.
newArtifactsCount	integer	Numero di nuovi elementi distribuiti nella fase di destinazione.
noDifferenceArtifactsCount	integer	Numero di elementi distribuiti identici nelle fasi di origine e destinazione, prima della distribuzione.

PrincipalType

Tipo principale

Nome	Tipo	Descrizione
App	string	Tipo di entità servizio
Group	string	Tipo di entità gruppo
None	string	Nessun tipo di entità. Usare per l'accesso a livello di organizzazione intero.
User	string	Tipo di entità utente

Condividi tramite