Runs - Run Pipeline
Führt eine Pipeline aus.
POST https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?api-version=6.1-preview.1
POST https://dev.azure.com/{organization}/{project}/_apis/pipelines/{pipelineId}/runs?pipelineVersion={pipelineVersion}&api-version=6.1-preview.1
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
organization
|
path | True |
string |
Der Name der Azure DevOps-Organisation. |
pipeline
|
path | True |
integer int32 |
Die Pipeline-ID. |
project
|
path | True |
string |
Projekt-ID oder Projektname |
api-version
|
query | True |
string |
Version der zu verwendenden API. Dies sollte auf "6.1-preview.1" festgelegt werden, um diese Version der API zu verwenden. |
pipeline
|
query |
integer int32 |
Die Pipelineversion. |
Anforderungstext
Name | Typ | Beschreibung |
---|---|---|
previewRun |
boolean |
Wenn true, erstellen Sie keine neue Ausführung. Geben Sie stattdessen das endgültige YAML-Dokument zurück, nachdem Sie Vorlagen analysiert haben. |
resources |
Die Ressourcen, die für die Ausführung erforderlich sind. |
|
stagesToSkip |
string[] |
|
templateParameters |
object |
|
variables |
<string, Variable> |
|
yamlOverride |
string |
Wenn Sie die Vorschauausführungsoption verwenden, können Sie optional verschiedene YAML bereitstellen. Dadurch können Sie eine Vorschau des endgültigen YAML-Dokuments anzeigen, ohne eine geänderte Datei zu übernehmen. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erfolgreicher Vorgang |
Sicherheit
accessToken
Persönliches Zugriffstoken. Verwenden Sie einen beliebigen Wert für den Benutzernamen und das Token als Kennwort.
Type:
basic
Definitionen
Name | Beschreibung |
---|---|
Build |
|
Container |
|
Package |
|
Pipeline |
Ein Verweis auf eine Pipeline. |
Pipeline |
|
Reference |
Die Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
Repository | |
Repository |
|
Repository |
|
Repository |
|
Run | |
Run |
Einstellungen, die die Pipelineausführung beeinflussen. |
Run |
|
Run |
|
Run |
|
Run |
|
Variable |
BuildResourceParameters
Name | Typ | Beschreibung |
---|---|---|
version |
string |
ContainerResourceParameters
Name | Typ | Beschreibung |
---|---|---|
version |
string |
PackageResourceParameters
Name | Typ | Beschreibung |
---|---|---|
version |
string |
PipelineReference
Ein Verweis auf eine Pipeline.
Name | Typ | Beschreibung |
---|---|---|
folder |
string |
Pipelineordner |
id |
integer |
Pipeline-ID |
name |
string |
Pipelinename |
revision |
integer |
Revisionsnummer |
url |
string |
PipelineResourceParameters
Name | Typ | Beschreibung |
---|---|---|
version |
string |
ReferenceLinks
Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
Name | Typ | Beschreibung |
---|---|---|
links |
object |
Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen. |
Repository
Name | Typ | Beschreibung |
---|---|---|
type |
RepositoryResource
Name | Typ | Beschreibung |
---|---|---|
refName |
string |
|
repository | ||
version |
string |
RepositoryResourceParameters
Name | Typ | Beschreibung |
---|---|---|
refName |
string |
|
token |
string |
Dies ist das Sicherheitstoken, das beim Herstellen einer Verbindung mit dem Repository verwendet werden soll. |
tokenType |
string |
Optional. Dies ist der Typ des angegebenen Tokens. Wenn nicht angegeben, wird ein Typ von "Bearer" angenommen. Hinweis: Verwenden Sie "Basic" für ein PAT-Token. |
version |
string |
RepositoryType
Name | Typ | Beschreibung |
---|---|---|
azureReposGit |
string |
|
azureReposGitHyphenated |
string |
|
gitHub |
string |
|
gitHubEnterprise |
string |
|
unknown |
string |
Run
Name | Typ | Beschreibung |
---|---|---|
_links |
Die Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
|
createdDate |
string |
|
finalYaml |
string |
|
finishedDate |
string |
|
id |
integer |
|
name |
string |
|
pipeline |
Ein Verweis auf eine Pipeline. |
|
resources | ||
result | ||
state | ||
url |
string |
|
variables |
<string, Variable> |
RunPipelineParameters
Einstellungen, die die Pipelineausführung beeinflussen.
Name | Typ | Beschreibung |
---|---|---|
previewRun |
boolean |
Wenn true, erstellen Sie keine neue Ausführung. Geben Sie stattdessen das endgültige YAML-Dokument zurück, nachdem Sie Vorlagen analysiert haben. |
resources |
Die Ressourcen, die für die Ausführung erforderlich sind. |
|
stagesToSkip |
string[] |
|
templateParameters |
object |
|
variables |
<string, Variable> |
|
yamlOverride |
string |
Wenn Sie die Vorschauausführungsoption verwenden, können Sie optional verschiedene YAML bereitstellen. Dadurch können Sie eine Vorschau des endgültigen YAML-Dokuments anzeigen, ohne eine geänderte Datei zu übernehmen. |
RunResources
Name | Typ | Beschreibung |
---|---|---|
repositories |
<string,
Repository |
RunResourcesParameters
Name | Typ | Beschreibung |
---|---|---|
builds |
<string,
Build |
|
containers |
<string,
Container |
|
packages |
<string,
Package |
|
pipelines |
<string,
Pipeline |
|
repositories |
<string,
Repository |
RunResult
Name | Typ | Beschreibung |
---|---|---|
canceled |
string |
|
failed |
string |
|
succeeded |
string |
|
unknown |
string |
RunState
Name | Typ | Beschreibung |
---|---|---|
canceling |
string |
|
completed |
string |
|
inProgress |
string |
|
unknown |
string |
Variable
Name | Typ | Beschreibung |
---|---|---|
isSecret |
boolean |
|
value |
string |
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für