/// import basem = require('./ClientApiBases'); import VsoBaseInterfaces = require('./interfaces/common/VsoBaseInterfaces'); import FormInputInterfaces = require("./interfaces/common/FormInputInterfaces"); import ReleaseInterfaces = require("./interfaces/ReleaseInterfaces"); export interface IReleaseApi extends basem.ClientApiBase { getAgentArtifactDefinitions(project: string, releaseId: number): Promise; getApprovals(project: string, assignedToFilter?: string, statusFilter?: ReleaseInterfaces.ApprovalStatus, releaseIdsFilter?: number[], typeFilter?: ReleaseInterfaces.ApprovalType, top?: number, continuationToken?: number, queryOrder?: ReleaseInterfaces.ReleaseQueryOrder, includeMyGroupApprovals?: boolean): Promise; getApprovalHistory(project: string, approvalStepId: number): Promise; getApproval(project: string, approvalId: number, includeHistory?: boolean): Promise; updateReleaseApproval(approval: ReleaseInterfaces.ReleaseApproval, project: string, approvalId: number): Promise; updateReleaseApprovals(approvals: ReleaseInterfaces.ReleaseApproval[], project: string): Promise; getTaskAttachmentContent(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, recordId: string, type: string, name: string): Promise; getReleaseTaskAttachmentContent(project: string, releaseId: number, environmentId: number, attemptId: number, planId: string, timelineId: string, recordId: string, type: string, name: string): Promise; getTaskAttachments(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, type: string): Promise; getReleaseTaskAttachments(project: string, releaseId: number, environmentId: number, attemptId: number, planId: string, type: string): Promise; getAutoTriggerIssues(artifactType: string, sourceId: string, artifactVersionId: string, project?: string): Promise; getDeploymentBadge(projectId: string, releaseDefinitionId: number, environmentId: number, branchName?: string): Promise; getReleaseChanges(project: string, releaseId: number, baseReleaseId?: number, top?: number, artifactAlias?: string): Promise; getDefinitionEnvironments(project: string, taskGroupId?: string, propertyFilters?: string[]): Promise; createReleaseDefinition(releaseDefinition: ReleaseInterfaces.ReleaseDefinition, project: string): Promise; deleteReleaseDefinition(project: string, definitionId: number, comment?: string, forceDelete?: boolean): Promise; getReleaseDefinition(project: string, definitionId: number, propertyFilters?: string[]): Promise; getReleaseDefinitionRevision(project: string, definitionId: number, revision: number): Promise; getReleaseDefinitions(project: string, searchText?: string, expand?: ReleaseInterfaces.ReleaseDefinitionExpands, artifactType?: string, artifactSourceId?: string, top?: number, continuationToken?: string, queryOrder?: ReleaseInterfaces.ReleaseDefinitionQueryOrder, path?: string, isExactNameMatch?: boolean, tagFilter?: string[], propertyFilters?: string[], definitionIdFilter?: string[], isDeleted?: boolean, searchTextContainsFolderName?: boolean): Promise; undeleteReleaseDefinition(releaseDefinitionUndeleteParameter: ReleaseInterfaces.ReleaseDefinitionUndeleteParameter, project: string, definitionId: number): Promise; updateReleaseDefinition(releaseDefinition: ReleaseInterfaces.ReleaseDefinition, project: string): Promise; getDeployments(project: string, definitionId?: number, definitionEnvironmentId?: number, createdBy?: string, minModifiedTime?: Date, maxModifiedTime?: Date, deploymentStatus?: ReleaseInterfaces.DeploymentStatus, operationStatus?: ReleaseInterfaces.DeploymentOperationStatus, latestAttemptsOnly?: boolean, queryOrder?: ReleaseInterfaces.ReleaseQueryOrder, top?: number, continuationToken?: number, createdFor?: string, minStartedTime?: Date, maxStartedTime?: Date, sourceBranch?: string): Promise; getDeploymentsForMultipleEnvironments(queryParameters: ReleaseInterfaces.DeploymentQueryParameters, project: string): Promise; getReleaseEnvironment(project: string, releaseId: number, environmentId: number): Promise; updateReleaseEnvironment(environmentUpdateData: ReleaseInterfaces.ReleaseEnvironmentUpdateMetadata, project: string, releaseId: number, environmentId: number): Promise; createDefinitionEnvironmentTemplate(template: ReleaseInterfaces.ReleaseDefinitionEnvironmentTemplate, project: string): Promise; deleteDefinitionEnvironmentTemplate(project: string, templateId: string): Promise; getDefinitionEnvironmentTemplate(project: string, templateId: string): Promise; listDefinitionEnvironmentTemplates(project: string, isDeleted?: boolean): Promise; undeleteReleaseDefinitionEnvironmentTemplate(project: string, templateId: string): Promise; createFavorites(favoriteItems: ReleaseInterfaces.FavoriteItem[], project: string, scope: string, identityId?: string): Promise; deleteFavorites(project: string, scope: string, identityId?: string, favoriteItemIds?: string): Promise; getFavorites(project: string, scope: string, identityId?: string): Promise; getFlightAssignments(flightName?: string): Promise; createFolder(folder: ReleaseInterfaces.Folder, project: string, path?: string): Promise; deleteFolder(project: string, path: string): Promise; getFolders(project: string, path?: string, queryOrder?: ReleaseInterfaces.FolderPathQueryOrder): Promise; updateFolder(folder: ReleaseInterfaces.Folder, project: string, path: string): Promise; updateGates(gateUpdateMetadata: ReleaseInterfaces.GateUpdateMetadata, project: string, gateStepId: number): Promise; getReleaseHistory(project: string, releaseId: number): Promise; getInputValues(query: FormInputInterfaces.InputValuesQuery, project: string): Promise; getIssues(project: string, buildId: number, sourceId?: string): Promise; getGateLog(project: string, releaseId: number, environmentId: number, gateId: number, taskId: number): Promise; getLogs(project: string, releaseId: number): Promise; getLog(project: string, releaseId: number, environmentId: number, taskId: number, attemptId?: number): Promise; getTaskLog2(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, taskId: number, startLine?: number, endLine?: number): Promise; getTaskLog(project: string, releaseId: number, environmentId: number, releaseDeployPhaseId: number, taskId: number, startLine?: number, endLine?: number): Promise; getManualIntervention(project: string, releaseId: number, manualInterventionId: number): Promise; getManualInterventions(project: string, releaseId: number): Promise; updateManualIntervention(manualInterventionUpdateMetadata: ReleaseInterfaces.ManualInterventionUpdateMetadata, project: string, releaseId: number, manualInterventionId: number): Promise; getMetrics(project: string, minMetricsTime?: Date): Promise; getReleaseProjects(artifactType: string, artifactSourceId: string): Promise; getReleases(project?: string, definitionId?: number, definitionEnvironmentId?: number, searchText?: string, createdBy?: string, statusFilter?: ReleaseInterfaces.ReleaseStatus, environmentStatusFilter?: number, minCreatedTime?: Date, maxCreatedTime?: Date, queryOrder?: ReleaseInterfaces.ReleaseQueryOrder, top?: number, continuationToken?: number, expand?: ReleaseInterfaces.ReleaseExpands, artifactTypeId?: string, sourceId?: string, artifactVersionId?: string, sourceBranchFilter?: string, isDeleted?: boolean, tagFilter?: string[], propertyFilters?: string[], releaseIdFilter?: number[], path?: string): Promise; createRelease(releaseStartMetadata: ReleaseInterfaces.ReleaseStartMetadata, project: string): Promise; deleteRelease(project: string, releaseId: number, comment?: string): Promise; getRelease(project: string, releaseId: number, approvalFilters?: ReleaseInterfaces.ApprovalFilters, propertyFilters?: string[], expand?: ReleaseInterfaces.SingleReleaseExpands, topGateRecords?: number): Promise; getReleaseDefinitionSummary(project: string, definitionId: number, releaseCount: number, includeArtifact?: boolean, definitionEnvironmentIdsFilter?: number[]): Promise; getReleaseRevision(project: string, releaseId: number, definitionSnapshotRevision: number): Promise; undeleteRelease(project: string, releaseId: number, comment: string): Promise; updateRelease(release: ReleaseInterfaces.Release, project: string, releaseId: number): Promise; updateReleaseResource(releaseUpdateMetadata: ReleaseInterfaces.ReleaseUpdateMetadata, project: string, releaseId: number): Promise; getReleaseSettings(project: string): Promise; updateReleaseSettings(releaseSettings: ReleaseInterfaces.ReleaseSettings, project: string): Promise; getDefinitionRevision(project: string, definitionId: number, revision: number): Promise; getReleaseDefinitionHistory(project: string, definitionId: number): Promise; getSummaryMailSections(project: string, releaseId: number): Promise; sendSummaryMail(mailMessage: ReleaseInterfaces.MailMessage, project: string, releaseId: number): Promise; getSourceBranches(project: string, definitionId: number): Promise; addDefinitionTag(project: string, releaseDefinitionId: number, tag: string): Promise; addDefinitionTags(tags: string[], project: string, releaseDefinitionId: number): Promise; deleteDefinitionTag(project: string, releaseDefinitionId: number, tag: string): Promise; getDefinitionTags(project: string, releaseDefinitionId: number): Promise; addReleaseTag(project: string, releaseId: number, tag: string): Promise; addReleaseTags(tags: string[], project: string, releaseId: number): Promise; deleteReleaseTag(project: string, releaseId: number, tag: string): Promise; getReleaseTags(project: string, releaseId: number): Promise; getTags(project: string): Promise; getTasksForTaskGroup(project: string, releaseId: number, environmentId: number, releaseDeployPhaseId: number): Promise; getTasks2(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string): Promise; getTasks(project: string, releaseId: number, environmentId: number, attemptId?: number): Promise; getArtifactTypeDefinitions(project: string): Promise; getArtifactVersions(project: string, releaseDefinitionId: number): Promise; getArtifactVersionsForSources(artifacts: ReleaseInterfaces.Artifact[], project: string): Promise; getReleaseWorkItemsRefs(project: string, releaseId: number, baseReleaseId?: number, top?: number, artifactAlias?: string): Promise; } export declare class ReleaseApi extends basem.ClientApiBase implements IReleaseApi { constructor(baseUrl: string, handlers: VsoBaseInterfaces.IRequestHandler[], options?: VsoBaseInterfaces.IRequestOptions); static readonly RESOURCE_AREA_ID = "efc2f575-36ef-48e9-b672-0c6fb4a48ac5"; /** * Returns the artifact details that automation agent requires * * @param {string} project - Project ID or project name * @param {number} releaseId */ getAgentArtifactDefinitions(project: string, releaseId: number): Promise; /** * Get a list of approvals * * @param {string} project - Project ID or project name * @param {string} assignedToFilter - Approvals assigned to this user. * @param {ReleaseInterfaces.ApprovalStatus} statusFilter - Approvals with this status. Default is 'pending'. * @param {number[]} releaseIdsFilter - Approvals for release id(s) mentioned in the filter. Multiple releases can be mentioned by separating them with ',' e.g. releaseIdsFilter=1,2,3,4. * @param {ReleaseInterfaces.ApprovalType} typeFilter - Approval with this type. * @param {number} top - Number of approvals to get. Default is 50. * @param {number} continuationToken - Gets the approvals after the continuation token provided. * @param {ReleaseInterfaces.ReleaseQueryOrder} queryOrder - Gets the results in the defined order of created approvals. Default is 'descending'. * @param {boolean} includeMyGroupApprovals - 'true' to include my group approvals. Default is 'false'. */ getApprovals(project: string, assignedToFilter?: string, statusFilter?: ReleaseInterfaces.ApprovalStatus, releaseIdsFilter?: number[], typeFilter?: ReleaseInterfaces.ApprovalType, top?: number, continuationToken?: number, queryOrder?: ReleaseInterfaces.ReleaseQueryOrder, includeMyGroupApprovals?: boolean): Promise; /** * Get approval history. * * @param {string} project - Project ID or project name * @param {number} approvalStepId - Id of the approval. */ getApprovalHistory(project: string, approvalStepId: number): Promise; /** * Get an approval. * * @param {string} project - Project ID or project name * @param {number} approvalId - Id of the approval. * @param {boolean} includeHistory - 'true' to include history of the approval. Default is 'false'. */ getApproval(project: string, approvalId: number, includeHistory?: boolean): Promise; /** * Update status of an approval * * @param {ReleaseInterfaces.ReleaseApproval} approval - ReleaseApproval object having status, approver and comments. * @param {string} project - Project ID or project name * @param {number} approvalId - Id of the approval. */ updateReleaseApproval(approval: ReleaseInterfaces.ReleaseApproval, project: string, approvalId: number): Promise; /** * @param {ReleaseInterfaces.ReleaseApproval[]} approvals * @param {string} project - Project ID or project name */ updateReleaseApprovals(approvals: ReleaseInterfaces.ReleaseApproval[], project: string): Promise; /** * Get a task attachment. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} environmentId - Id of the release environment. * @param {number} attemptId - Attempt number of deployment. * @param {string} timelineId - Timeline Id of the task. * @param {string} recordId - Record Id of attachment. * @param {string} type - Type of the attachment. * @param {string} name - Name of the attachment. */ getTaskAttachmentContent(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, recordId: string, type: string, name: string): Promise; /** * Get a release task attachment. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} environmentId - Id of the release environment. * @param {number} attemptId - Attempt number of deployment. * @param {string} planId - Plan Id of the deploy phase. * @param {string} timelineId - Timeline Id of the task. * @param {string} recordId - Record Id of attachment. * @param {string} type - Type of the attachment. * @param {string} name - Name of the attachment. */ getReleaseTaskAttachmentContent(project: string, releaseId: number, environmentId: number, attemptId: number, planId: string, timelineId: string, recordId: string, type: string, name: string): Promise; /** * Get the task attachments. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} environmentId - Id of the release environment. * @param {number} attemptId - Attempt number of deployment. * @param {string} timelineId - Timeline Id of the task. * @param {string} type - Type of the attachment. */ getTaskAttachments(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, type: string): Promise; /** * Get the release task attachments. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} environmentId - Id of the release environment. * @param {number} attemptId - Attempt number of deployment. * @param {string} planId - Plan Id of the deploy phase. * @param {string} type - Type of the attachment. */ getReleaseTaskAttachments(project: string, releaseId: number, environmentId: number, attemptId: number, planId: string, type: string): Promise; /** * @param {string} artifactType * @param {string} sourceId * @param {string} artifactVersionId * @param {string} project - Project ID or project name */ getAutoTriggerIssues(artifactType: string, sourceId: string, artifactVersionId: string, project?: string): Promise; /** * Gets a badge that indicates the status of the most recent deployment for an environment. * * @param {string} projectId - The ID of the Project. * @param {number} releaseDefinitionId - The ID of the Release Definition. * @param {number} environmentId - The ID of the Environment. * @param {string} branchName - The name of the branch. */ getDeploymentBadge(projectId: string, releaseDefinitionId: number, environmentId: number, branchName?: string): Promise; /** * @param {string} project - Project ID or project name * @param {number} releaseId * @param {number} baseReleaseId * @param {number} top * @param {string} artifactAlias */ getReleaseChanges(project: string, releaseId: number, baseReleaseId?: number, top?: number, artifactAlias?: string): Promise; /** * @param {string} project - Project ID or project name * @param {string} taskGroupId * @param {string[]} propertyFilters */ getDefinitionEnvironments(project: string, taskGroupId?: string, propertyFilters?: string[]): Promise; /** * Create a release definition * * @param {ReleaseInterfaces.ReleaseDefinition} releaseDefinition - release definition object to create. * @param {string} project - Project ID or project name */ createReleaseDefinition(releaseDefinition: ReleaseInterfaces.ReleaseDefinition, project: string): Promise; /** * Delete a release definition. * * @param {string} project - Project ID or project name * @param {number} definitionId - Id of the release definition. * @param {string} comment - Comment for deleting a release definition. * @param {boolean} forceDelete - 'true' to automatically cancel any in-progress release deployments and proceed with release definition deletion . Default is 'false'. */ deleteReleaseDefinition(project: string, definitionId: number, comment?: string, forceDelete?: boolean): Promise; /** * Get a release definition. * * @param {string} project - Project ID or project name * @param {number} definitionId - Id of the release definition. * @param {string[]} propertyFilters - A comma-delimited list of extended properties to be retrieved. If set, the returned Release Definition will contain values for the specified property Ids (if they exist). If not set, properties will not be included. */ getReleaseDefinition(project: string, definitionId: number, propertyFilters?: string[]): Promise; /** * Get release definition of a given revision. * * @param {string} project - Project ID or project name * @param {number} definitionId - Id of the release definition. * @param {number} revision - Revision number of the release definition. */ getReleaseDefinitionRevision(project: string, definitionId: number, revision: number): Promise; /** * Get a list of release definitions. * * @param {string} project - Project ID or project name * @param {string} searchText - Get release definitions with names containing searchText. * @param {ReleaseInterfaces.ReleaseDefinitionExpands} expand - The properties that should be expanded in the list of Release definitions. * @param {string} artifactType - Release definitions with given artifactType will be returned. Values can be Build, Jenkins, GitHub, Nuget, Team Build (external), ExternalTFSBuild, Git, TFVC, ExternalTfsXamlBuild. * @param {string} artifactSourceId - Release definitions with given artifactSourceId will be returned. e.g. For build it would be {projectGuid}:{BuildDefinitionId}, for Jenkins it would be {JenkinsConnectionId}:{JenkinsDefinitionId}, for TfsOnPrem it would be {TfsOnPremConnectionId}:{ProjectName}:{TfsOnPremDefinitionId}. For third-party artifacts e.g. TeamCity, BitBucket you may refer 'uniqueSourceIdentifier' inside vss-extension.json at https://github.com/Microsoft/vsts-rm-extensions/blob/master/Extensions. * @param {number} top - Number of release definitions to get. * @param {string} continuationToken - Gets the release definitions after the continuation token provided. * @param {ReleaseInterfaces.ReleaseDefinitionQueryOrder} queryOrder - Gets the results in the defined order. Default is 'IdAscending'. * @param {string} path - Gets the release definitions under the specified path. * @param {boolean} isExactNameMatch - 'true'to gets the release definitions with exact match as specified in searchText. Default is 'false'. * @param {string[]} tagFilter - A comma-delimited list of tags. Only release definitions with these tags will be returned. * @param {string[]} propertyFilters - A comma-delimited list of extended properties to be retrieved. If set, the returned Release Definitions will contain values for the specified property Ids (if they exist). If not set, properties will not be included. Note that this will not filter out any Release Definition from results irrespective of whether it has property set or not. * @param {string[]} definitionIdFilter - A comma-delimited list of release definitions to retrieve. * @param {boolean} isDeleted - 'true' to get release definitions that has been deleted. Default is 'false' * @param {boolean} searchTextContainsFolderName - 'true' to get the release definitions under the folder with name as specified in searchText. Default is 'false'. */ getReleaseDefinitions(project: string, searchText?: string, expand?: ReleaseInterfaces.ReleaseDefinitionExpands, artifactType?: string, artifactSourceId?: string, top?: number, continuationToken?: string, queryOrder?: ReleaseInterfaces.ReleaseDefinitionQueryOrder, path?: string, isExactNameMatch?: boolean, tagFilter?: string[], propertyFilters?: string[], definitionIdFilter?: string[], isDeleted?: boolean, searchTextContainsFolderName?: boolean): Promise; /** * Undelete a release definition. * * @param {ReleaseInterfaces.ReleaseDefinitionUndeleteParameter} releaseDefinitionUndeleteParameter - Object for undelete release definition. * @param {string} project - Project ID or project name * @param {number} definitionId - Id of the release definition to be undeleted */ undeleteReleaseDefinition(releaseDefinitionUndeleteParameter: ReleaseInterfaces.ReleaseDefinitionUndeleteParameter, project: string, definitionId: number): Promise; /** * Update a release definition. * * @param {ReleaseInterfaces.ReleaseDefinition} releaseDefinition - Release definition object to update. * @param {string} project - Project ID or project name */ updateReleaseDefinition(releaseDefinition: ReleaseInterfaces.ReleaseDefinition, project: string): Promise; /** * @param {string} project - Project ID or project name * @param {number} definitionId * @param {number} definitionEnvironmentId * @param {string} createdBy * @param {Date} minModifiedTime * @param {Date} maxModifiedTime * @param {ReleaseInterfaces.DeploymentStatus} deploymentStatus * @param {ReleaseInterfaces.DeploymentOperationStatus} operationStatus * @param {boolean} latestAttemptsOnly * @param {ReleaseInterfaces.ReleaseQueryOrder} queryOrder * @param {number} top * @param {number} continuationToken * @param {string} createdFor * @param {Date} minStartedTime * @param {Date} maxStartedTime * @param {string} sourceBranch */ getDeployments(project: string, definitionId?: number, definitionEnvironmentId?: number, createdBy?: string, minModifiedTime?: Date, maxModifiedTime?: Date, deploymentStatus?: ReleaseInterfaces.DeploymentStatus, operationStatus?: ReleaseInterfaces.DeploymentOperationStatus, latestAttemptsOnly?: boolean, queryOrder?: ReleaseInterfaces.ReleaseQueryOrder, top?: number, continuationToken?: number, createdFor?: string, minStartedTime?: Date, maxStartedTime?: Date, sourceBranch?: string): Promise; /** * @param {ReleaseInterfaces.DeploymentQueryParameters} queryParameters * @param {string} project - Project ID or project name */ getDeploymentsForMultipleEnvironments(queryParameters: ReleaseInterfaces.DeploymentQueryParameters, project: string): Promise; /** * Get a release environment. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} environmentId - Id of the release environment. */ getReleaseEnvironment(project: string, releaseId: number, environmentId: number): Promise; /** * Update the status of a release environment * * @param {ReleaseInterfaces.ReleaseEnvironmentUpdateMetadata} environmentUpdateData - Environment update meta data. * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} environmentId - Id of release environment. */ updateReleaseEnvironment(environmentUpdateData: ReleaseInterfaces.ReleaseEnvironmentUpdateMetadata, project: string, releaseId: number, environmentId: number): Promise; /** * Creates a definition environment template * * @param {ReleaseInterfaces.ReleaseDefinitionEnvironmentTemplate} template - Definition environment template to create * @param {string} project - Project ID or project name */ createDefinitionEnvironmentTemplate(template: ReleaseInterfaces.ReleaseDefinitionEnvironmentTemplate, project: string): Promise; /** * Delete a definition environment template * * @param {string} project - Project ID or project name * @param {string} templateId - Id of the definition environment template */ deleteDefinitionEnvironmentTemplate(project: string, templateId: string): Promise; /** * Gets a definition environment template * * @param {string} project - Project ID or project name * @param {string} templateId - Id of the definition environment template */ getDefinitionEnvironmentTemplate(project: string, templateId: string): Promise; /** * Gets a list of definition environment templates * * @param {string} project - Project ID or project name * @param {boolean} isDeleted - 'true' to get definition environment templates that have been deleted. Default is 'false' */ listDefinitionEnvironmentTemplates(project: string, isDeleted?: boolean): Promise; /** * Undelete a release definition environment template. * * @param {string} project - Project ID or project name * @param {string} templateId - Id of the definition environment template to be undeleted */ undeleteReleaseDefinitionEnvironmentTemplate(project: string, templateId: string): Promise; /** * @param {ReleaseInterfaces.FavoriteItem[]} favoriteItems * @param {string} project - Project ID or project name * @param {string} scope * @param {string} identityId */ createFavorites(favoriteItems: ReleaseInterfaces.FavoriteItem[], project: string, scope: string, identityId?: string): Promise; /** * @param {string} project - Project ID or project name * @param {string} scope * @param {string} identityId * @param {string} favoriteItemIds */ deleteFavorites(project: string, scope: string, identityId?: string, favoriteItemIds?: string): Promise; /** * @param {string} project - Project ID or project name * @param {string} scope * @param {string} identityId */ getFavorites(project: string, scope: string, identityId?: string): Promise; /** * @param {string} flightName */ getFlightAssignments(flightName?: string): Promise; /** * Creates a new folder. * * @param {ReleaseInterfaces.Folder} folder - folder. * @param {string} project - Project ID or project name * @param {string} path - Path of the folder. */ createFolder(folder: ReleaseInterfaces.Folder, project: string, path?: string): Promise; /** * Deletes a definition folder for given folder name and path and all it's existing definitions. * * @param {string} project - Project ID or project name * @param {string} path - Path of the folder to delete. */ deleteFolder(project: string, path: string): Promise; /** * Gets folders. * * @param {string} project - Project ID or project name * @param {string} path - Path of the folder. * @param {ReleaseInterfaces.FolderPathQueryOrder} queryOrder - Gets the results in the defined order. Default is 'None'. */ getFolders(project: string, path?: string, queryOrder?: ReleaseInterfaces.FolderPathQueryOrder): Promise; /** * Updates an existing folder at given existing path. * * @param {ReleaseInterfaces.Folder} folder - folder. * @param {string} project - Project ID or project name * @param {string} path - Path of the folder to update. */ updateFolder(folder: ReleaseInterfaces.Folder, project: string, path: string): Promise; /** * Updates the gate for a deployment. * * @param {ReleaseInterfaces.GateUpdateMetadata} gateUpdateMetadata - Metadata to patch the Release Gates. * @param {string} project - Project ID or project name * @param {number} gateStepId - Gate step Id. */ updateGates(gateUpdateMetadata: ReleaseInterfaces.GateUpdateMetadata, project: string, gateStepId: number): Promise; /** * @param {string} project - Project ID or project name * @param {number} releaseId */ getReleaseHistory(project: string, releaseId: number): Promise; /** * @param {FormInputInterfaces.InputValuesQuery} query * @param {string} project - Project ID or project name */ getInputValues(query: FormInputInterfaces.InputValuesQuery, project: string): Promise; /** * @param {string} project - Project ID or project name * @param {number} buildId * @param {string} sourceId */ getIssues(project: string, buildId: number, sourceId?: string): Promise; /** * Gets gate logs * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} environmentId - Id of release environment. * @param {number} gateId - Id of the gate. * @param {number} taskId - ReleaseTask Id for the log. */ getGateLog(project: string, releaseId: number, environmentId: number, gateId: number, taskId: number): Promise; /** * Get logs for a release Id. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. */ getLogs(project: string, releaseId: number): Promise; /** * Gets logs * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} environmentId - Id of release environment. * @param {number} taskId - ReleaseTask Id for the log. * @param {number} attemptId - Id of the attempt. */ getLog(project: string, releaseId: number, environmentId: number, taskId: number, attemptId?: number): Promise; /** * Gets the task log of a release as a plain text file. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} environmentId - Id of release environment. * @param {number} attemptId * @param {string} timelineId * @param {number} taskId - ReleaseTask Id for the log. * @param {number} startLine - Starting line number for logs * @param {number} endLine - Ending line number for logs */ getTaskLog2(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, taskId: number, startLine?: number, endLine?: number): Promise; /** * Gets the task log of a release as a plain text file. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} environmentId - Id of release environment. * @param {number} releaseDeployPhaseId - Release deploy phase Id. * @param {number} taskId - ReleaseTask Id for the log. * @param {number} startLine - Starting line number for logs * @param {number} endLine - Ending line number for logs */ getTaskLog(project: string, releaseId: number, environmentId: number, releaseDeployPhaseId: number, taskId: number, startLine?: number, endLine?: number): Promise; /** * Get manual intervention for a given release and manual intervention id. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} manualInterventionId - Id of the manual intervention. */ getManualIntervention(project: string, releaseId: number, manualInterventionId: number): Promise; /** * List all manual interventions for a given release. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. */ getManualInterventions(project: string, releaseId: number): Promise; /** * Update manual intervention. * * @param {ReleaseInterfaces.ManualInterventionUpdateMetadata} manualInterventionUpdateMetadata - Meta data to update manual intervention. * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} manualInterventionId - Id of the manual intervention. */ updateManualIntervention(manualInterventionUpdateMetadata: ReleaseInterfaces.ManualInterventionUpdateMetadata, project: string, releaseId: number, manualInterventionId: number): Promise; /** * @param {string} project - Project ID or project name * @param {Date} minMetricsTime */ getMetrics(project: string, minMetricsTime?: Date): Promise; /** * @param {string} artifactType * @param {string} artifactSourceId */ getReleaseProjects(artifactType: string, artifactSourceId: string): Promise; /** * Get a list of releases * * @param {string} project - Project ID or project name * @param {number} definitionId - Releases from this release definition Id. * @param {number} definitionEnvironmentId * @param {string} searchText - Releases with names containing searchText. * @param {string} createdBy - Releases created by this user. * @param {ReleaseInterfaces.ReleaseStatus} statusFilter - Releases that have this status. * @param {number} environmentStatusFilter * @param {Date} minCreatedTime - Releases that were created after this time. * @param {Date} maxCreatedTime - Releases that were created before this time. * @param {ReleaseInterfaces.ReleaseQueryOrder} queryOrder - Gets the results in the defined order of created date for releases. Default is descending. * @param {number} top - Number of releases to get. Default is 50. * @param {number} continuationToken - Gets the releases after the continuation token provided. * @param {ReleaseInterfaces.ReleaseExpands} expand - The property that should be expanded in the list of releases. * @param {string} artifactTypeId - Releases with given artifactTypeId will be returned. Values can be Build, Jenkins, GitHub, Nuget, Team Build (external), ExternalTFSBuild, Git, TFVC, ExternalTfsXamlBuild. * @param {string} sourceId - Unique identifier of the artifact used. e.g. For build it would be {projectGuid}:{BuildDefinitionId}, for Jenkins it would be {JenkinsConnectionId}:{JenkinsDefinitionId}, for TfsOnPrem it would be {TfsOnPremConnectionId}:{ProjectName}:{TfsOnPremDefinitionId}. For third-party artifacts e.g. TeamCity, BitBucket you may refer 'uniqueSourceIdentifier' inside vss-extension.json https://github.com/Microsoft/vsts-rm-extensions/blob/master/Extensions. * @param {string} artifactVersionId - Releases with given artifactVersionId will be returned. E.g. in case of Build artifactType, it is buildId. * @param {string} sourceBranchFilter - Releases with given sourceBranchFilter will be returned. * @param {boolean} isDeleted - Gets the soft deleted releases, if true. * @param {string[]} tagFilter - A comma-delimited list of tags. Only releases with these tags will be returned. * @param {string[]} propertyFilters - A comma-delimited list of extended properties to be retrieved. If set, the returned Releases will contain values for the specified property Ids (if they exist). If not set, properties will not be included. Note that this will not filter out any Release from results irrespective of whether it has property set or not. * @param {number[]} releaseIdFilter - A comma-delimited list of releases Ids. Only releases with these Ids will be returned. * @param {string} path - Releases under this folder path will be returned */ getReleases(project?: string, definitionId?: number, definitionEnvironmentId?: number, searchText?: string, createdBy?: string, statusFilter?: ReleaseInterfaces.ReleaseStatus, environmentStatusFilter?: number, minCreatedTime?: Date, maxCreatedTime?: Date, queryOrder?: ReleaseInterfaces.ReleaseQueryOrder, top?: number, continuationToken?: number, expand?: ReleaseInterfaces.ReleaseExpands, artifactTypeId?: string, sourceId?: string, artifactVersionId?: string, sourceBranchFilter?: string, isDeleted?: boolean, tagFilter?: string[], propertyFilters?: string[], releaseIdFilter?: number[], path?: string): Promise; /** * Create a release. * * @param {ReleaseInterfaces.ReleaseStartMetadata} releaseStartMetadata - Metadata to create a release. * @param {string} project - Project ID or project name */ createRelease(releaseStartMetadata: ReleaseInterfaces.ReleaseStartMetadata, project: string): Promise; /** * Soft delete a release * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {string} comment - Comment for deleting a release. */ deleteRelease(project: string, releaseId: number, comment?: string): Promise; /** * Get a Release * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {ReleaseInterfaces.ApprovalFilters} approvalFilters - A filter which would allow fetching approval steps selectively based on whether it is automated, or manual. This would also decide whether we should fetch pre and post approval snapshots. Assumes All by default * @param {string[]} propertyFilters - A comma-delimited list of extended properties to be retrieved. If set, the returned Release will contain values for the specified property Ids (if they exist). If not set, properties will not be included. * @param {ReleaseInterfaces.SingleReleaseExpands} expand - A property that should be expanded in the release. * @param {number} topGateRecords - Number of release gate records to get. Default is 5. */ getRelease(project: string, releaseId: number, approvalFilters?: ReleaseInterfaces.ApprovalFilters, propertyFilters?: string[], expand?: ReleaseInterfaces.SingleReleaseExpands, topGateRecords?: number): Promise; /** * Get release summary of a given definition Id. * * @param {string} project - Project ID or project name * @param {number} definitionId - Id of the definition to get release summary. * @param {number} releaseCount - Count of releases to be included in summary. * @param {boolean} includeArtifact - Include artifact details.Default is 'false'. * @param {number[]} definitionEnvironmentIdsFilter */ getReleaseDefinitionSummary(project: string, definitionId: number, releaseCount: number, includeArtifact?: boolean, definitionEnvironmentIdsFilter?: number[]): Promise; /** * Get release for a given revision number. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release. * @param {number} definitionSnapshotRevision - Definition snapshot revision number. */ getReleaseRevision(project: string, releaseId: number, definitionSnapshotRevision: number): Promise; /** * Undelete a soft deleted release. * * @param {string} project - Project ID or project name * @param {number} releaseId - Id of release to be undeleted. * @param {string} comment - Any comment for undeleting. */ undeleteRelease(project: string, releaseId: number, comment: string): Promise; /** * Update a complete release object. * * @param {ReleaseInterfaces.Release} release - Release object for update. * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release to update. */ updateRelease(release: ReleaseInterfaces.Release, project: string, releaseId: number): Promise; /** * Update few properties of a release. * * @param {ReleaseInterfaces.ReleaseUpdateMetadata} releaseUpdateMetadata - Properties of release to update. * @param {string} project - Project ID or project name * @param {number} releaseId - Id of the release to update. */ updateReleaseResource(releaseUpdateMetadata: ReleaseInterfaces.ReleaseUpdateMetadata, project: string, releaseId: number): Promise; /** * Gets the release settings * * @param {string} project - Project ID or project name */ getReleaseSettings(project: string): Promise; /** * Updates the release settings * * @param {ReleaseInterfaces.ReleaseSettings} releaseSettings * @param {string} project - Project ID or project name */ updateReleaseSettings(releaseSettings: ReleaseInterfaces.ReleaseSettings, project: string): Promise; /** * Get release definition for a given definitionId and revision * * @param {string} project - Project ID or project name * @param {number} definitionId - Id of the definition. * @param {number} revision - Id of the revision. */ getDefinitionRevision(project: string, definitionId: number, revision: number): Promise; /** * Get revision history for a release definition * * @param {string} project - Project ID or project name * @param {number} definitionId - Id of the definition. */ getReleaseDefinitionHistory(project: string, definitionId: number): Promise; /** * @param {string} project - Project ID or project name * @param {number} releaseId */ getSummaryMailSections(project: string, releaseId: number): Promise; /** * @param {ReleaseInterfaces.MailMessage} mailMessage * @param {string} project - Project ID or project name * @param {number} releaseId */ sendSummaryMail(mailMessage: ReleaseInterfaces.MailMessage, project: string, releaseId: number): Promise; /** * @param {string} project - Project ID or project name * @param {number} definitionId */ getSourceBranches(project: string, definitionId: number): Promise; /** * Adds a tag to a definition * * @param {string} project - Project ID or project name * @param {number} releaseDefinitionId * @param {string} tag */ addDefinitionTag(project: string, releaseDefinitionId: number, tag: string): Promise; /** * Adds multiple tags to a definition * * @param {string[]} tags * @param {string} project - Project ID or project name * @param {number} releaseDefinitionId */ addDefinitionTags(tags: string[], project: string, releaseDefinitionId: number): Promise; /** * Deletes a tag from a definition * * @param {string} project - Project ID or project name * @param {number} releaseDefinitionId * @param {string} tag */ deleteDefinitionTag(project: string, releaseDefinitionId: number, tag: string): Promise; /** * Gets the tags for a definition * * @param {string} project - Project ID or project name * @param {number} releaseDefinitionId */ getDefinitionTags(project: string, releaseDefinitionId: number): Promise; /** * Adds a tag to a releaseId * * @param {string} project - Project ID or project name * @param {number} releaseId * @param {string} tag */ addReleaseTag(project: string, releaseId: number, tag: string): Promise; /** * Adds tag to a release * * @param {string[]} tags * @param {string} project - Project ID or project name * @param {number} releaseId */ addReleaseTags(tags: string[], project: string, releaseId: number): Promise; /** * Deletes a tag from a release * * @param {string} project - Project ID or project name * @param {number} releaseId * @param {string} tag */ deleteReleaseTag(project: string, releaseId: number, tag: string): Promise; /** * Gets the tags for a release * * @param {string} project - Project ID or project name * @param {number} releaseId */ getReleaseTags(project: string, releaseId: number): Promise; /** * @param {string} project - Project ID or project name */ getTags(project: string): Promise; /** * @param {string} project - Project ID or project name * @param {number} releaseId * @param {number} environmentId * @param {number} releaseDeployPhaseId */ getTasksForTaskGroup(project: string, releaseId: number, environmentId: number, releaseDeployPhaseId: number): Promise; /** * @param {string} project - Project ID or project name * @param {number} releaseId * @param {number} environmentId * @param {number} attemptId * @param {string} timelineId */ getTasks2(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string): Promise; /** * @param {string} project - Project ID or project name * @param {number} releaseId * @param {number} environmentId * @param {number} attemptId */ getTasks(project: string, releaseId: number, environmentId: number, attemptId?: number): Promise; /** * @param {string} project - Project ID or project name */ getArtifactTypeDefinitions(project: string): Promise; /** * @param {string} project - Project ID or project name * @param {number} releaseDefinitionId */ getArtifactVersions(project: string, releaseDefinitionId: number): Promise; /** * @param {ReleaseInterfaces.Artifact[]} artifacts * @param {string} project - Project ID or project name */ getArtifactVersionsForSources(artifacts: ReleaseInterfaces.Artifact[], project: string): Promise; /** * @param {string} project - Project ID or project name * @param {number} releaseId * @param {number} baseReleaseId * @param {number} top * @param {string} artifactAlias */ getReleaseWorkItemsRefs(project: string, releaseId: number, baseReleaseId?: number, top?: number, artifactAlias?: string): Promise; }