Runs - Run Pipeline

Service:

Pipelines

API Version:

6.1-preview.1

运行管道。

POST https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?api-version=6.1-preview.1

With optional parameters:

POST https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?pipelineVersion={pipelineVersion}&api-version=6.1-preview.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
pipelineId	path	True	integer int32	管道 ID。
project	path	True	string	项目 ID 或项目名称
api-version	query	True	string	要使用的 API 版本。 这应设置为“6.1-preview.1”才能使用此版本的 API。
pipelineVersion	query		integer int32	管道版本。

请求正文

名称	类型	说明
previewRun	boolean	如果为 true，则不要实际创建新运行。 相反，在分析模板后返回最终的 YAML 文档。
resources	RunResourcesParameters	运行所需的资源。
stagesToSkip	string[]
templateParameters	object
variables	<string,  Variable>
yamlOverride	string	如果使用预览运行选项，可以选择提供不同的 YAML。 这样，无需提交更改的文件即可预览最终 YAML 文档。

响应

名称	类型	说明
200 OK	Run	成功的操作

安全性

accessToken

个人访问令牌。 将任何值用作用户名和令牌作为密码。

Type: basic

定义

名称	说明
BuildResourceParameters
ContainerResourceParameters
PackageResourceParameters
PipelineReference	对管道的引用。
PipelineResourceParameters
ReferenceLinks	表示 REST 引用链接集合的类。
Repository
RepositoryResource
RepositoryResourceParameters
RepositoryType
Run
RunPipelineParameters	影响管道运行的设置。
RunResources
RunResourcesParameters
RunResult
RunState
Variable

BuildResourceParameters

名称	类型	说明
version	string

ContainerResourceParameters

名称	类型	说明
version	string

PackageResourceParameters

名称	类型	说明
version	string

PipelineReference

对管道的引用。

名称	类型	说明
folder	string	管道文件夹
id	integer	管道 ID
name	string	管道名称
revision	integer	修订号
url	string

PipelineResourceParameters

名称	类型	说明
version	string

ReferenceLinks

表示 REST 引用链接集合的类。

名称	类型	说明
links	object	链接的只读视图。 由于引用链接是只读的，因此我们只想将其公开为只读。

Repository

名称	类型	说明
type	RepositoryType

RepositoryResource

名称	类型	说明
refName	string
repository	Repository
version	string

RepositoryResourceParameters

名称	类型	说明
refName	string
token	string	这是连接到存储库时要使用的安全令牌。
tokenType	string	可选。 这是给定的令牌的类型。 如果未提供，则假定类型为“Bearer”。 注意：对 PAT 令牌使用“基本”。
version	string

RepositoryType

名称	类型	说明
azureReposGit	string
azureReposGitHyphenated	string
gitHub	string
gitHubEnterprise	string
unknown	string

Run

名称	类型	说明
_links	ReferenceLinks	表示 REST 引用链接集合的类。
createdDate	string
finalYaml	string
finishedDate	string
id	integer
name	string
pipeline	PipelineReference	对管道的引用。
resources	RunResources
result	RunResult
state	RunState
url	string
variables	<string,  Variable>

RunPipelineParameters

影响管道运行的设置。

名称	类型	说明
previewRun	boolean	如果为 true，则不要实际创建新运行。 相反，在分析模板后返回最终的 YAML 文档。
resources	RunResourcesParameters	运行所需的资源。
stagesToSkip	string[]
templateParameters	object
variables	<string,  Variable>
yamlOverride	string	如果使用预览运行选项，可以选择提供不同的 YAML。 这样，无需提交更改的文件即可预览最终 YAML 文档。

RunResources

名称	类型	说明
repositories	<string,  RepositoryResource>

RunResourcesParameters

名称	类型	说明
builds	<string,  BuildResourceParameters>
containers	<string,  ContainerResourceParameters>
packages	<string,  PackageResourceParameters>
pipelines	<string,  PipelineResourceParameters>
repositories	<string,  RepositoryResourceParameters>

RunResult

名称	类型	说明
canceled	string
failed	string
succeeded	string
unknown	string

RunState

名称	类型	说明
canceling	string
completed	string
inProgress	string
unknown	string

Variable

名称	类型	说明
isSecret	boolean
value	string