Runs - Get
取得特定管線的執行。
GET https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs/{runId}?api-version=7.1URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Azure DevOps 組織的名稱。 |
|
pipeline
|
path | True |
integer (int32) |
管線標識碼 |
|
project
|
path | True |
string |
項目識別碼或項目名稱 |
|
run
|
path | True |
integer (int32) |
執行標識碼 |
|
api-version
|
query | True |
string |
要使用的 API 版本。 這應該設定為 『7.1』 以使用此版本的 API。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
成功作業 |
安全性
oauth2
類型:
oauth2
Flow:
accessCode
授權 URL:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
權杖 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
範圍
| 名稱 | Description |
|---|---|
| vso.build | 授與存取組建成品的能力，包括建置結果、定義和要求，以及能夠透過服務攔截接收有關建置事件的通知。 |
定義
| 名稱 | Description |
|---|---|
| Container | |
|
Container |
|
|
Pipeline |
管線的參考。 |
|
Pipeline |
|
|
Reference |
表示 REST 參考連結集合的類別。 |
| Repository | |
|
Repository |
|
|
Repository |
|
| Run | |
|
Run |
|
|
Run |
|
|
Run |
|
| Variable |
Container
| 名稱 | 類型 | Description |
|---|---|---|
| environment |
object |
|
| image |
string |
|
| mapDockerSocket |
boolean |
|
| options |
string |
|
| ports |
string[] |
|
| volumes |
string[] |
ContainerResource
| 名稱 | 類型 | Description |
|---|---|---|
| container |
PipelineReference
管線的參考。
| 名稱 | 類型 | Description |
|---|---|---|
| folder |
string |
管線資料夾 |
| id |
integer (int32) |
管線標識碼 |
| name |
string |
管線名稱 |
| revision |
integer (int32) |
修訂編號 |
| url |
string |
PipelineResource
| 名稱 | 類型 | Description |
|---|---|---|
| pipeline |
管線的參考。 |
|
| version |
string |
ReferenceLinks
表示 REST 參考連結集合的類別。
| 名稱 | 類型 | Description |
|---|---|---|
| links |
object |
連結的只讀檢視。 因為參考連結是只讀的，所以我們只想要將其公開為只讀。 |
Repository
| 名稱 | 類型 | Description |
|---|---|---|
| type |
RepositoryResource
| 名稱 | 類型 | Description |
|---|---|---|
| refName |
string |
|
| repository | ||
| version |
string |
RepositoryType
| 值 | Description |
|---|---|
| azureReposGit | |
| azureReposGitHyphenated | |
| gitHub | |
| gitHubEnterprise | |
| unknown |
Run
| 名稱 | 類型 | Description |
|---|---|---|
| _links |
表示 REST 參考連結集合的類別。 |
|
| createdDate |
string (date-time) |
|
| finalYaml |
string |
|
| finishedDate |
string (date-time) |
|
| id |
integer (int32) |
|
| name |
string |
|
| pipeline |
管線的參考。 |
|
| resources | ||
| result | ||
| state | ||
| templateParameters |
object |
|
| url |
string |
|
| variables |
<string, Variable> |
RunResources
| 名稱 | 類型 | Description |
|---|---|---|
| containers |
<string,
Container |
|
| pipelines |
<string,
Pipeline |
|
| repositories |
<string,
Repository |
RunResult
| 值 | Description |
|---|---|
| canceled | |
| failed | |
| succeeded | |
| unknown |
RunState
| 值 | Description |
|---|---|
| canceling | |
| completed | |
| inProgress | |
| unknown |
Variable
| 名稱 | 類型 | Description |
|---|---|---|
| isSecret |
boolean |
|
| value |
string |