Pipelines - Create Pipeline

服務:

Power BI REST APIs

API 版本:

v1.0

建立新的部署管線。

必要範圍

Pipeline.ReadWrite.All

POST https://api.powerbi.com/v1.0/myorg/pipelines

要求本文

名稱	必要	類型	Description
displayName	True	string maxLength: 256	新部署管線的顯示名稱
description		string maxLength: 1024	新部署管線的描述

回應

名稱	類型	Description
201 Created	Pipeline	已建立

範例

Create a deployment pipeline example

範例要求

POST https://api.powerbi.com/v1.0/myorg/pipelines

要求本文

{
  "displayName": "My Deployment Pipeline Name",
  "description": "My deployment pipeline description"
}

範例回覆

狀態碼:

201

{
  "id": "a5ded933-57b7-41f4-b072-ed4c1f9d5824",
  "displayName": "My Deployment Pipeline Name",
  "description": "My deployment pipeline description"
}

定義

名稱	Description
CreatePipelineRequest	建立新部署管線的要求
Pipeline	Power BI 管線
PipelineStage	Power BI 部署管線階段

CreatePipelineRequest

Object

建立新部署管線的要求

名稱	類型	Description
description	string maxLength: 1024	新部署管線的描述
displayName	string maxLength: 256	新部署管線的顯示名稱

Pipeline

Object

Power BI 管線

名稱	類型	Description
description	string	部署管線描述
displayName	string	部署管線顯示名稱
id	string (uuid)	部署管線標識碼
stages	PipelineStage[]	部署管線階段的集合。 只有在要求中 $expand 設定為 stages 時，才會傳回 。

PipelineStage

Object

Power BI 部署管線階段

名稱	類型	Description
order	integer	階段順序，從零開始。
workspaceId	string (uuid)	指派的工作區標識碼。 僅適用於有指派的工作區時。
workspaceName	string	指派的工作區名稱。 只有在有指派的工作區，且使用者具有工作區的存取權時，才適用。