Pipelines - Deploy All

Riferimento

Service:: Power BI REST APIs

API Version:: v1.0

Distribuisce tutti gli elementi supportati dalla fase di origine della pipeline di distribuzione specificata.

Per informazioni sugli elementi non supportati nelle pipeline di distribuzione, vedere Elementi non supportati.

Autorizzazioni

L'utente deve essere almeno un membro nelle aree di lavoro di distribuzione di origine e di destinazione. Per altre informazioni, vedere Autorizzazioni.

Ambito obbligatorio

Pipeline.Deploy

Limitazioni

Massimo 300 elementi distribuiti per richiesta.

POST https://api.powerbi.com/v1.0/myorg/pipelines/{pipelineId}/deployAll

Parametri dell'URI

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

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
sourceStageOrder	True	integer	Identificatore numerico della fase di distribuzione della pipeline da cui deve essere distribuito il contenuto. Sviluppo (0), Test (1), Produzione (2).
isBackwardDeployment		boolean	Se la distribuzione sarà da una fase successiva nella pipeline di distribuzione, a una versione precedente. Il valore predefinito è `false`.
newWorkspace		PipelineNewWorkspaceRequest	Dettagli della configurazione per la creazione di una nuova area di lavoro. Obbligatorio durante la distribuzione in una fase senza aree di lavoro assegnate. La distribuzione avrà esito negativo se i nuovi dettagli della configurazione dell'area di lavoro non vengono forniti quando necessario.
note		string	Nota che descrive la distribuzione.
options		DeploymentOptions	Opzioni che controllano il comportamento dell'intera distribuzione
updateAppSettings		PipelineUpdateAppSettings	Aggiornare l'app dell'organizzazione nelle impostazioni dell'area di lavoro di destinazione

Risposte

Nome	Tipo	Descrizione
202 Accepted	PipelineOperation	Accettato

Esempio

Example of deploying all Power BI items (such as reports or dashboards) from the 'Development' stage

Sample Request

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

Request Body

{
  "sourceStageOrder": 0,
  "options": {
    "allowOverwriteArtifact": true,
    "allowCreateArtifact": true
  },
  "note": "Deploying business ready items"
}

Sample Response

Status code:: 200

{
  "value": [
    {
      "id": "1065e6a3-a020-4c0c-ada7-92b5fe99eec5",
      "type": "Deploy",
      "status": "NotStarted",
      "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
    }
  ]
}

Definizioni

Nome	Descrizione
DeployAllRequest	Richiesta di distribuzione di tutti gli elementi supportati da una fase della pipeline di distribuzione
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.
DeploymentOptions	Opzioni di configurazione della distribuzione. Può essere specificato per l'intera distribuzione o per un elemento di Power BI specifico, ad esempio un report o un dashboard. Se vengono specificati entrambi, vengono usate solo le opzioni di distribuzione per l'elemento di Power BI.
DeploymentSourceAndTarget	Elementi di origine e destinazione
DeploymentStepType	Tipo di passaggio della distribuzione
PipelineNewWorkspaceRequest	Dettagli della configurazione per la creazione di una nuova area di lavoro. Obbligatorio durante la distribuzione in una fase senza aree di lavoro assegnate.
PipelineOperation	Operazione della pipeline di distribuzione di Power BI
PipelineOperationNote	Nota che descrive la distribuzione.
PipelineOperationStatus	Stato dell'operazione della pipeline
PipelineOperationType	Tipo di operazione
PipelineOperationUser	Entità servizio o utente che ha eseguito l'operazione della pipeline.
PipelineUpdateAppSettings	Aggiornamento della configurazione dell'app dell'organizzazione dopo la distribuzione
PreDeploymentDiffInformation	Quantità di nuovi elementi distribuiti diversi e identici prima della distribuzione.
PrincipalType	Tipo principale

DeployAllRequest

Richiesta di distribuzione di tutti gli elementi supportati da una fase della pipeline di distribuzione

Nome	Tipo	Descrizione
isBackwardDeployment	boolean	Se la distribuzione sarà da una fase successiva nella pipeline di distribuzione, a una versione precedente. Il valore predefinito è `false`.
newWorkspace	PipelineNewWorkspaceRequest	Dettagli della configurazione per la creazione di una nuova area di lavoro. Obbligatorio durante la distribuzione in una fase senza aree di lavoro assegnate. La distribuzione avrà esito negativo se i nuovi dettagli della configurazione dell'area di lavoro non vengono forniti quando necessario.
note	string	Nota che descrive la distribuzione.
options	DeploymentOptions	Opzioni che controllano il comportamento dell'intera distribuzione
sourceStageOrder	integer	Identificatore numerico della fase di distribuzione della pipeline da cui deve essere distribuito il contenuto. Sviluppo (0), Test (1), Produzione (2).
updateAppSettings	PipelineUpdateAppSettings	Aggiornare l'app dell'organizzazione nelle impostazioni dell'area di lavoro di destinazione

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.

DeploymentOptions

Opzioni di configurazione della distribuzione. Può essere specificato per l'intera distribuzione o per un elemento di Power BI specifico, ad esempio un report o un dashboard. Se vengono specificati entrambi, vengono usate solo le opzioni di distribuzione per l'elemento di Power BI.

Nome	Tipo	Descrizione
allowCreateArtifact	boolean	Se la creazione di un nuovo elemento di Power BI (ad esempio un report o un dashboard) nell'area di lavoro della fase di destinazione è consentita. Se questa opzione non è impostata su `true` quando è necessaria per la distribuzione, la distribuzione avrà esito negativo.
allowOverwriteArtifact	boolean	Se è consentita la sovrascrittura di un elemento di Power BI, ad esempio un report o un dashboard, nell'area di lavoro della fase di destinazione. Se questa opzione non è impostata su `true` quando è necessaria per la distribuzione, la distribuzione avrà esito negativo.
allowOverwriteTargetArtifactLabel	boolean	Se l'etichetta di un elemento di Power BI di destinazione (ad esempio un report o un dashboard) può essere modificata. L'etichetta viene modificata quando l'origine è protetta, ma la destinazione non è. Se questa opzione non è impostata su `true` quando è necessaria per la distribuzione, la distribuzione avrà esito negativo.
allowPurgeData	boolean	Se eliminare tutti i dati dall'elemento di Power BI di destinazione,ad esempio un report o un dashboard, quando si verifica una mancata corrispondenza dello schema. Se questa opzione non è impostata su `true` quando è necessaria per la distribuzione, la distribuzione avrà esito negativo.
allowSkipTilesWithMissingPrerequisites	boolean	Se ignorare i riquadri che non hanno un modello o un report nell'area di lavoro della fase di destinazione. Se questa opzione non è impostata su `true` quando è necessaria per la distribuzione, la distribuzione avrà esito negativo.
allowTakeOver	boolean	Se consentire l'override del proprietario del report impaginato precedente e diventare il proprietario del report impaginato. Applicabile quando si distribuisce un report impaginato in una fase che contiene già una copia del report impaginato che non è di proprietà dell'utente. Se questa opzione non è impostata su `true` quando è necessaria per la distribuzione, la distribuzione avrà esito negativo.

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

PipelineNewWorkspaceRequest

Dettagli della configurazione per la creazione di una nuova area di lavoro. Obbligatorio durante la distribuzione in una fase senza aree di lavoro assegnate.

Nome	Tipo	Descrizione
capacityId	string	ID della capacità a cui verrà assegnata la nuova area di lavoro. Se non specificato e il chiamante API dispone delle autorizzazioni per la capacità dell'area di lavoro della fase di origine, tale capacità verrà usata. In caso contrario, Power BI selezionerà una capacità per cui il chiamante API dispone delle autorizzazioni.
name	string	Nome della nuova area di lavoro

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.

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.

PipelineUpdateAppSettings

Aggiornamento della configurazione dell'app dell'organizzazione dopo la distribuzione

Nome	Tipo	Descrizione
updateAppInTargetWorkspace	boolean	Se aggiornare l'app nell'area di lavoro di destinazione. Vengono aggiornati solo gli elementi distribuiti già presenti nell'app. I nuovi elementi distribuiti non vengono aggiunti all'app.

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