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	Идентификатор конвейера.
project	path	True	string	Идентификатор или имя проекта
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 6.1-preview.1.
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	Идентификатор конвейера
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