Runs - Get

取得特定管線的執行。

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

URI 參數

名稱 位於 必要 類型 Description
organization
path True

string

Azure DevOps 組織的名稱。

pipelineId
path True

integer

int32

管線識別碼

project
path True

string

專案識別碼或專案名稱

runId
path True

integer

int32

執行識別碼

api-version
query True

string

要使用的 API 版本。 這應該設定為 '7.1-preview.1' 以使用此版本的 API。

回應

名稱 類型 Description
200 OK

Run

成功作業

安全性

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

名稱 Description
vso.build 授與存取組建成品的能力,包括建置結果、定義和要求,以及能夠透過服務勾點接收有關建置事件的通知。

定義

名稱 Description
Container
ContainerResource
PipelineReference

管線的參考。

PipelineResource
ReferenceLinks

表示 REST 參考連結集合的類別。

Repository
RepositoryResource
RepositoryType
Run
RunResources
RunResult
RunState
Variable

Container

名稱 類型 Description
environment

object

image

string

mapDockerSocket

boolean

options

string

ports

string[]

volumes

string[]

ContainerResource

名稱 類型 Description
container

Container

PipelineReference

管線的參考。

名稱 類型 Description
folder

string

管線資料夾

id

integer

管線識別碼

name

string

管線名稱

revision

integer

修訂編號

url

string

PipelineResource

名稱 類型 Description
pipeline

PipelineReference

管線的參考。

version

string

表示 REST 參考連結集合的類別。

名稱 類型 Description
links

object

連結的唯讀檢視。 因為參考連結是唯讀的,所以我們只想要將它們公開為唯讀。

Repository

名稱 類型 Description
type

RepositoryType

RepositoryResource

名稱 類型 Description
refName

string

repository

Repository

version

string

RepositoryType

名稱 類型 Description
azureReposGit

string

azureReposGitHyphenated

string

gitHub

string

gitHubEnterprise

string

unknown

string

Run

名稱 類型 Description
_links

ReferenceLinks

表示 REST 參考連結集合的類別。

createdDate

string

finalYaml

string

finishedDate

string

id

integer

name

string

pipeline

PipelineReference

管線的參考。

resources

RunResources

result

RunResult

state

RunState

templateParameters

object

url

string

variables

<string,  Variable>

RunResources

名稱 類型 Description
containers

<string,  ContainerResource>

pipelines

<string,  PipelineResource>

repositories

<string,  RepositoryResource>

RunResult

名稱 類型 Description
canceled

string

failed

string

succeeded

string

unknown

string

RunState

名稱 類型 Description
canceling

string

completed

string

inProgress

string

unknown

string

Variable

名稱 類型 Description
isSecret

boolean

value

string