ReleaseRestClient class
Базовый класс, который должен использоваться (производный от) для выполнения запросов к REST API VSS
- Расширяет
Конструкторы
| Release |
Свойства
| RESOURCE_AREA_ID |
Методика
Подробнее о конструкторе
ReleaseRestClient(IVssRestClientOptions)
Подробнее
RESOURCE_AREA_ID
static RESOURCE_AREA_ID: string
Стоимость недвижимости
string
Подробнее о методе
addDefinitionTag(string, number, string)
Добавление тега в определение
function addDefinitionTag(project: string, releaseDefinitionId: number, tag: string): Promise<string[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseDefinitionId
-
number
- tag
-
string
Возвращает
Promise<string[]>
addDefinitionTags(string[], string, number)
Добавление нескольких тегов в определение
function addDefinitionTags(tags: string[], project: string, releaseDefinitionId: number): Promise<string[]>
Параметры
- tags
-
string[]
- project
-
string
Идентификатор проекта или имя проекта
- releaseDefinitionId
-
number
Возвращает
Promise<string[]>
addReleaseTag(string, number, string)
Добавление тега в releaseId
function addReleaseTag(project: string, releaseId: number, tag: string): Promise<string[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
- tag
-
string
Возвращает
Promise<string[]>
addReleaseTags(string[], string, number)
Добавление тега в выпуск
function addReleaseTags(tags: string[], project: string, releaseId: number): Promise<string[]>
Параметры
- tags
-
string[]
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Возвращает
Promise<string[]>
createDefinitionEnvironmentTemplate(ReleaseDefinitionEnvironmentTemplate, string)
Создание шаблона среды определения
function createDefinitionEnvironmentTemplate(template: ReleaseDefinitionEnvironmentTemplate, project: string): Promise<ReleaseDefinitionEnvironmentTemplate>
Параметры
- template
- ReleaseDefinitionEnvironmentTemplate
Шаблон среды определения для создания
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<ReleaseDefinitionEnvironmentTemplate>
createFavorites(FavoriteItem[], string, string, string)
function createFavorites(favoriteItems: FavoriteItem[], project: string, scope: string, identityId?: string): Promise<FavoriteItem[]>
Параметры
- favoriteItems
- project
-
string
Идентификатор проекта или имя проекта
- scope
-
string
- identityId
-
string
Возвращает
Promise<FavoriteItem[]>
createFolder(Folder, string, string)
createRelease(ReleaseStartMetadata, string)
Создайте выпуск.
function createRelease(releaseStartMetadata: ReleaseStartMetadata, project: string): Promise<Release>
Параметры
- releaseStartMetadata
- ReleaseStartMetadata
Метаданные для создания выпуска.
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<Release>
createReleaseDefinition(ReleaseDefinition, string)
Создать определение выпуска
function createReleaseDefinition(releaseDefinition: ReleaseDefinition, project: string): Promise<ReleaseDefinition>
Параметры
- releaseDefinition
- ReleaseDefinition
Объект определения выпуска для создания.
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<ReleaseDefinition>
deleteDefinitionEnvironmentTemplate(string, string)
Удаление шаблона среды определения
function deleteDefinitionEnvironmentTemplate(project: string, templateId: string): Promise<void>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- templateId
-
string
Идентификатор шаблона среды определения
Возвращает
Promise<void>
deleteDefinitionTag(string, number, string)
Удаляет тег из определения
function deleteDefinitionTag(project: string, releaseDefinitionId: number, tag: string): Promise<string[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseDefinitionId
-
number
- tag
-
string
Возвращает
Promise<string[]>
deleteFavorites(string, string, string, string)
function deleteFavorites(project: string, scope: string, identityId?: string, favoriteItemIds?: string): Promise<void>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- scope
-
string
- identityId
-
string
- favoriteItemIds
-
string
Возвращает
Promise<void>
deleteFolder(string, string)
Удаляет папку определения для заданного имени и пути к папке, а также все существующие определения.
function deleteFolder(project: string, path: string): Promise<void>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- path
-
string
Путь к папке для удаления.
Возвращает
Promise<void>
deleteRelease(string, number, string)
Обратимое удаление выпуска
function deleteRelease(project: string, releaseId: number, comment?: string): Promise<void>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- comment
-
string
Комментарий для удаления выпуска.
Возвращает
Promise<void>
deleteReleaseDefinition(string, number, string, boolean)
Удаление определения выпуска.
function deleteReleaseDefinition(project: string, definitionId: number, comment?: string, forceDelete?: boolean): Promise<void>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- definitionId
-
number
Идентификатор определения выпуска.
- comment
-
string
Комментарий для удаления определения выпуска.
- forceDelete
-
boolean
Значение true для автоматического отмены всех развертываний в процессе выполнения и удаления определения выпуска. Значение по умолчанию — false.
Возвращает
Promise<void>
deleteReleaseTag(string, number, string)
Удаляет тег из выпуска
function deleteReleaseTag(project: string, releaseId: number, tag: string): Promise<string[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
- tag
-
string
Возвращает
Promise<string[]>
getAgentArtifactDefinitions(string, number)
Возвращает сведения об артефакте, необходимые агенту автоматизации
function getAgentArtifactDefinitions(project: string, releaseId: number): Promise<AgentArtifactDefinition[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Возвращает
Promise<AgentArtifactDefinition[]>
getApproval(string, number, boolean)
Получение утверждения.
function getApproval(project: string, approvalId: number, includeHistory?: boolean): Promise<ReleaseApproval>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- approvalId
-
number
Идентификатор утверждения.
- includeHistory
-
boolean
Значение true для включения журнала утверждения. Значение по умолчанию — false.
Возвращает
Promise<ReleaseApproval>
getApprovalHistory(string, number)
Получение журнала утверждений.
function getApprovalHistory(project: string, approvalStepId: number): Promise<ReleaseApproval>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- approvalStepId
-
number
Идентификатор утверждения.
Возвращает
Promise<ReleaseApproval>
getApprovals(string, string, ApprovalStatus, number[], ApprovalType, number, number, ReleaseQueryOrder, boolean)
Получение списка утверждений
function getApprovals(project: string, assignedToFilter?: string, statusFilter?: ApprovalStatus, releaseIdsFilter?: number[], typeFilter?: ApprovalType, top?: number, continuationToken?: number, queryOrder?: ReleaseQueryOrder, includeMyGroupApprovals?: boolean): Promise<PagedList<ReleaseApproval>>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- assignedToFilter
-
string
Утверждения, назначенные этому пользователю.
- statusFilter
- ApprovalStatus
Утверждения с этим состоянием. Значение по умолчанию — "ожидание".
- releaseIdsFilter
-
number[]
Утверждения для идентификаторов выпуска, упомянутых в фильтре. Несколько выпусков можно упомянуть, разделив их на ", например releaseIdsFilter=1,2,3,4.
- typeFilter
- ApprovalType
Утверждение с этим типом.
- top
-
number
Количество утверждений для получения. Значение по умолчанию — 50.
- continuationToken
-
number
Получает утверждения после предоставления маркера продолжения.
- queryOrder
- ReleaseQueryOrder
Возвращает результаты в определенном порядке созданных утверждений. Значение по умолчанию — "убывание".
- includeMyGroupApprovals
-
boolean
Значение true для включения утверждений группы. Значение по умолчанию — false.
Возвращает
Promise<PagedList<ReleaseApproval>>
getArtifactTypeDefinitions(string)
function getArtifactTypeDefinitions(project: string): Promise<ArtifactTypeDefinition[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<ArtifactTypeDefinition[]>
getArtifactVersions(string, number)
function getArtifactVersions(project: string, releaseDefinitionId: number): Promise<ArtifactVersionQueryResult>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseDefinitionId
-
number
Возвращает
Promise<ArtifactVersionQueryResult>
getArtifactVersionsForSources(Artifact[], string)
function getArtifactVersionsForSources(artifacts: Artifact[], project: string): Promise<ArtifactVersionQueryResult>
Параметры
- artifacts
-
Artifact[]
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<ArtifactVersionQueryResult>
getAutoTriggerIssues(string, string, string, string)
function getAutoTriggerIssues(artifactType: string, sourceId: string, artifactVersionId: string, project?: string): Promise<AutoTriggerIssue[]>
Параметры
- artifactType
-
string
- sourceId
-
string
- artifactVersionId
-
string
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<AutoTriggerIssue[]>
getDefinitionEnvironments(string, string, string[])
function getDefinitionEnvironments(project: string, taskGroupId?: string, propertyFilters?: string[]): Promise<DefinitionEnvironmentReference[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- taskGroupId
-
string
- propertyFilters
-
string[]
Возвращает
Promise<DefinitionEnvironmentReference[]>
getDefinitionEnvironmentTemplate(string, string)
Возвращает шаблон среды определения
function getDefinitionEnvironmentTemplate(project: string, templateId: string): Promise<ReleaseDefinitionEnvironmentTemplate>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- templateId
-
string
Идентификатор шаблона среды определения
Возвращает
Promise<ReleaseDefinitionEnvironmentTemplate>
getDefinitionRevision(string, number, number)
Получение определения выпуска для заданного определения и редакции
function getDefinitionRevision(project: string, definitionId: number, revision: number): Promise<string>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- definitionId
-
number
Идентификатор определения.
- revision
-
number
Идентификатор редакции.
Возвращает
Promise<string>
getDefinitionTags(string, number)
Возвращает теги для определения
function getDefinitionTags(project: string, releaseDefinitionId: number): Promise<string[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseDefinitionId
-
number
Возвращает
Promise<string[]>
getDeploymentBadge(string, number, number, string)
Возвращает значок, указывающий состояние последнего развертывания для среды.
function getDeploymentBadge(projectId: string, releaseDefinitionId: number, environmentId: number, branchName?: string): Promise<string>
Параметры
- projectId
-
string
Идентификатор проекта.
- releaseDefinitionId
-
number
Идентификатор определения выпуска.
- environmentId
-
number
Идентификатор среды.
- branchName
-
string
Имя ветви.
Возвращает
Promise<string>
getDeployments(string, number, number, string, Date, Date, DeploymentStatus, DeploymentOperationStatus, boolean, ReleaseQueryOrder, number, number, string, Date, Date, string)
Получение списка развертываний
function getDeployments(project: string, definitionId?: number, definitionEnvironmentId?: number, createdBy?: string, minModifiedTime?: Date, maxModifiedTime?: Date, deploymentStatus?: DeploymentStatus, operationStatus?: DeploymentOperationStatus, latestAttemptsOnly?: boolean, queryOrder?: ReleaseQueryOrder, top?: number, continuationToken?: number, createdFor?: string, minStartedTime?: Date, maxStartedTime?: Date, sourceBranch?: string): Promise<PagedList<Deployment>>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- definitionId
-
number
Вывод списка развертываний для заданного идентификатора определения.
- definitionEnvironmentId
-
number
Вывод списка развертываний для заданного идентификатора среды определения.
- createdBy
-
string
Выведите список развертываний, для которых развертывания создаются как указанные удостоверения.
- minModifiedTime
-
Date
Вывод списка развертываний с помощью времени >LastModified = minModifiedTime.
- maxModifiedTime
-
Date
Вывод списка развертываний с параметром LastModified time <= maxModifiedTime.
- deploymentStatus
- DeploymentStatus
Вывод списка развертываний с заданным состоянием развертывания. По умолчанию используется значение All.
- operationStatus
- DeploymentOperationStatus
Вывод списка развертываний с заданным состоянием операции. По умолчанию используется значение All.
- latestAttemptsOnly
-
boolean
Значение true для включения развертываний с последней попыткой. Значение по умолчанию — false.
- queryOrder
- ReleaseQueryOrder
Вывод списка развертываний с заданным порядком запроса. Значение по умолчанию — "Убывание".
- top
-
number
Вывод списка развертываний с заданным верхом. Верхняя часть по умолчанию — "50", а максимальная — "100".
- continuationToken
-
number
Вывод списка развертываний с идентификатором >развертывания = continuationToken.
- createdFor
-
string
Выведите список развертываний, для которых развертывания запрашиваются в качестве удостоверения.
- minStartedTime
-
Date
Вывод списка развертываний с помощью времени >StartedOn = minStartedTime.
- maxStartedTime
-
Date
Вывод списка развертываний с помощью времени <StartedOn = maxStartedTime.
- sourceBranch
-
string
Вывод списка развертываний, развернутых из заданного имени ветви.
Возвращает
Promise<PagedList<Deployment>>
getDeploymentsForMultipleEnvironments(DeploymentQueryParameters, string)
function getDeploymentsForMultipleEnvironments(queryParameters: DeploymentQueryParameters, project: string): Promise<Deployment[]>
Параметры
- queryParameters
- DeploymentQueryParameters
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<Deployment[]>
getFavorites(string, string, string)
function getFavorites(project: string, scope: string, identityId?: string): Promise<FavoriteItem[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- scope
-
string
- identityId
-
string
Возвращает
Promise<FavoriteItem[]>
getFolders(string, string, FolderPathQueryOrder)
Возвращает папки.
function getFolders(project: string, path?: string, queryOrder?: FolderPathQueryOrder): Promise<Folder[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- path
-
string
Путь к папке.
- queryOrder
- FolderPathQueryOrder
Возвращает результаты в определенном порядке. Значение по умолчанию — None.
Возвращает
Promise<Folder[]>
getGateLog(string, number, number, number, number)
Возвращает журналы шлюзов
function getGateLog(project: string, releaseId: number, environmentId: number, gateId: number, taskId: number): Promise<string>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- environmentId
-
number
Идентификатор среды выпуска.
- gateId
-
number
Идентификатор ворот.
- taskId
-
number
Идентификатор releaseTask для журнала.
Возвращает
Promise<string>
getInputValues(InputValuesQuery, string)
function getInputValues(query: InputValuesQuery, project: string): Promise<InputValuesQuery>
Параметры
- query
- InputValuesQuery
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<InputValuesQuery>
getIssues(string, number, string)
function getIssues(project: string, buildId: number, sourceId?: string): Promise<AutoTriggerIssue[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- buildId
-
number
- sourceId
-
string
Возвращает
Promise<AutoTriggerIssue[]>
getLog(string, number, number, number, number)
Возвращает журналы
function getLog(project: string, releaseId: number, environmentId: number, taskId: number, attemptId?: number): Promise<string>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- environmentId
-
number
Идентификатор среды выпуска.
- taskId
-
number
Идентификатор releaseTask для журнала.
- attemptId
-
number
Идентификатор попытки.
Возвращает
Promise<string>
getLogs(string, number)
Получение журналов для идентификатора выпуска.
function getLogs(project: string, releaseId: number): Promise<ArrayBuffer>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
Возвращает
Promise<ArrayBuffer>
getManualIntervention(string, number, number)
Получение ручного вмешательства для заданного выпуска и идентификатора вмешательства вручную.
function getManualIntervention(project: string, releaseId: number, manualInterventionId: number): Promise<ManualIntervention>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- manualInterventionId
-
number
Идентификатор вмешательства вручную.
Возвращает
Promise<ManualIntervention>
getManualInterventions(string, number)
Перечислить все вмешательства вручную для данного выпуска.
function getManualInterventions(project: string, releaseId: number): Promise<ManualIntervention[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
Возвращает
Promise<ManualIntervention[]>
getMetrics(string, Date)
function getMetrics(project: string, minMetricsTime?: Date): Promise<Metric[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- minMetricsTime
-
Date
Возвращает
Promise<Metric[]>
getOrgPipelineReleaseSettings()
Возвращает параметры выпуска конвейера организации
function getOrgPipelineReleaseSettings(): Promise<OrgPipelineReleaseSettings>
Возвращает
Promise<OrgPipelineReleaseSettings>
getPipelineReleaseSettings(string)
Возвращает параметры выпуска конвейера
function getPipelineReleaseSettings(project: string): Promise<ProjectPipelineReleaseSettings>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<ProjectPipelineReleaseSettings>
getRelease(string, number, ApprovalFilters, string[], SingleReleaseExpands, number, boolean)
Получение выпуска
function getRelease(project: string, releaseId: number, approvalFilters?: ApprovalFilters, propertyFilters?: string[], expand?: SingleReleaseExpands, topGateRecords?: number, includeDisabledDefinitions?: boolean): Promise<Release>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- approvalFilters
- ApprovalFilters
Фильтр, позволяющий выборочно выполнять шаги утверждения на основе автоматического или ручного выполнения. Это также решит, следует ли получить моментальные снимки предварительного и последующего утверждения. Предполагается, что все по умолчанию
- propertyFilters
-
string[]
Список извлекаемых расширенных свойств с разделителями-запятыми. Если задано, возвращаемый выпуск будет содержать значения для указанных идентификаторов свойств (если они существуют). Если не задано, свойства не будут включены.
- expand
- SingleReleaseExpands
Свойство, которое должно быть развернуто в выпуске.
- topGateRecords
-
number
Количество записей шлюза выпуска для получения. Значение по умолчанию — 5.
- includeDisabledDefinitions
-
boolean
Включение отключенных определений (если задано значение false, возвращает ошибку, значение по умолчанию — true).
Возвращает
Promise<Release>
getReleaseChanges(string, number, number, number, string)
function getReleaseChanges(project: string, releaseId: number, baseReleaseId?: number, top?: number, artifactAlias?: string): Promise<Change[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
- baseReleaseId
-
number
- top
-
number
- artifactAlias
-
string
Возвращает
Promise<Change[]>
getReleaseDefinition(string, number, string[], boolean)
Получение определения выпуска.
function getReleaseDefinition(project: string, definitionId: number, propertyFilters?: string[], includeDisabled?: boolean): Promise<ReleaseDefinition>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- definitionId
-
number
Идентификатор определения выпуска.
- propertyFilters
-
string[]
Список извлекаемых расширенных свойств с разделителями-запятыми. Если задано, возвращаемое определение выпуска будет содержать значения для указанных идентификаторов свойств (если они существуют). Если не задано, свойства не будут включены.
- includeDisabled
-
boolean
Логический флаг для включения отключенных определений.
Возвращает
Promise<ReleaseDefinition>
getReleaseDefinitionHistory(string, number)
Получение журнала редакций для определения выпуска
function getReleaseDefinitionHistory(project: string, definitionId: number): Promise<ReleaseDefinitionRevision[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- definitionId
-
number
Идентификатор определения.
Возвращает
Promise<ReleaseDefinitionRevision[]>
getReleaseDefinitionRevision(string, number, number)
Получение определения выпуска заданной редакции.
function getReleaseDefinitionRevision(project: string, definitionId: number, revision: number): Promise<string>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- definitionId
-
number
Идентификатор определения выпуска.
- revision
-
number
Номер редакции определения выпуска.
Возвращает
Promise<string>
getReleaseDefinitions(string, string, ReleaseDefinitionExpands, string, string, number, string, ReleaseDefinitionQueryOrder, string, boolean, string[], string[], string[], boolean, boolean)
Получение списка определений выпуска.
function getReleaseDefinitions(project: string, searchText?: string, expand?: ReleaseDefinitionExpands, artifactType?: string, artifactSourceId?: string, top?: number, continuationToken?: string, queryOrder?: ReleaseDefinitionQueryOrder, path?: string, isExactNameMatch?: boolean, tagFilter?: string[], propertyFilters?: string[], definitionIdFilter?: string[], isDeleted?: boolean, searchTextContainsFolderName?: boolean): Promise<PagedList<ReleaseDefinition>>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- searchText
-
string
Получение определений выпуска с именами, содержащими searchText.
- expand
- ReleaseDefinitionExpands
Свойства, которые следует развернуть в списке определений выпуска.
- artifactType
-
string
Будут возвращены определения выпуска с заданным артефактомType. Значения могут быть build, Jenkins, GitHub, Nuget, Team Build (external), ExternalTFSBuild, Git, TFVC, ExternalTfsXamlBuild.
- artifactSourceId
-
string
Будут возвращены определения выпуска с заданным артефактомSourceId. Например, для сборки это будет {projectGuid}:{BuildDefinitionId}, для Jenkins это будет {JenkinsConnectionId}:{JenkinsDefinitionId}, для TfsOnPremPrem это будет {TfsOnPremConnectionId}:{ProjectName}:{TfsOnPremDefinitionId}. Для сторонних артефактов, например TeamCity, BitBucket, можно ссылаться на uniqueSourceIdentifier внутри vss-extension.json по https://github.com/Microsoft/vsts-rm-extensions/blob/master/Extensions.
- top
-
number
Количество определений выпуска для получения.
- continuationToken
-
string
Возвращает определения выпуска после предоставления маркера продолжения.
- queryOrder
- ReleaseDefinitionQueryOrder
Возвращает результаты в определенном порядке. Значение по умолчанию — IdAscending.
- path
-
string
Возвращает определения выпуска под указанным путем.
- isExactNameMatch
-
boolean
Значение true для получения определений выпуска с точным совпадением, указанным в searchText. Значение по умолчанию — false.
- tagFilter
-
string[]
Список тегов с разделителями-запятыми. Будут возвращены только определения выпуска с этими тегами.
- propertyFilters
-
string[]
Список извлекаемых расширенных свойств с разделителями-запятыми. Если задано, возвращаемые определения выпуска будут содержать значения для указанных идентификаторов свойств (если они существуют). Если не задано, свойства не будут включены. Обратите внимание, что это не отфильтровывает определение выпуска от результатов независимо от того, имеет ли он набор свойств или нет.
- definitionIdFilter
-
string[]
Список определений выпуска с разделителями-запятыми для получения.
- isDeleted
-
boolean
Значение true для получения определений выпуска, которые были удалены. Значение по умолчанию — false.
- searchTextContainsFolderName
-
boolean
Значение true, чтобы получить определения выпуска в папке с именем, указанным в searchText. Значение по умолчанию — false.
Возвращает
Promise<PagedList<ReleaseDefinition>>
getReleaseDefinitionSummary(string, number, number, boolean, number[])
Получение сводки по выпуску заданного идентификатора определения.
function getReleaseDefinitionSummary(project: string, definitionId: number, releaseCount: number, includeArtifact?: boolean, definitionEnvironmentIdsFilter?: number[]): Promise<ReleaseDefinitionSummary>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- definitionId
-
number
Идентификатор определения для получения сводки о выпуске.
- releaseCount
-
number
Количество выпусков, которые будут включены в сводку.
- includeArtifact
-
boolean
Включите сведения об артефакте. Значение по умолчанию — false.
- definitionEnvironmentIdsFilter
-
number[]
Возвращает
Promise<ReleaseDefinitionSummary>
getReleaseEnvironment(string, number, number, ReleaseEnvironmentExpands)
Получите среду выпуска.
function getReleaseEnvironment(project: string, releaseId: number, environmentId: number, expand?: ReleaseEnvironmentExpands): Promise<ReleaseEnvironment>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- environmentId
-
number
Идентификатор среды выпуска.
- expand
- ReleaseEnvironmentExpands
Свойство, которое должно быть развернуто в среде.
Возвращает
Promise<ReleaseEnvironment>
getReleaseHistory(string, number)
function getReleaseHistory(project: string, releaseId: number): Promise<ReleaseRevision[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Возвращает
Promise<ReleaseRevision[]>
getReleaseProjects(string, string)
function getReleaseProjects(artifactType: string, artifactSourceId: string): Promise<ProjectReference[]>
Параметры
- artifactType
-
string
- artifactSourceId
-
string
Возвращает
Promise<ProjectReference[]>
getReleaseRevision(string, number, number)
Получите выпуск для заданного номера редакции.
function getReleaseRevision(project: string, releaseId: number, definitionSnapshotRevision: number): Promise<string>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- definitionSnapshotRevision
-
number
Номер редакции моментального снимка определения.
Возвращает
Promise<string>
getReleases(string, number, number, string, string, ReleaseStatus, number, Date, Date, ReleaseQueryOrder, number, number, ReleaseExpands, string, string, string, string, boolean, string[], string[], number[], string)
Получение списка выпусков
function getReleases(project?: string, definitionId?: number, definitionEnvironmentId?: number, searchText?: string, createdBy?: string, statusFilter?: ReleaseStatus, environmentStatusFilter?: number, minCreatedTime?: Date, maxCreatedTime?: Date, queryOrder?: ReleaseQueryOrder, top?: number, continuationToken?: number, expand?: ReleaseExpands, artifactTypeId?: string, sourceId?: string, artifactVersionId?: string, sourceBranchFilter?: string, isDeleted?: boolean, tagFilter?: string[], propertyFilters?: string[], releaseIdFilter?: number[], path?: string): Promise<Release[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- definitionId
-
number
Выпуски из этого идентификатора определения выпуска.
- definitionEnvironmentId
-
number
- searchText
-
string
Выпуски с именами, содержащими searchText.
- createdBy
-
string
Выпуски, созданные этим пользователем.
- statusFilter
- ReleaseStatus
Выпуски, имеющие это состояние.
- environmentStatusFilter
-
number
- minCreatedTime
-
Date
Выпуски, созданные после этого времени.
- maxCreatedTime
-
Date
Выпуски, созданные до этого времени.
- queryOrder
- ReleaseQueryOrder
Возвращает результаты в определенном порядке созданной даты для выпусков. По умолчанию убывание.
- top
-
number
Количество выпусков для получения. Значение по умолчанию — 50.
- continuationToken
-
number
Возвращает выпуски после предоставления маркера продолжения.
- expand
- ReleaseExpands
Свойство, которое должно быть развернуто в списке выпусков.
- artifactTypeId
-
string
Будут возвращены выпуски с заданным артефактомTypeId. Значения могут быть build, Jenkins, GitHub, Nuget, Team Build (external), ExternalTFSBuild, Git, TFVC, ExternalTfsXamlBuild.
- sourceId
-
string
Уникальный идентификатор используемого артефакта. Например, для сборки это будет {projectGuid}:{BuildDefinitionId}, для Jenkins это будет {JenkinsConnectionId}:{JenkinsDefinitionId}, для TfsOnPremPrem это будет {TfsOnPremConnectionId}:{ProjectName}:{TfsOnPremDefinitionId}. Для сторонних артефактов, например TeamCity, BitBucket, можно ссылаться на uniqueSourceIdentifier внутри vss-extension.json https://github.com/Microsoft/vsts-rm-extensions/blob/master/Extensions.
- artifactVersionId
-
string
Будут возвращены выпуски с заданным артефактомVersionId. Например, в случае артефакта сборки он является buildId.
- sourceBranchFilter
-
string
Выпуски с заданным источникомBranchFilter будут возвращены (не следует использовать с environmentStatusFilter).
- isDeleted
-
boolean
Возвращает обратимые удаленные выпуски, если значение true.
- tagFilter
-
string[]
Список тегов с разделителями-запятыми. Будут возвращены только выпуски с этими тегами.
- propertyFilters
-
string[]
Список извлекаемых расширенных свойств с разделителями-запятыми. Если задано, возвращаемые выпуски будут содержать значения для указанных идентификаторов свойств (если они существуют). Если не задано, свойства не будут включены. Обратите внимание, что это не отфильтровывает любой выпуск от результатов независимо от того, имеет ли он набор свойств или нет.
- releaseIdFilter
-
number[]
Список идентификаторов выпусков с разделителями-запятыми. Будут возвращены только выпуски с этими идентификаторами.
- path
-
string
Выпуски под этим путем к папке будут возвращены
Возвращает
Promise<Release[]>
getReleaseSettings(string)
Возвращает параметры выпуска
function getReleaseSettings(project: string): Promise<ReleaseSettings>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<ReleaseSettings>
getReleaseTags(string, number)
Возвращает теги для выпуска
function getReleaseTags(project: string, releaseId: number): Promise<string[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Возвращает
Promise<string[]>
getReleaseTaskAttachmentContent(string, number, number, number, string, string, string, string, string)
Получение вложения задачи выпуска.
function getReleaseTaskAttachmentContent(project: string, releaseId: number, environmentId: number, attemptId: number, planId: string, timelineId: string, recordId: string, type: string, name: string): Promise<ArrayBuffer>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- environmentId
-
number
Идентификатор среды выпуска.
- attemptId
-
number
Количество попыток развертывания.
- planId
-
string
Идентификатор плана этапа развертывания.
- timelineId
-
string
Идентификатор временной шкалы задачи.
- recordId
-
string
Идентификатор записи вложения.
- type
-
string
Тип вложения.
- name
-
string
Название вложения.
Возвращает
Promise<ArrayBuffer>
getReleaseTaskAttachments(string, number, number, number, string, string)
Получение вложений задачи выпуска.
function getReleaseTaskAttachments(project: string, releaseId: number, environmentId: number, attemptId: number, planId: string, type: string): Promise<ReleaseTaskAttachment[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- environmentId
-
number
Идентификатор среды выпуска.
- attemptId
-
number
Количество попыток развертывания.
- planId
-
string
Идентификатор плана этапа развертывания.
- type
-
string
Тип вложения.
Возвращает
Promise<ReleaseTaskAttachment[]>
getReleaseWorkItemsRefs(string, number, number, number, string)
function getReleaseWorkItemsRefs(project: string, releaseId: number, baseReleaseId?: number, top?: number, artifactAlias?: string): Promise<ReleaseWorkItemRef[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
- baseReleaseId
-
number
- top
-
number
- artifactAlias
-
string
Возвращает
Promise<ReleaseWorkItemRef[]>
getSourceBranches(string, number)
function getSourceBranches(project: string, definitionId: number): Promise<string[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- definitionId
-
number
Возвращает
Promise<string[]>
getSummaryMailSections(string, number)
function getSummaryMailSections(project: string, releaseId: number): Promise<SummaryMailSection[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Возвращает
Promise<SummaryMailSection[]>
getTags(string)
function getTags(project: string): Promise<string[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<string[]>
getTaskAttachmentContent(string, number, number, number, string, string, string, string)
Получение вложения задачи.
function getTaskAttachmentContent(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, recordId: string, type: string, name: string): Promise<ArrayBuffer>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- environmentId
-
number
Идентификатор среды выпуска.
- attemptId
-
number
Количество попыток развертывания.
- timelineId
-
string
Идентификатор временной шкалы задачи.
- recordId
-
string
Идентификатор записи вложения.
- type
-
string
Тип вложения.
- name
-
string
Название вложения.
Возвращает
Promise<ArrayBuffer>
getTaskAttachments(string, number, number, number, string, string)
Получите вложения задач.
function getTaskAttachments(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, type: string): Promise<ReleaseTaskAttachment[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- environmentId
-
number
Идентификатор среды выпуска.
- attemptId
-
number
Количество попыток развертывания.
- timelineId
-
string
Идентификатор временной шкалы задачи.
- type
-
string
Тип вложения.
Возвращает
Promise<ReleaseTaskAttachment[]>
getTaskLog(string, number, number, number, number, number, number)
Возвращает журнал задач выпуска в виде обычного текстового файла.
function getTaskLog(project: string, releaseId: number, environmentId: number, releaseDeployPhaseId: number, taskId: number, startLine?: number, endLine?: number): Promise<string>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- environmentId
-
number
Идентификатор среды выпуска.
- releaseDeployPhaseId
-
number
Идентификатор этапа развертывания выпуска.
- taskId
-
number
Идентификатор releaseTask для журнала.
- startLine
-
number
Начальный номер строки для журналов
- endLine
-
number
Конечный номер строки для журналов
Возвращает
Promise<string>
getTaskLog2(string, number, number, number, string, number, number, number)
Возвращает журнал задач выпуска в виде обычного текстового файла.
function getTaskLog2(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, taskId: number, startLine?: number, endLine?: number): Promise<string>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- environmentId
-
number
Идентификатор среды выпуска.
- attemptId
-
number
- timelineId
-
string
- taskId
-
number
Идентификатор releaseTask для журнала.
- startLine
-
number
Начальный номер строки для журналов
- endLine
-
number
Конечный номер строки для журналов
Возвращает
Promise<string>
getTasks(string, number, number, number)
function getTasks(project: string, releaseId: number, environmentId: number, attemptId?: number): Promise<ReleaseTask[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
- environmentId
-
number
- attemptId
-
number
Возвращает
Promise<ReleaseTask[]>
getTasks2(string, number, number, number, string)
function getTasks2(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string): Promise<ReleaseTask[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
- environmentId
-
number
- attemptId
-
number
- timelineId
-
string
Возвращает
Promise<ReleaseTask[]>
getTasksForTaskGroup(string, number, number, number)
function getTasksForTaskGroup(project: string, releaseId: number, environmentId: number, releaseDeployPhaseId: number): Promise<ReleaseTask[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
- environmentId
-
number
- releaseDeployPhaseId
-
number
Возвращает
Promise<ReleaseTask[]>
listDefinitionEnvironmentTemplates(string, boolean)
Возвращает список шаблонов среды определения
function listDefinitionEnvironmentTemplates(project: string, isDeleted?: boolean): Promise<ReleaseDefinitionEnvironmentTemplate[]>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- isDeleted
-
boolean
Значение true для получения шаблонов среды определения, которые были удалены. Значение по умолчанию — false.
Возвращает
Promise<ReleaseDefinitionEnvironmentTemplate[]>
sendSummaryMail(MailMessage, string, number)
function sendSummaryMail(mailMessage: MailMessage, project: string, releaseId: number): Promise<void>
Параметры
- mailMessage
- MailMessage
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Возвращает
Promise<void>
undeleteRelease(string, number, string)
Отмена удаления обратимого удаленного выпуска.
function undeleteRelease(project: string, releaseId: number, comment: string): Promise<void>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска, который требуется отменить.
- comment
-
string
Любой комментарий для отмены удаления.
Возвращает
Promise<void>
undeleteReleaseDefinition(ReleaseDefinitionUndeleteParameter, string, number)
Отмена определения выпуска.
function undeleteReleaseDefinition(releaseDefinitionUndeleteParameter: ReleaseDefinitionUndeleteParameter, project: string, definitionId: number): Promise<ReleaseDefinition>
Параметры
- releaseDefinitionUndeleteParameter
- ReleaseDefinitionUndeleteParameter
Объект для определения отмены выпуска.
- project
-
string
Идентификатор проекта или имя проекта
- definitionId
-
number
Идентификатор определения выпуска, который требуется отменить
Возвращает
Promise<ReleaseDefinition>
undeleteReleaseDefinitionEnvironmentTemplate(string, string)
Отмена шаблона среды определения выпуска.
function undeleteReleaseDefinitionEnvironmentTemplate(project: string, templateId: string): Promise<ReleaseDefinitionEnvironmentTemplate>
Параметры
- project
-
string
Идентификатор проекта или имя проекта
- templateId
-
string
Идентификатор шаблона среды определения, который требуется отменить
Возвращает
Promise<ReleaseDefinitionEnvironmentTemplate>
updateFolder(Folder, string, string)
updateGates(GateUpdateMetadata, string, number)
Обновляет шлюз развертывания.
function updateGates(gateUpdateMetadata: GateUpdateMetadata, project: string, gateStepId: number): Promise<ReleaseGates>
Параметры
- gateUpdateMetadata
- GateUpdateMetadata
Метаданные для исправления шлюзов выпуска.
- project
-
string
Идентификатор проекта или имя проекта
- gateStepId
-
number
Идентификатор шага шлюза.
Возвращает
Promise<ReleaseGates>
updateManualIntervention(ManualInterventionUpdateMetadata, string, number, number)
Обновление ручного вмешательства.
function updateManualIntervention(manualInterventionUpdateMetadata: ManualInterventionUpdateMetadata, project: string, releaseId: number, manualInterventionId: number): Promise<ManualIntervention>
Параметры
- manualInterventionUpdateMetadata
- ManualInterventionUpdateMetadata
Метаданные для обновления ручного вмешательства.
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- manualInterventionId
-
number
Идентификатор вмешательства вручную.
Возвращает
Promise<ManualIntervention>
updateOrgPipelineReleaseSettings(OrgPipelineReleaseSettingsUpdateParameters)
Обновляет параметры выпуска конвейера организации
function updateOrgPipelineReleaseSettings(newSettings: OrgPipelineReleaseSettingsUpdateParameters): Promise<OrgPipelineReleaseSettings>
Параметры
- newSettings
- OrgPipelineReleaseSettingsUpdateParameters
Возвращает
Promise<OrgPipelineReleaseSettings>
updatePipelineReleaseSettings(ProjectPipelineReleaseSettingsUpdateParameters, string)
Обновляет параметры выпуска конвейера
function updatePipelineReleaseSettings(newSettings: ProjectPipelineReleaseSettingsUpdateParameters, project: string): Promise<ProjectPipelineReleaseSettings>
Параметры
- newSettings
- ProjectPipelineReleaseSettingsUpdateParameters
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<ProjectPipelineReleaseSettings>
updateRelease(Release, string, number)
Обновите полный объект выпуска.
function updateRelease(release: Release, project: string, releaseId: number): Promise<Release>
Параметры
- release
- Release
Объект выпуска для обновления.
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска для обновления.
Возвращает
Promise<Release>
updateReleaseApproval(ReleaseApproval, string, number)
Обновление состояния утверждения
function updateReleaseApproval(approval: ReleaseApproval, project: string, approvalId: number): Promise<ReleaseApproval>
Параметры
- approval
- ReleaseApproval
Объект ReleaseApproval, имеющий состояние, утверждающий и комментарии.
- project
-
string
Идентификатор проекта или имя проекта
- approvalId
-
number
Идентификатор утверждения.
Возвращает
Promise<ReleaseApproval>
updateReleaseApprovals(ReleaseApproval[], string)
function updateReleaseApprovals(approvals: ReleaseApproval[], project: string): Promise<ReleaseApproval[]>
Параметры
- approvals
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<ReleaseApproval[]>
updateReleaseDefinition(ReleaseDefinition, string, boolean)
Обновление определения выпуска.
function updateReleaseDefinition(releaseDefinition: ReleaseDefinition, project: string, skipTasksValidation?: boolean): Promise<ReleaseDefinition>
Параметры
- releaseDefinition
- ReleaseDefinition
Объект определения выпуска для обновления.
- project
-
string
Идентификатор проекта или имя проекта
- skipTasksValidation
-
boolean
Пропуск логического флага проверки задачи
Возвращает
Promise<ReleaseDefinition>
updateReleaseEnvironment(ReleaseEnvironmentUpdateMetadata, string, number, number)
Обновление состояния среды выпуска
function updateReleaseEnvironment(environmentUpdateData: ReleaseEnvironmentUpdateMetadata, project: string, releaseId: number, environmentId: number): Promise<ReleaseEnvironment>
Параметры
- environmentUpdateData
- ReleaseEnvironmentUpdateMetadata
Метаданные обновления среды.
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска.
- environmentId
-
number
Идентификатор среды выпуска.
Возвращает
Promise<ReleaseEnvironment>
updateReleaseResource(ReleaseUpdateMetadata, string, number)
Обновите несколько свойств выпуска.
function updateReleaseResource(releaseUpdateMetadata: ReleaseUpdateMetadata, project: string, releaseId: number): Promise<Release>
Параметры
- releaseUpdateMetadata
- ReleaseUpdateMetadata
Свойства выпуска для обновления.
- project
-
string
Идентификатор проекта или имя проекта
- releaseId
-
number
Идентификатор выпуска для обновления.
Возвращает
Promise<Release>
updateReleaseSettings(ReleaseSettings, string)
Обновляет параметры выпуска
function updateReleaseSettings(releaseSettings: ReleaseSettings, project: string): Promise<ReleaseSettings>
Параметры
- releaseSettings
- ReleaseSettings
- project
-
string
Идентификатор проекта или имя проекта
Возвращает
Promise<ReleaseSettings>