ReleaseRestClient class
Basisklasse die moet worden gebruikt (afgeleid van) om aanvragen te doen voor VSS REST API's
- Extends
Constructors
Release |
Eigenschappen
RESOURCE_AREA_ID |
Methoden
Constructordetails
ReleaseRestClient(IVssRestClientOptions)
Eigenschapdetails
RESOURCE_AREA_ID
static RESOURCE_AREA_ID: string
Waarde van eigenschap
string
Methodedetails
addDefinitionTag(string, number, string)
Een tag toevoegen aan een definitie
function addDefinitionTag(project: string, releaseDefinitionId: number, tag: string): Promise<string[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseDefinitionId
-
number
- tag
-
string
Retouren
Promise<string[]>
addDefinitionTags(string[], string, number)
Voegt meerdere tags toe aan een definitie
function addDefinitionTags(tags: string[], project: string, releaseDefinitionId: number): Promise<string[]>
Parameters
- tags
-
string[]
- project
-
string
Project-id of projectnaam
- releaseDefinitionId
-
number
Retouren
Promise<string[]>
addReleaseTag(string, number, string)
Voegt een tag toe aan een releaseId
function addReleaseTag(project: string, releaseId: number, tag: string): Promise<string[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
- tag
-
string
Retouren
Promise<string[]>
addReleaseTags(string[], string, number)
Tag toevoegen aan een release
function addReleaseTags(tags: string[], project: string, releaseId: number): Promise<string[]>
Parameters
- tags
-
string[]
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Retouren
Promise<string[]>
createDefinitionEnvironmentTemplate(ReleaseDefinitionEnvironmentTemplate, string)
Hiermee maakt u een definitieomgevingssjabloon
function createDefinitionEnvironmentTemplate(template: ReleaseDefinitionEnvironmentTemplate, project: string): Promise<ReleaseDefinitionEnvironmentTemplate>
Parameters
- template
- ReleaseDefinitionEnvironmentTemplate
Te maken definitieomgevingssjabloon
- project
-
string
Project-id of projectnaam
Retouren
Promise<ReleaseDefinitionEnvironmentTemplate>
createFavorites(FavoriteItem[], string, string, string)
function createFavorites(favoriteItems: FavoriteItem[], project: string, scope: string, identityId?: string): Promise<FavoriteItem[]>
Parameters
- favoriteItems
- project
-
string
Project-id of projectnaam
- scope
-
string
- identityId
-
string
Retouren
Promise<FavoriteItem[]>
createFolder(Folder, string, string)
Maakt een nieuwe map.
function createFolder(folder: Folder, project: string, path?: string): Promise<Folder>
Parameters
- folder
- Folder
bevindt.
- project
-
string
Project-id of projectnaam
- path
-
string
Pad van de map.
Retouren
Promise<Folder>
createRelease(ReleaseStartMetadata, string)
Creatie een release.
function createRelease(releaseStartMetadata: ReleaseStartMetadata, project: string): Promise<Release>
Parameters
- releaseStartMetadata
- ReleaseStartMetadata
Metagegevens voor het maken van een release.
- project
-
string
Project-id of projectnaam
Retouren
Promise<Release>
createReleaseDefinition(ReleaseDefinition, string)
Release-definitie maken
function createReleaseDefinition(releaseDefinition: ReleaseDefinition, project: string): Promise<ReleaseDefinition>
Parameters
- releaseDefinition
- ReleaseDefinition
releasedefinitieobject dat moet worden gemaakt.
- project
-
string
Project-id of projectnaam
Retouren
Promise<ReleaseDefinition>
deleteDefinitionEnvironmentTemplate(string, string)
Een definitieomgevingssjabloon verwijderen
function deleteDefinitionEnvironmentTemplate(project: string, templateId: string): Promise<void>
Parameters
- project
-
string
Project-id of projectnaam
- templateId
-
string
Id van de definitieomgevingssjabloon
Retouren
Promise<void>
deleteDefinitionTag(string, number, string)
Hiermee verwijdert u een tag uit een definitie
function deleteDefinitionTag(project: string, releaseDefinitionId: number, tag: string): Promise<string[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseDefinitionId
-
number
- tag
-
string
Retouren
Promise<string[]>
deleteFavorites(string, string, string, string)
function deleteFavorites(project: string, scope: string, identityId?: string, favoriteItemIds?: string): Promise<void>
Parameters
- project
-
string
Project-id of projectnaam
- scope
-
string
- identityId
-
string
- favoriteItemIds
-
string
Retouren
Promise<void>
deleteFolder(string, string)
Hiermee verwijdert u een definitiemap voor de opgegeven mapnaam en het pad en alle bestaande definities.
function deleteFolder(project: string, path: string): Promise<void>
Parameters
- project
-
string
Project-id of projectnaam
- path
-
string
Pad van de map die u wilt verwijderen.
Retouren
Promise<void>
deleteRelease(string, number, string)
Een release voorlopig verwijderen
function deleteRelease(project: string, releaseId: number, comment?: string): Promise<void>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- comment
-
string
Opmerking voor het verwijderen van een release.
Retouren
Promise<void>
deleteReleaseDefinition(string, number, string, boolean)
Een releasedefinitie verwijderen.
function deleteReleaseDefinition(project: string, definitionId: number, comment?: string, forceDelete?: boolean): Promise<void>
Parameters
- project
-
string
Project-id of projectnaam
- definitionId
-
number
Id van de releasedefinitie.
- comment
-
string
Opmerking voor het verwijderen van een releasedefinitie.
- forceDelete
-
boolean
'true' om automatisch alle implementaties van de release in uitvoering te annuleren en door te gaan met het verwijderen van de releasedefinitie. De standaardwaarde is 'false'.
Retouren
Promise<void>
deleteReleaseTag(string, number, string)
Hiermee verwijdert u een tag uit een release
function deleteReleaseTag(project: string, releaseId: number, tag: string): Promise<string[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
- tag
-
string
Retouren
Promise<string[]>
getAgentArtifactDefinitions(string, number)
Retourneert de artefactdetails die de automatiseringsagent vereist
function getAgentArtifactDefinitions(project: string, releaseId: number): Promise<AgentArtifactDefinition[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Retouren
Promise<AgentArtifactDefinition[]>
getApproval(string, number, boolean)
Een goedkeuring krijgen.
function getApproval(project: string, approvalId: number, includeHistory?: boolean): Promise<ReleaseApproval>
Parameters
- project
-
string
Project-id of projectnaam
- approvalId
-
number
Id van de goedkeuring.
- includeHistory
-
boolean
'true' om de geschiedenis van de goedkeuring op te nemen. De standaardwaarde is 'false'.
Retouren
Promise<ReleaseApproval>
getApprovalHistory(string, number)
Goedkeuringsgeschiedenis ophalen.
function getApprovalHistory(project: string, approvalStepId: number): Promise<ReleaseApproval>
Parameters
- project
-
string
Project-id of projectnaam
- approvalStepId
-
number
Id van de goedkeuring.
Retouren
Promise<ReleaseApproval>
getApprovals(string, string, ApprovalStatus, number[], ApprovalType, number, number, ReleaseQueryOrder, boolean)
Een lijst met goedkeuringen ophalen
function getApprovals(project: string, assignedToFilter?: string, statusFilter?: ApprovalStatus, releaseIdsFilter?: number[], typeFilter?: ApprovalType, top?: number, continuationToken?: number, queryOrder?: ReleaseQueryOrder, includeMyGroupApprovals?: boolean): Promise<PagedList<ReleaseApproval>>
Parameters
- project
-
string
Project-id of projectnaam
- assignedToFilter
-
string
Goedkeuringen die zijn toegewezen aan deze gebruiker.
- statusFilter
- ApprovalStatus
Goedkeuringen met deze status. De standaardwaarde is 'in behandeling'.
- releaseIdsFilter
-
number[]
Goedkeuringen voor release-id('s) die in het filter worden vermeld. Meerdere releases kunnen worden vermeld door ze te scheiden met ',', bijvoorbeeld releaseIdsFilter=1,2,3,4.
- typeFilter
- ApprovalType
Goedkeuring met dit type.
- top
-
number
Het aantal goedkeuringen dat moet worden verkregen. De standaardwaarde is 50.
- continuationToken
-
number
Hiermee worden de goedkeuringen opgehaald na het opgegeven vervolgtoken.
- queryOrder
- ReleaseQueryOrder
Hiermee worden de resultaten opgehaald in de gedefinieerde volgorde van gemaakte goedkeuringen. De standaardwaarde is aflopend.
- includeMyGroupApprovals
-
boolean
"waar" om mijn goedkeuringen van mijn fractie op te nemen. De standaardwaarde is 'false'.
Retouren
Promise<PagedList<ReleaseApproval>>
getArtifactTypeDefinitions(string)
function getArtifactTypeDefinitions(project: string): Promise<ArtifactTypeDefinition[]>
Parameters
- project
-
string
Project-id of projectnaam
Retouren
Promise<ArtifactTypeDefinition[]>
getArtifactVersions(string, number)
function getArtifactVersions(project: string, releaseDefinitionId: number): Promise<ArtifactVersionQueryResult>
Parameters
- project
-
string
Project-id of projectnaam
- releaseDefinitionId
-
number
Retouren
Promise<ArtifactVersionQueryResult>
getArtifactVersionsForSources(Artifact[], string)
function getArtifactVersionsForSources(artifacts: Artifact[], project: string): Promise<ArtifactVersionQueryResult>
Parameters
- artifacts
-
Artifact[]
- project
-
string
Project-id of projectnaam
Retouren
Promise<ArtifactVersionQueryResult>
getAutoTriggerIssues(string, string, string, string)
function getAutoTriggerIssues(artifactType: string, sourceId: string, artifactVersionId: string, project?: string): Promise<AutoTriggerIssue[]>
Parameters
- artifactType
-
string
- sourceId
-
string
- artifactVersionId
-
string
- project
-
string
Project-id of projectnaam
Retouren
Promise<AutoTriggerIssue[]>
getDefinitionEnvironments(string, string, string[])
function getDefinitionEnvironments(project: string, taskGroupId?: string, propertyFilters?: string[]): Promise<DefinitionEnvironmentReference[]>
Parameters
- project
-
string
Project-id of projectnaam
- taskGroupId
-
string
- propertyFilters
-
string[]
Retouren
Promise<DefinitionEnvironmentReference[]>
getDefinitionEnvironmentTemplate(string, string)
Hiermee haalt u een definitieomgevingssjabloon op
function getDefinitionEnvironmentTemplate(project: string, templateId: string): Promise<ReleaseDefinitionEnvironmentTemplate>
Parameters
- project
-
string
Project-id of projectnaam
- templateId
-
string
Id van de sjabloon voor de definitieomgeving
Retouren
Promise<ReleaseDefinitionEnvironmentTemplate>
getDefinitionRevision(string, number, number)
Releasedefinitie ophalen voor een bepaalde definitionId en revisie
function getDefinitionRevision(project: string, definitionId: number, revision: number): Promise<string>
Parameters
- project
-
string
Project-id of projectnaam
- definitionId
-
number
Id van de definitie.
- revision
-
number
Id van de revisie.
Retouren
Promise<string>
getDefinitionTags(string, number)
Hiermee haalt u de tags voor een definitie op
function getDefinitionTags(project: string, releaseDefinitionId: number): Promise<string[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseDefinitionId
-
number
Retouren
Promise<string[]>
getDeploymentBadge(string, number, number, string)
Hiermee haalt u een badge op die de status van de meest recente implementatie voor een omgeving aangeeft.
function getDeploymentBadge(projectId: string, releaseDefinitionId: number, environmentId: number, branchName?: string): Promise<string>
Parameters
- projectId
-
string
De id van het project.
- releaseDefinitionId
-
number
De id van de releasedefinitie.
- environmentId
-
number
De id van de omgeving.
- branchName
-
string
De naam van de vertakking.
Retouren
Promise<string>
getDeployments(string, number, number, string, Date, Date, DeploymentStatus, DeploymentOperationStatus, boolean, ReleaseQueryOrder, number, number, string, Date, Date, string)
Een lijst met implementaties ophalen
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>>
Parameters
- project
-
string
Project-id of projectnaam
- definitionId
-
number
De implementaties voor een bepaalde definitie-id weergeven.
- definitionEnvironmentId
-
number
De implementaties voor een bepaalde definitieomgevings-id weergeven.
- createdBy
-
string
Vermeld de implementaties waarvoor implementaties zijn gemaakt als identiteit die is opgegeven.
- minModifiedTime
-
Date
Geef de implementaties weer met LastModified time >= minModifiedTime.
- maxModifiedTime
-
Date
Geef de implementaties weer met LastModified time <= maxModifiedTime.
- deploymentStatus
- DeploymentStatus
De implementaties met de opgegeven implementatiestatus weergeven. De standaardwaarde is 'Alle'.
- operationStatus
- DeploymentOperationStatus
Vermeld de implementaties met de opgegeven bewerkingsstatus. De standaardwaarde is 'Alle'.
- latestAttemptsOnly
-
boolean
'true' om implementaties op te nemen met alleen de meest recente poging. De standaardwaarde is 'false'.
- queryOrder
- ReleaseQueryOrder
De implementaties met de opgegeven queryvolgorde weergeven. De standaardwaarde is Aflopend.
- top
-
number
Vermeld de implementaties met de opgegeven bovenkant. De standaardtop is '50' en de maximale bovenkant is '100'.
- continuationToken
-
number
Geef de implementaties weer met de implementatie-id >= continuationToken.
- createdFor
-
string
Vermeld de implementaties waarvoor implementaties worden aangevraagd als opgegeven identiteit.
- minStartedTime
-
Date
Geef de implementaties weer met StartedOn time >= minStartedTime.
- maxStartedTime
-
Date
Geef de implementaties weer met StartedOn time <= maxStartedTime.
- sourceBranch
-
string
Vermeld de implementaties die zijn geïmplementeerd vanuit de opgegeven vertakkingsnaam.
Retouren
Promise<PagedList<Deployment>>
getDeploymentsForMultipleEnvironments(DeploymentQueryParameters, string)
function getDeploymentsForMultipleEnvironments(queryParameters: DeploymentQueryParameters, project: string): Promise<Deployment[]>
Parameters
- queryParameters
- DeploymentQueryParameters
- project
-
string
Project-id of projectnaam
Retouren
Promise<Deployment[]>
getFavorites(string, string, string)
function getFavorites(project: string, scope: string, identityId?: string): Promise<FavoriteItem[]>
Parameters
- project
-
string
Project-id of projectnaam
- scope
-
string
- identityId
-
string
Retouren
Promise<FavoriteItem[]>
getFlightAssignments(string)
function getFlightAssignments(flightName?: string): Promise<string[]>
Parameters
- flightName
-
string
Retouren
Promise<string[]>
getFolders(string, string, FolderPathQueryOrder)
Hiermee haalt u mappen op.
function getFolders(project: string, path?: string, queryOrder?: FolderPathQueryOrder): Promise<Folder[]>
Parameters
- project
-
string
Project-id of projectnaam
- path
-
string
Pad van de map.
- queryOrder
- FolderPathQueryOrder
Haalt de resultaten op in de gedefinieerde volgorde. De standaardwaarde is 'Geen'.
Retouren
Promise<Folder[]>
getGateLog(string, number, number, number, number)
Haalt poortlogboeken op
function getGateLog(project: string, releaseId: number, environmentId: number, gateId: number, taskId: number): Promise<string>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- environmentId
-
number
Id van de releaseomgeving.
- gateId
-
number
Id van de poort.
- taskId
-
number
ReleaseTask-id voor het logboek.
Retouren
Promise<string>
getInputValues(InputValuesQuery, string)
function getInputValues(query: InputValuesQuery, project: string): Promise<InputValuesQuery>
Parameters
- query
- InputValuesQuery
- project
-
string
Project-id of projectnaam
Retouren
Promise<InputValuesQuery>
getIssues(string, number, string)
function getIssues(project: string, buildId: number, sourceId?: string): Promise<AutoTriggerIssue[]>
Parameters
- project
-
string
Project-id of projectnaam
- buildId
-
number
- sourceId
-
string
Retouren
Promise<AutoTriggerIssue[]>
getLog(string, number, number, number, number)
Haalt logboeken op
function getLog(project: string, releaseId: number, environmentId: number, taskId: number, attemptId?: number): Promise<string>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- environmentId
-
number
Id van de releaseomgeving.
- taskId
-
number
ReleaseTask-id voor het logboek.
- attemptId
-
number
Id van de poging.
Retouren
Promise<string>
getLogs(string, number)
Logboeken ophalen voor een release-id.
function getLogs(project: string, releaseId: number): Promise<ArrayBuffer>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
Retouren
Promise<ArrayBuffer>
getManualIntervention(string, number, number)
Handmatige interventie ophalen voor een bepaalde release en handmatige interventie-id.
function getManualIntervention(project: string, releaseId: number, manualInterventionId: number): Promise<ManualIntervention>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- manualInterventionId
-
number
Id van de handmatige interventie.
Retouren
Promise<ManualIntervention>
getManualInterventions(string, number)
Alle handmatige interventies voor een bepaalde release weergeven.
function getManualInterventions(project: string, releaseId: number): Promise<ManualIntervention[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
Retouren
Promise<ManualIntervention[]>
getMetrics(string, Date)
function getMetrics(project: string, minMetricsTime?: Date): Promise<Metric[]>
Parameters
- project
-
string
Project-id of projectnaam
- minMetricsTime
-
Date
Retouren
Promise<Metric[]>
getOrgPipelineReleaseSettings()
Release-instellingen voor organisatiepijplijnen ophaalt
function getOrgPipelineReleaseSettings(): Promise<OrgPipelineReleaseSettings>
Retouren
Promise<OrgPipelineReleaseSettings>
getPipelineReleaseSettings(string)
Release-instellingen voor pijplijn ophaalt
function getPipelineReleaseSettings(project: string): Promise<ProjectPipelineReleaseSettings>
Parameters
- project
-
string
Project-id of projectnaam
Retouren
Promise<ProjectPipelineReleaseSettings>
getRelease(string, number, ApprovalFilters, string[], SingleReleaseExpands, number)
Een release downloaden
function getRelease(project: string, releaseId: number, approvalFilters?: ApprovalFilters, propertyFilters?: string[], expand?: SingleReleaseExpands, topGateRecords?: number): Promise<Release>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- approvalFilters
- ApprovalFilters
Een filter waarmee goedkeuringsstappen selectief kunnen worden opgehaald op basis van of het geautomatiseerd of handmatig is. Dit zou ook bepalen of we momentopnamen vóór en na goedkeuring moeten ophalen. Standaard wordt uitgegaan van alles
- propertyFilters
-
string[]
Een door komma's gescheiden lijst met uitgebreide eigenschappen die moeten worden opgehaald. Als dit is ingesteld, bevat de geretourneerde Release waarden voor de opgegeven eigenschap-id's (als deze bestaan). Als dit niet is ingesteld, worden de eigenschappen niet opgenomen.
- expand
- SingleReleaseExpands
Een eigenschap die moet worden uitgebreid in de release.
- topGateRecords
-
number
Het aantal releasegaterecords dat moet worden ophalen. De standaardwaarde is 5.
Retouren
Promise<Release>
getReleaseChanges(string, number, number, number, string)
function getReleaseChanges(project: string, releaseId: number, baseReleaseId?: number, top?: number, artifactAlias?: string): Promise<Change[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
- baseReleaseId
-
number
- top
-
number
- artifactAlias
-
string
Retouren
Promise<Change[]>
getReleaseDefinition(string, number, string[])
Een releasedefinitie ophalen.
function getReleaseDefinition(project: string, definitionId: number, propertyFilters?: string[]): Promise<ReleaseDefinition>
Parameters
- project
-
string
Project-id of projectnaam
- definitionId
-
number
Id van de releasedefinitie.
- propertyFilters
-
string[]
Een door komma's gescheiden lijst met uitgebreide eigenschappen die moeten worden opgehaald. Als dit is ingesteld, bevat de geretourneerde releasedefinitie waarden voor de opgegeven eigenschaps-id's (als deze bestaan). Als dit niet is ingesteld, worden de eigenschappen niet opgenomen.
Retouren
Promise<ReleaseDefinition>
getReleaseDefinitionHistory(string, number)
Revisiegeschiedenis voor een releasedefinitie ophalen
function getReleaseDefinitionHistory(project: string, definitionId: number): Promise<ReleaseDefinitionRevision[]>
Parameters
- project
-
string
Project-id of projectnaam
- definitionId
-
number
Id van de definitie.
Retouren
Promise<ReleaseDefinitionRevision[]>
getReleaseDefinitionRevision(string, number, number)
Releasedefinitie van een bepaalde revisie ophalen.
function getReleaseDefinitionRevision(project: string, definitionId: number, revision: number): Promise<string>
Parameters
- project
-
string
Project-id of projectnaam
- definitionId
-
number
Id van de releasedefinitie.
- revision
-
number
Revisienummer van de releasedefinitie.
Retouren
Promise<string>
getReleaseDefinitions(string, string, ReleaseDefinitionExpands, string, string, number, string, ReleaseDefinitionQueryOrder, string, boolean, string[], string[], string[], boolean, boolean)
Een lijst met releasedefinities ophalen.
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>>
Parameters
- project
-
string
Project-id of projectnaam
- searchText
-
string
Releasedefinities ophalen met namen die searchText bevatten.
- expand
- ReleaseDefinitionExpands
De eigenschappen die moeten worden uitgevouwen in de lijst met Release-definities.
- artifactType
-
string
Releasedefinities met het opgegeven artifactType worden geretourneerd. Waarden kunnen Build, Jenkins, GitHub, Nuget, Team Build (extern), ExternalTFSBuild, Git, TFVC, ExternalTfsXamlBuild zijn.
- artifactSourceId
-
string
Releasedefinities met de opgegeven artifactSourceId worden geretourneerd. Bijvoorbeeld: voor build is dit {projectGuid}:{BuildDefinitionId}, voor Jenkins {JenkinsConnectionId}:{JenkinsDefinitionId}, voor TfsOnPrem {TfsOnPremConnectionId}:{ProjectName}:{TfsOnPremDefinitionId}. Voor artefacten van derden, zoals TeamCity, BitBucket, kunt u verwijzen naar 'uniqueSourceIdentifier' in vss-extension.json op https://github.com/Microsoft/vsts-rm-extensions/blob/master/Extensions.
- top
-
number
Het aantal releasedefinities dat u wilt ophalen.
- continuationToken
-
string
Haalt de releasedefinities op na het opgegeven vervolgtoken.
- queryOrder
- ReleaseDefinitionQueryOrder
Hiermee worden de resultaten in de gedefinieerde volgorde opgehaald. De standaardwaarde is IdAscending.
- path
-
string
Hiermee worden de releasedefinities onder het opgegeven pad opgeslagen.
- isExactNameMatch
-
boolean
'true'to haalt de releasedefinities op met exacte overeenkomst zoals opgegeven in searchText. De standaardwaarde is 'false'.
- tagFilter
-
string[]
Een door komma's gescheiden lijst met tags. Alleen releasedefinities met deze tags worden geretourneerd.
- propertyFilters
-
string[]
Een door komma's gescheiden lijst met uitgebreide eigenschappen die moeten worden opgehaald. Indien ingesteld, bevatten de geretourneerde releasedefinities waarden voor de opgegeven eigenschap-id's (als deze bestaan). Als dit niet is ingesteld, worden de eigenschappen niet opgenomen. Houd er rekening mee dat hierdoor geen releasedefinities uit de resultaten worden gefilterd, ongeacht of er een eigenschap is ingesteld of niet.
- definitionIdFilter
-
string[]
Een door komma's gescheiden lijst met releasedefinities die moeten worden opgehaald.
- isDeleted
-
boolean
'true' om releasedefinities op te halen die zijn verwijderd. De standaardwaarde is 'false'
- searchTextContainsFolderName
-
boolean
'true' om de releasedefinities op te halen onder de map met de naam zoals opgegeven in searchText. De standaardwaarde is 'false'.
Retouren
Promise<PagedList<ReleaseDefinition>>
getReleaseDefinitionSummary(string, number, number, boolean, number[])
Releaseoverzicht van een bepaalde definitie-id ophalen.
function getReleaseDefinitionSummary(project: string, definitionId: number, releaseCount: number, includeArtifact?: boolean, definitionEnvironmentIdsFilter?: number[]): Promise<ReleaseDefinitionSummary>
Parameters
- project
-
string
Project-id of projectnaam
- definitionId
-
number
Id van de definitie om het releaseoverzicht op te halen.
- releaseCount
-
number
Het aantal releases dat moet worden opgenomen in de samenvatting.
- includeArtifact
-
boolean
Details van artefact opnemen. De standaardwaarde is 'false'.
- definitionEnvironmentIdsFilter
-
number[]
Retouren
Promise<ReleaseDefinitionSummary>
getReleaseEnvironment(string, number, number, ReleaseEnvironmentExpands)
Een releaseomgeving ophalen.
function getReleaseEnvironment(project: string, releaseId: number, environmentId: number, expand?: ReleaseEnvironmentExpands): Promise<ReleaseEnvironment>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- environmentId
-
number
Id van de releaseomgeving.
- expand
- ReleaseEnvironmentExpands
Een eigenschap die moet worden uitgebreid in de omgeving.
Retouren
Promise<ReleaseEnvironment>
getReleaseHistory(string, number)
function getReleaseHistory(project: string, releaseId: number): Promise<ReleaseRevision[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Retouren
Promise<ReleaseRevision[]>
getReleaseProjects(string, string)
function getReleaseProjects(artifactType: string, artifactSourceId: string): Promise<ProjectReference[]>
Parameters
- artifactType
-
string
- artifactSourceId
-
string
Retouren
Promise<ProjectReference[]>
getReleaseRevision(string, number, number)
Release ophalen voor een bepaald revisienummer.
function getReleaseRevision(project: string, releaseId: number, definitionSnapshotRevision: number): Promise<string>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- definitionSnapshotRevision
-
number
Revisienummer van definitiemomentopname.
Retouren
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)
Een lijst met releases ophalen
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<PagedList<Release>>
Parameters
- project
-
string
Project-id of projectnaam
- definitionId
-
number
Releases van deze releasedefinitie-id.
- definitionEnvironmentId
-
number
- searchText
-
string
Releases met namen die searchText bevatten.
- createdBy
-
string
Releases die door deze gebruiker zijn gemaakt.
- statusFilter
- ReleaseStatus
Releases met deze status.
- environmentStatusFilter
-
number
- minCreatedTime
-
Date
Releases die na deze tijd zijn gemaakt.
- maxCreatedTime
-
Date
Releases die vóór deze tijd zijn gemaakt.
- queryOrder
- ReleaseQueryOrder
Hiermee worden de resultaten opgehaald in de gedefinieerde volgorde van de aanmaakdatum voor releases. De standaardwaarde is aflopend.
- top
-
number
Het aantal releases dat u wilt ophalen. De standaardwaarde is 50.
- continuationToken
-
number
Haalt de releases op na het opgegeven vervolgtoken.
- expand
- ReleaseExpands
De eigenschap die moet worden uitgevouwen in de lijst met releases.
- artifactTypeId
-
string
Releases met de opgegeven artifactTypeId worden geretourneerd. Waarden kunnen Build, Jenkins, GitHub, Nuget, Team Build (extern), ExternalTFSBuild, Git, TFVC, ExternalTfsXamlBuild zijn.
- sourceId
-
string
Unieke id van het gebruikte artefact. Bijvoorbeeld: voor build is dit {projectGuid}:{BuildDefinitionId}, voor Jenkins {JenkinsConnectionId}:{JenkinsDefinitionId}, voor TfsOnPrem {TfsOnPremConnectionId}:{ProjectName}:{TfsOnPremDefinitionId}. Voor artefacten van derden, zoals TeamCity, BitBucket, kunt u verwijzen naar 'uniqueSourceIdentifier' in vss-extension.json https://github.com/Microsoft/vsts-rm-extensions/blob/master/Extensions.
- artifactVersionId
-
string
Releases met de gegeven artifactVersionId worden geretourneerd. In het geval van Build artifactType is dit bijvoorbeeld buildId.
- sourceBranchFilter
-
string
Releases met de gegeven sourceBranchFilter worden geretourneerd.
- isDeleted
-
boolean
Haalt de voorlopig verwijderde releases op, indien waar.
- tagFilter
-
string[]
Een door komma's gescheiden lijst met tags. Alleen releases met deze tags worden geretourneerd.
- propertyFilters
-
string[]
Een door komma's gescheiden lijst met uitgebreide eigenschappen die moeten worden opgehaald. Indien ingesteld, bevatten de geretourneerde releases waarden voor de opgegeven eigenschap-id's (als deze bestaan). Als dit niet is ingesteld, worden de eigenschappen niet opgenomen. Houd er rekening mee dat hiermee geen release uit de resultaten wordt gefilterd, ongeacht of er een eigenschap is ingesteld of niet.
- releaseIdFilter
-
number[]
Een door komma's gescheiden lijst met releases-id's. Alleen releases met deze id's worden geretourneerd.
- path
-
string
Releases onder dit mappad worden geretourneerd
Retouren
getReleaseSettings(string)
Hiermee haalt u de release-instellingen op
function getReleaseSettings(project: string): Promise<ReleaseSettings>
Parameters
- project
-
string
Project-id of projectnaam
Retouren
Promise<ReleaseSettings>
getReleaseTags(string, number)
Hiermee haalt u de tags voor een release op
function getReleaseTags(project: string, releaseId: number): Promise<string[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Retouren
Promise<string[]>
getReleaseTaskAttachmentContent(string, number, number, number, string, string, string, string, string)
Een releasetaakbijlage ophalen.
function getReleaseTaskAttachmentContent(project: string, releaseId: number, environmentId: number, attemptId: number, planId: string, timelineId: string, recordId: string, type: string, name: string): Promise<ArrayBuffer>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- environmentId
-
number
Id van de releaseomgeving.
- attemptId
-
number
Aantal implementatiepogingen.
- planId
-
string
Plan-id van de implementatiefase.
- timelineId
-
string
Tijdlijn-id van de taak.
- recordId
-
string
Record-id van bijlage.
- type
-
string
Type bijlage.
- name
-
string
Naam van de bijlage.
Retouren
Promise<ArrayBuffer>
getReleaseTaskAttachments(string, number, number, number, string, string)
Haal de releasetaakbijlagen op.
function getReleaseTaskAttachments(project: string, releaseId: number, environmentId: number, attemptId: number, planId: string, type: string): Promise<ReleaseTaskAttachment[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- environmentId
-
number
Id van de releaseomgeving.
- attemptId
-
number
Aantal implementatiepogingen.
- planId
-
string
Plan-id van de implementatiefase.
- type
-
string
Type bijlage.
Retouren
Promise<ReleaseTaskAttachment[]>
getReleaseWorkItemsRefs(string, number, number, number, string)
function getReleaseWorkItemsRefs(project: string, releaseId: number, baseReleaseId?: number, top?: number, artifactAlias?: string): Promise<ReleaseWorkItemRef[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
- baseReleaseId
-
number
- top
-
number
- artifactAlias
-
string
Retouren
Promise<ReleaseWorkItemRef[]>
getSourceBranches(string, number)
function getSourceBranches(project: string, definitionId: number): Promise<string[]>
Parameters
- project
-
string
Project-id of projectnaam
- definitionId
-
number
Retouren
Promise<string[]>
getSummaryMailSections(string, number)
function getSummaryMailSections(project: string, releaseId: number): Promise<SummaryMailSection[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Retouren
Promise<SummaryMailSection[]>
getTags(string)
function getTags(project: string): Promise<string[]>
Parameters
- project
-
string
Project-id of projectnaam
Retouren
Promise<string[]>
getTaskAttachmentContent(string, number, number, number, string, string, string, string)
Een taakbijlage ophalen.
function getTaskAttachmentContent(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, recordId: string, type: string, name: string): Promise<ArrayBuffer>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- environmentId
-
number
Id van de releaseomgeving.
- attemptId
-
number
Aantal implementatiepogingen.
- timelineId
-
string
Tijdlijn-id van de taak.
- recordId
-
string
Record-id van bijlage.
- type
-
string
Type bijlage.
- name
-
string
Naam van de bijlage.
Retouren
Promise<ArrayBuffer>
getTaskAttachments(string, number, number, number, string, string)
Haal de taakbijlagen op.
function getTaskAttachments(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, type: string): Promise<ReleaseTaskAttachment[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- environmentId
-
number
Id van de releaseomgeving.
- attemptId
-
number
Aantal implementatiepogingen.
- timelineId
-
string
Tijdlijn-id van de taak.
- type
-
string
Type bijlage.
Retouren
Promise<ReleaseTaskAttachment[]>
getTaskLog(string, number, number, number, number, number, number)
Hiermee haalt u het taaklogboek van een release op als een tekstbestand zonder opmaak.
function getTaskLog(project: string, releaseId: number, environmentId: number, releaseDeployPhaseId: number, taskId: number, startLine?: number, endLine?: number): Promise<string>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- environmentId
-
number
Id van releaseomgeving.
- releaseDeployPhaseId
-
number
Release-implementatiefase-id.
- taskId
-
number
ReleaseTask-id voor het logboek.
- startLine
-
number
Beginregelnummer voor logboeken
- endLine
-
number
Eindregelnummer voor logboeken
Retouren
Promise<string>
getTaskLog2(string, number, number, number, string, number, number, number)
Hiermee haalt u het taaklogboek van een release op als een tekstbestand zonder opmaak.
function getTaskLog2(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string, taskId: number, startLine?: number, endLine?: number): Promise<string>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- environmentId
-
number
Id van releaseomgeving.
- attemptId
-
number
- timelineId
-
string
- taskId
-
number
ReleaseTask-id voor het logboek.
- startLine
-
number
Beginregelnummer voor logboeken
- endLine
-
number
Eindregelnummer voor logboeken
Retouren
Promise<string>
getTasks(string, number, number, number)
function getTasks(project: string, releaseId: number, environmentId: number, attemptId?: number): Promise<ReleaseTask[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
- environmentId
-
number
- attemptId
-
number
Retouren
Promise<ReleaseTask[]>
getTasks2(string, number, number, number, string)
function getTasks2(project: string, releaseId: number, environmentId: number, attemptId: number, timelineId: string): Promise<ReleaseTask[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
- environmentId
-
number
- attemptId
-
number
- timelineId
-
string
Retouren
Promise<ReleaseTask[]>
getTasksForTaskGroup(string, number, number, number)
function getTasksForTaskGroup(project: string, releaseId: number, environmentId: number, releaseDeployPhaseId: number): Promise<ReleaseTask[]>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
- environmentId
-
number
- releaseDeployPhaseId
-
number
Retouren
Promise<ReleaseTask[]>
listDefinitionEnvironmentTemplates(string, boolean)
Hiermee haalt u een lijst met definitieomgevingssjablonen op
function listDefinitionEnvironmentTemplates(project: string, isDeleted?: boolean): Promise<ReleaseDefinitionEnvironmentTemplate[]>
Parameters
- project
-
string
Project-id of projectnaam
- isDeleted
-
boolean
'true' om definitieomgevingssjablonen op te halen die zijn verwijderd. De standaardwaarde is 'false'
Retouren
Promise<ReleaseDefinitionEnvironmentTemplate[]>
sendSummaryMail(MailMessage, string, number)
function sendSummaryMail(mailMessage: MailMessage, project: string, releaseId: number): Promise<void>
Parameters
- mailMessage
- MailMessage
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Retouren
Promise<void>
undeleteRelease(string, number, string)
De verwijdering van een voorlopig verwijderde release ongedaan maken.
function undeleteRelease(project: string, releaseId: number, comment: string): Promise<void>
Parameters
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van release die ongedaan moet worden gemaakt.
- comment
-
string
Eventuele opmerkingen voor het ongedaan maken van verwijdering.
Retouren
Promise<void>
undeleteReleaseDefinition(ReleaseDefinitionUndeleteParameter, string, number)
De verwijdering van een releasedefinitie ongedaan maken.
function undeleteReleaseDefinition(releaseDefinitionUndeleteParameter: ReleaseDefinitionUndeleteParameter, project: string, definitionId: number): Promise<ReleaseDefinition>
Parameters
- releaseDefinitionUndeleteParameter
- ReleaseDefinitionUndeleteParameter
Object voor het ongedaan maken van de releasedefinitie.
- project
-
string
Project-id of projectnaam
- definitionId
-
number
Id van de releasedefinitie die ongedaan moet worden gemaakt
Retouren
Promise<ReleaseDefinition>
undeleteReleaseDefinitionEnvironmentTemplate(string, string)
De verwijdering van een omgevingssjabloon voor een releasedefinitie ongedaan maken.
function undeleteReleaseDefinitionEnvironmentTemplate(project: string, templateId: string): Promise<ReleaseDefinitionEnvironmentTemplate>
Parameters
- project
-
string
Project-id of projectnaam
- templateId
-
string
Id van de definitieomgevingssjabloon die ongedaan moet worden gemaakt
Retouren
Promise<ReleaseDefinitionEnvironmentTemplate>
updateFolder(Folder, string, string)
Updates een bestaande map op een bepaald bestaand pad.
function updateFolder(folder: Folder, project: string, path: string): Promise<Folder>
Parameters
- folder
- Folder
bevindt.
- project
-
string
Project-id of projectnaam
- path
-
string
Pad van de map die moet worden bijgewerkt.
Retouren
Promise<Folder>
updateGates(GateUpdateMetadata, string, number)
Updates de poort voor een implementatie.
function updateGates(gateUpdateMetadata: GateUpdateMetadata, project: string, gateStepId: number): Promise<ReleaseGates>
Parameters
- gateUpdateMetadata
- GateUpdateMetadata
Metagegevens voor het patchen van de Release Gates.
- project
-
string
Project-id of projectnaam
- gateStepId
-
number
Stap-id van poort.
Retouren
Promise<ReleaseGates>
updateManualIntervention(ManualInterventionUpdateMetadata, string, number, number)
Handmatige interventie bijwerken.
function updateManualIntervention(manualInterventionUpdateMetadata: ManualInterventionUpdateMetadata, project: string, releaseId: number, manualInterventionId: number): Promise<ManualIntervention>
Parameters
- manualInterventionUpdateMetadata
- ManualInterventionUpdateMetadata
Metagegevens voor het bijwerken van handmatige interventie.
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- manualInterventionId
-
number
Id van de handmatige interventie.
Retouren
Promise<ManualIntervention>
updateOrgPipelineReleaseSettings(OrgPipelineReleaseSettingsUpdateParameters)
release-instellingen voor Updates-organisatiepijplijn
function updateOrgPipelineReleaseSettings(newSettings: OrgPipelineReleaseSettingsUpdateParameters): Promise<OrgPipelineReleaseSettings>
Parameters
- newSettings
- OrgPipelineReleaseSettingsUpdateParameters
Retouren
Promise<OrgPipelineReleaseSettings>
updatePipelineReleaseSettings(ProjectPipelineReleaseSettingsUpdateParameters, string)
release-instellingen voor Updates-pijplijn
function updatePipelineReleaseSettings(newSettings: ProjectPipelineReleaseSettingsUpdateParameters, project: string): Promise<ProjectPipelineReleaseSettings>
Parameters
- newSettings
- ProjectPipelineReleaseSettingsUpdateParameters
- project
-
string
Project-id of projectnaam
Retouren
Promise<ProjectPipelineReleaseSettings>
updateRelease(Release, string, number)
Een volledig releaseobject bijwerken.
function updateRelease(release: Release, project: string, releaseId: number): Promise<Release>
Parameters
- release
- Release
Geef het object vrij voor update.
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release die moet worden bijgewerkt.
Retouren
Promise<Release>
updateReleaseApproval(ReleaseApproval, string, number)
Updatestatus van een goedkeuring
function updateReleaseApproval(approval: ReleaseApproval, project: string, approvalId: number): Promise<ReleaseApproval>
Parameters
- approval
- ReleaseApproval
ReleaseApproval-object met status, fiatteur en opmerkingen.
- project
-
string
Project-id of projectnaam
- approvalId
-
number
Id van de goedkeuring.
Retouren
Promise<ReleaseApproval>
updateReleaseApprovals(ReleaseApproval[], string)
function updateReleaseApprovals(approvals: ReleaseApproval[], project: string): Promise<ReleaseApproval[]>
Parameters
- approvals
- project
-
string
Project-id of projectnaam
Retouren
Promise<ReleaseApproval[]>
updateReleaseDefinition(ReleaseDefinition, string)
Een releasedefinitie bijwerken.
function updateReleaseDefinition(releaseDefinition: ReleaseDefinition, project: string): Promise<ReleaseDefinition>
Parameters
- releaseDefinition
- ReleaseDefinition
Releasedefinitieobject dat moet worden bijgewerkt.
- project
-
string
Project-id of projectnaam
Retouren
Promise<ReleaseDefinition>
updateReleaseEnvironment(ReleaseEnvironmentUpdateMetadata, string, number, number)
De status van een releaseomgeving bijwerken
function updateReleaseEnvironment(environmentUpdateData: ReleaseEnvironmentUpdateMetadata, project: string, releaseId: number, environmentId: number): Promise<ReleaseEnvironment>
Parameters
- environmentUpdateData
- ReleaseEnvironmentUpdateMetadata
Metagegevens bijwerken in de omgeving.
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release.
- environmentId
-
number
Id van releaseomgeving.
Retouren
Promise<ReleaseEnvironment>
updateReleaseResource(ReleaseUpdateMetadata, string, number)
Enkele eigenschappen van een release bijwerken.
function updateReleaseResource(releaseUpdateMetadata: ReleaseUpdateMetadata, project: string, releaseId: number): Promise<Release>
Parameters
- releaseUpdateMetadata
- ReleaseUpdateMetadata
Eigenschappen van release die moet worden bijgewerkt.
- project
-
string
Project-id of projectnaam
- releaseId
-
number
Id van de release die moet worden bijgewerkt.
Retouren
Promise<Release>
updateReleaseSettings(ReleaseSettings, string)
de release-instellingen Updates
function updateReleaseSettings(releaseSettings: ReleaseSettings, project: string): Promise<ReleaseSettings>
Parameters
- releaseSettings
- ReleaseSettings
- project
-
string
Project-id of projectnaam
Retouren
Promise<ReleaseSettings>