Condividi tramite


Templates - Save Template

Aggiornamenti un modello di definizione di compilazione esistente.

PUT https://dev.azure.com/{organization}/{project}/_apis/build/definitions/templates/{templateId}?api-version=7.1-preview.3

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
path True

string

Nome dell'organizzazione di Azure DevOps.

project
path True

string

ID progetto o nome del progetto

templateId
path True

string

ID del modello.

api-version
query True

string

Versione dell'API da usare. Deve essere impostato su '7.1-preview.3' per usare questa versione dell'API.

Corpo della richiesta

Nome Tipo Descrizione
canDelete

boolean

Indica se il modello può essere eliminato.

category

string

Categoria del modello.

defaultHostedQueue

string

Coda facoltativa dell'agente ospitato per il modello da usare per impostazione predefinita.

description

string

Descrizione del modello.

iconTaskId

string

ID dell'attività la cui icona viene usata quando viene visualizzato questo modello nell'interfaccia utente.

icons

object

id

string

ID del modello.

name

string

Nome del modello.

template

BuildDefinition

Modello effettivo.

Risposte

Nome Tipo Descrizione
200 OK

BuildDefinitionTemplate

operazione riuscita

Sicurezza

oauth2

Type: oauth2
Flow: accessCode
Authorization URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL: https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer

Scopes

Nome Descrizione
vso.build_execute Concede la possibilità di accedere agli artefatti di compilazione, inclusi i risultati di compilazione, le definizioni e le richieste e la possibilità di accodare una compilazione, aggiornare le proprietà di compilazione e la possibilità di ricevere notifiche sugli eventi di compilazione tramite hook del servizio.

Definizioni

Nome Descrizione
AgentPoolQueue

Rappresenta una coda per l'esecuzione di compilazioni.

AgentSpecification

Specifica dell'agente definito dal provider di pool.

AuthorizationHeader
Build

Rappresentazione dei dati di una compilazione.

BuildAuthorizationScope

Ambito di autorizzazione del processo per le compilazioni accodate in base a questa definizione.

BuildController
BuildDefinition

Rappresenta una definizione di compilazione.

BuildDefinitionTemplate

Rappresenta un modello da cui è possibile creare nuove definizioni di compilazione.

BuildDefinitionVariable

Rappresenta una variabile utilizzata da una definizione di compilazione.

BuildLogReference

Rappresenta un riferimento a un log di compilazione.

BuildMetric

Rappresenta i metadati relativi alle compilazioni nel sistema.

BuildOption

Rappresenta l'applicazione di un comportamento facoltativo a una definizione di compilazione.

BuildOptionDefinitionReference

Rappresenta un riferimento a una definizione di opzione di compilazione.

BuildProcess

Rappresenta un processo di compilazione.

BuildReason

Motivo per cui è stata creata la compilazione.

BuildRepository

Rappresenta un repository utilizzato da una definizione di compilazione.

BuildRequestValidationResult

Rappresenta il risultato della convalida di una richiesta di compilazione.

BuildResult

Risultato della compilazione.

BuildStatus

Stato della compilazione.

BuildTrigger

Rappresenta un trigger per una definizione con buld.

ControllerStatus

Stato del controller.

DataSourceBindingBase

Rappresenta l'associazione dell'origine dati per la richiesta dell'endpoint di servizio.

DefinitionQuality

Qualità del documento di definizione (bozza e così via)

DefinitionQueueStatus

Valore che indica se le compilazioni possono essere accodate a questa definizione.

DefinitionReference

Rappresenta un riferimento a una definizione.

DefinitionTriggerType

Tipo di trigger.

DefinitionType

Tipo di definizione.

Demand

Rappresenta una richiesta utilizzata da una definizione o da una compilazione.

IdentityRef
ProcessParameters
ProjectState

Stato del progetto.

ProjectVisibility

Visibilità del progetto.

PropertiesCollection

La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un TypeCode != TypeCode.Object) ad eccezione DBNull di vengono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, le altre primitive vengono riattivate come String. Byte[] previsto come stringa con codifica Base64.

QueueOptions

Opzioni aggiuntive per accodare la compilazione.

QueuePriority

Priorità della compilazione.

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

RetentionPolicy

Rappresenta un criterio di conservazione per una definizione di compilazione.

TaskAgentPoolReference

Rappresenta un riferimento a un pool di agenti.

TaskInputDefinitionBase
TaskInputValidation
TaskOrchestrationPlanReference

Rappresenta un riferimento a un piano di orchestrazione.

TaskSourceDefinitionBase
TeamProjectReference

Rappresenta un riferimento superficiale a un TeamProject.

ValidationResult

Risultato.

VariableGroup

Rappresenta un gruppo di variabili.

AgentPoolQueue

Rappresenta una coda per l'esecuzione di compilazioni.

Nome Tipo Descrizione
_links

ReferenceLinks

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

id

integer

ID della coda.

name

string

Nome della coda.

pool

TaskAgentPoolReference

Pool usato da questa coda.

url

string

Collegamento http completo alla risorsa.

AgentSpecification

Specifica dell'agente definito dal provider di pool.

Nome Tipo Descrizione
identifier

string

Identificatore univoco della specifica dell'agente.

AuthorizationHeader

Nome Tipo Descrizione
name

string

value

string

Build

Rappresentazione dei dati di una compilazione.

Nome Tipo Descrizione
_links

ReferenceLinks

Classe da rappresentare una raccolta di collegamenti di riferimento REST.

agentSpecification

AgentSpecification

Specifica dell'agente per la compilazione.

appendCommitMessageToRunName

boolean

Aggiungere il messaggio di commit a BuildNumber nell'interfaccia utente.

buildNumber

string

Numero di compilazione/nome della compilazione.

buildNumberRevision

integer

Revisione del numero di compilazione.

controller

BuildController

Controller di compilazione. Viene impostato solo se il tipo di definizione è Xaml.

definition

DefinitionReference

Definizione associata alla compilazione.

deleted

boolean

Indica se la compilazione è stata eliminata.

deletedBy

IdentityRef

Identità del processo o della persona che ha eliminato la compilazione.

deletedDate

string

Data di eliminazione della compilazione.

deletedReason

string

Descrizione della modalità di eliminazione della compilazione.

demands

Demand[]

Elenco delle richieste che rappresenta le funzionalità dell'agente richieste da questa compilazione.

finishTime

string

Ora di completamento della compilazione.

id

integer

ID della compilazione.

lastChangedBy

IdentityRef

Identità che rappresenta il processo o la persona che ha modificato l'ultima compilazione.

lastChangedDate

string

Data dell'ultima modifica della compilazione.

logs

BuildLogReference

Informazioni sui log di compilazione.

orchestrationPlan

TaskOrchestrationPlanReference

Piano di orchestrazione per la compilazione.

parameters

string

Parametri per la compilazione.

plans

TaskOrchestrationPlanReference[]

Piani di orchestrazione associati alla compilazione (compilazione, pulizia)

priority

QueuePriority

Priorità della compilazione.

project

TeamProjectReference

Progetto team.

properties

PropertiesCollection

La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un TypeCode != TypeCode.Object) ad eccezione DBNull di sono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, altre primitive vengono ritunate come String. Byte[] previsto come stringa codificata base64.

quality

string

Qualità della compilazione xaml (buona, cattiva e così via)

queue

AgentPoolQueue

Coda. Viene impostato solo se il tipo di definizione è Build. AVVISO: questo campo è deprecato e non corrisponde alle code dei processi.

queueOptions

QueueOptions

Opzioni aggiuntive per accodare la compilazione.

queuePosition

integer

Posizione corrente della compilazione nella coda.

queueTime

string

Ora in cui la compilazione è stata accodata.

reason

BuildReason

Motivo per cui è stata creata la compilazione.

repository

BuildRepository

Repository.

requestedBy

IdentityRef

Identità che ha accodato la compilazione.

requestedFor

IdentityRef

Identità per cui è stata accodata la compilazione.

result

BuildResult

Risultato della compilazione.

retainedByRelease

boolean

Indica se la compilazione viene mantenuta da una versione.

sourceBranch

string

Ramo di origine.

sourceVersion

string

La versione di origine.

startTime

string

Ora di avvio della compilazione.

status

BuildStatus

Stato della compilazione.

tags

string[]

templateParameters

object

Parametri per la valutazione delle espressioni modello

triggerInfo

object

Informazioni specifiche di Sourceprovider su cosa ha attivato la compilazione

triggeredByBuild

Build

Compilazione che ha attivato questa compilazione tramite un trigger di completamento della compilazione.

uri

string

URI della compilazione.

url

string

URL REST della compilazione.

validationResults

BuildRequestValidationResult[]

Rappresenta il risultato della convalida di una richiesta di compilazione.

BuildAuthorizationScope

Ambito di autorizzazione del processo per le compilazioni accodate in base a questa definizione.

Nome Tipo Descrizione
project

string

L'identità usata deve avere autorizzazioni per l'account del servizio di compilazione con ambito per il progetto in cui risiede la definizione di compilazione. Ciò è utile per l'isolamento dei processi di compilazione in un determinato progetto team per evitare eventuali attacchi accidentali di privilegi durante una compilazione.

projectCollection

string

L'identità usata deve avere autorizzazioni per l'account del servizio di compilazione con ambito per la raccolta di progetti. Ciò è utile quando le risorse per una singola compilazione vengono distribuite tra più progetti.

BuildController

Nome Tipo Descrizione
_links

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

createdDate

string

Data di creazione del controller.

description

string

Descrizione del controller.

enabled

boolean

Indica se il controller è abilitato.

id

integer

ID della risorsa

name

string

Nome della risorsa collegata (nome della definizione, nome del controller e così via)

status

ControllerStatus

Stato del controller.

updatedDate

string

Data dell'ultimo aggiornamento del controller.

uri

string

URI del controller.

url

string

Collegamento HTTP completo alla risorsa

BuildDefinition

Rappresenta una definizione di compilazione.

Nome Tipo Descrizione
_links

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

authoredBy

IdentityRef

Autore della definizione.

badgeEnabled

boolean

Indica se le notifiche sono abilitate per questa definizione.

buildNumberFormat

string

Formato del numero di build.

comment

string

Commento di risparmio di tempo per la definizione.

createdDate

string

Data di creazione della versione della definizione.

demands

Demand[]

Rappresenta una richiesta utilizzata da una definizione o da una compilazione.

description

string

Descrizione.

draftOf

DefinitionReference

Riferimento alla definizione di cui questa definizione è una bozza, se si tratta di una definizione bozza.

drafts

DefinitionReference[]

Elenco di bozze associate a questa definizione, se non si tratta di una definizione bozza.

dropLocation

string

Posizione di rilascio per la definizione.

id

integer

ID della definizione a cui si fa riferimento.

jobAuthorizationScope

BuildAuthorizationScope

Ambito di autorizzazione del processo per le compilazioni accodate in base a questa definizione.

jobCancelTimeoutInMinutes

integer

Timeout di annullamento del processo (in minuti) per le compilazioni annullate dall'utente per questa definizione.

jobTimeoutInMinutes

integer

Timeout di esecuzione del processo (in minuti) per le compilazioni accodate a questa definizione.

latestBuild

Build

Rappresentazione dei dati di una compilazione.

latestCompletedBuild

Build

Rappresentazione dei dati di una compilazione.

metrics

BuildMetric[]

Rappresenta i metadati relativi alle compilazioni nel sistema.

name

string

Nome della definizione a cui si fa riferimento.

options

BuildOption[]

Rappresenta l'applicazione di un comportamento facoltativo a una definizione di compilazione.

path

string

Percorso della cartella della definizione.

process

BuildProcess

Processo di compilazione.

processParameters

ProcessParameters

Parametri di processo per questa definizione.

project

TeamProjectReference

Riferimento al progetto.

properties

PropertiesCollection

La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un TypeCode != TypeCode.Object) ad eccezione DBNull di vengono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, le altre primitive vengono riattivate come String. Byte[] previsto come stringa con codifica Base64.

quality

DefinitionQuality

Qualità del documento di definizione (bozza e così via)

queue

AgentPoolQueue

La coda predefinita per le compilazioni viene eseguita su questa definizione.

queueStatus

DefinitionQueueStatus

Valore che indica se le compilazioni possono essere accodate a questa definizione.

repository

BuildRepository

Repository.

retentionRules

RetentionPolicy[]

Rappresenta un criterio di conservazione per una definizione di compilazione.

revision

integer

Numero di revisione della definizione.

tags

string[]

triggers

BuildTrigger[]

Rappresenta un trigger per una definizione con buld.

type

DefinitionType

Tipo di definizione.

uri

string

URI della definizione.

url

string

URL REST della definizione.

variableGroups

VariableGroup[]

Rappresenta un gruppo di variabili.

variables

<string,  BuildDefinitionVariable>

BuildDefinitionTemplate

Rappresenta un modello da cui è possibile creare nuove definizioni di compilazione.

Nome Tipo Descrizione
canDelete

boolean

Indica se il modello può essere eliminato.

category

string

Categoria del modello.

defaultHostedQueue

string

Coda facoltativa dell'agente ospitato per il modello da usare per impostazione predefinita.

description

string

Descrizione del modello.

iconTaskId

string

ID dell'attività la cui icona viene usata quando viene visualizzato questo modello nell'interfaccia utente.

icons

object

id

string

ID del modello.

name

string

Nome del modello.

template

BuildDefinition

Modello effettivo.

BuildDefinitionVariable

Rappresenta una variabile utilizzata da una definizione di compilazione.

Nome Tipo Descrizione
allowOverride

boolean

Indica se il valore può essere impostato in fase di coda.

isSecret

boolean

Indica se il valore della variabile è un segreto.

value

string

Valore della variabile.

BuildLogReference

Rappresenta un riferimento a un log di compilazione.

Nome Tipo Descrizione
id

integer

ID del log.

type

string

Tipo del percorso del log.

url

string

Collegamento completo alla risorsa di log.

BuildMetric

Rappresenta i metadati relativi alle compilazioni nel sistema.

Nome Tipo Descrizione
date

string

Data dell'ambito.

intValue

integer

Valore.

name

string

Nome della metrica.

scope

string

Ambito.

BuildOption

Rappresenta l'applicazione di un comportamento facoltativo a una definizione di compilazione.

Nome Tipo Descrizione
definition

BuildOptionDefinitionReference

Riferimento all'opzione di compilazione.

enabled

boolean

Indica se il comportamento è abilitato.

inputs

object

BuildOptionDefinitionReference

Rappresenta un riferimento a una definizione di opzione di compilazione.

Nome Tipo Descrizione
id

string

ID dell'opzione di compilazione a cui si fa riferimento.

BuildProcess

Rappresenta un processo di compilazione.

Nome Tipo Descrizione
type

integer

Tipo di processo.

BuildReason

Motivo per cui è stata creata la compilazione.

Nome Tipo Descrizione
all

string

Tutti i motivi.

batchedCI

string

La compilazione è stata avviata per il trigger TriggerType.BatchedContinuousIntegration.

buildCompletion

string

La compilazione è stata avviata al termine di un'altra compilazione.

checkInShelveset

string

La compilazione è stata avviata per il trigger ContinuousIntegrationType.Gated.

individualCI

string

La compilazione è stata avviata per il trigger TriggerType.ContinuousIntegration.

manual

string

La compilazione è stata avviata manualmente.

none

string

Nessun motivo. Questo valore non deve essere utilizzato.

pullRequest

string

La compilazione è stata avviata da una richiesta pull. Aggiunta nella versione 3 della risorsa.

resourceTrigger

string

La compilazione è stata avviata quando le risorse nella pipeline l'hanno attivata

schedule

string

La compilazione è stata avviata per il trigger TriggerType.Schedule.

scheduleForced

string

La compilazione è stata avviata per il trigger TriggerType.ScheduleForced.

triggered

string

La compilazione è stata attivata a scopo di criteri di conservazione.

userCreated

string

La compilazione è stata creata da un utente.

validateShelveset

string

La compilazione è stata avviata manualmente per la convalida privata.

BuildRepository

Rappresenta un repository utilizzato da una definizione di compilazione.

Nome Tipo Descrizione
checkoutSubmodules

boolean

Indica se eseguire l'estrazione di moduli secondari.

clean

string

Indica se pulire la cartella di destinazione durante il recupero del codice dal repository.

defaultBranch

string

Nome del ramo predefinito.

id

string

ID del repository.

name

string

Nome descrittivo del repository.

properties

object

rootFolder

string

La cartella radice.

type

string

Tipo del repository.

url

string

URL del repository.

BuildRequestValidationResult

Rappresenta il risultato della convalida di una richiesta di compilazione.

Nome Tipo Descrizione
message

string

Messaggio associato al risultato.

result

ValidationResult

Risultato.

BuildResult

Risultato della compilazione.

Nome Tipo Descrizione
canceled

string

La compilazione è stata annullata prima dell'avvio.

failed

string

La compilazione è stata completata in modo non riuscito.

none

string

Nessun risultato

partiallySucceeded

string

La compilazione è stata completata correttamente ma si sono verificati altri errori.

succeeded

string

La compilazione è stata completata correttamente.

BuildStatus

Stato della compilazione.

Nome Tipo Descrizione
all

string

Tutti gli stati.

cancelling

string

La compilazione viene annullata

completed

string

La compilazione è stata completata.

inProgress

string

La compilazione è attualmente in corso.

none

string

Nessuno stato.

notStarted

string

La compilazione non è ancora stata avviata.

postponed

string

La compilazione è inattiva nella coda.

BuildTrigger

Rappresenta un trigger per una definizione con buld.

Nome Tipo Descrizione
triggerType

DefinitionTriggerType

Tipo di trigger.

ControllerStatus

Stato del controller.

Nome Tipo Descrizione
available

string

Indica che il controller di compilazione è attualmente disponibile.

offline

string

Indica che il controller di compilazione si è portato offline.

unavailable

string

Indica che il controller di compilazione non può essere contattato.

DataSourceBindingBase

Rappresenta l'associazione dell'origine dati per la richiesta dell'endpoint di servizio.

Nome Tipo Descrizione
callbackContextTemplate

string

Formato di paginazione supportato da questa origine dati(ContinuationToken/SkipTop).

callbackRequiredTemplate

string

Chiamate successive necessarie?

dataSourceName

string

Ottiene o imposta il nome dell'origine dati.

endpointId

string

Ottiene o imposta l'ID endpoint.

endpointUrl

string

Ottiene o imposta l'URL dell'endpoint di servizio.

headers

AuthorizationHeader[]

Ottiene o imposta le intestazioni di autorizzazione.

initialContextTemplate

string

Definisce il valore iniziale dei parametri della query

parameters

object

Ottiene o imposta i parametri per l'origine dati.

requestContent

string

Ottiene o imposta il corpo della richiesta HTTP

requestVerb

string

Ottiene o imposta il verbo della richiesta HTTP

resultSelector

string

Ottiene o imposta il selettore dei risultati.

resultTemplate

string

Ottiene o imposta il modello di risultato.

target

string

Ottiene o imposta la destinazione dell'origine dati.

DefinitionQuality

Qualità del documento di definizione (bozza e così via)

Nome Tipo Descrizione
definition

string

draft

string

DefinitionQueueStatus

Valore che indica se le compilazioni possono essere accodate a questa definizione.

Nome Tipo Descrizione
disabled

string

Se disabilitata, la coda di definizioni non consentirà la coda di compilazioni da parte degli utenti e il sistema non accoderà le compilazioni pianificate, gestite o di integrazione continua. Le compilazioni già presenti nella coda non verranno avviate dal sistema.

enabled

string

Se abilitata, la coda di definizioni consente di accodare le compilazioni da parte degli utenti, il sistema accoderà le compilazioni pianificate, gestite e continue e le compilazioni in coda verranno avviate dal sistema.

paused

string

Quando viene sospesa la coda di definizioni, le compilazioni vengono accodate dagli utenti e il sistema accoderà le compilazioni pianificate, gestite e di integrazione continua. Le compilazioni nella coda non verranno avviate dal sistema.

DefinitionReference

Rappresenta un riferimento a una definizione.

Nome Tipo Descrizione
createdDate

string

Data di creazione di questa versione della definizione.

id

integer

ID della definizione a cui si fa riferimento.

name

string

Nome della definizione a cui si fa riferimento.

path

string

Percorso della cartella della definizione.

project

TeamProjectReference

Riferimento al progetto.

queueStatus

DefinitionQueueStatus

Valore che indica se le compilazioni possono essere accodate a questa definizione.

revision

integer

Numero di revisione della definizione.

type

DefinitionType

Tipo di definizione.

uri

string

URI della definizione.

url

string

URL REST della definizione.

DefinitionTriggerType

Tipo di trigger.

Nome Tipo Descrizione
all

string

Tutti i tipi.

batchedContinuousIntegration

string

Una compilazione deve essere avviata per più insiemi di modifiche alla volta a un intervallo specificato.

batchedGatedCheckIn

string

È necessario avviare una compilazione di convalida per ogni batch di archiviazione.

buildCompletion

string

Una compilazione deve essere attivata al termine di un'altra compilazione.

continuousIntegration

string

È necessario avviare una compilazione per ogni insieme di modifiche.

gatedCheckIn

string

È necessario avviare una compilazione di convalida per ogni archiviazione.

none

string

Solo compilazioni manuali.

pullRequest

string

Una compilazione deve essere attivata quando viene creata o aggiornata una richiesta pull di GitHub. Aggiunta nella versione 3 della risorsa

schedule

string

Una compilazione deve essere avviata in base a una pianificazione specificata indipendentemente dal fatto che esistano o meno insiemi di modifiche.

DefinitionType

Tipo di definizione.

Nome Tipo Descrizione
build

string

xaml

string

Demand

Rappresenta una richiesta utilizzata da una definizione o da una compilazione.

Nome Tipo Descrizione
name

string

Nome della funzionalità a cui fa riferimento la richiesta.

value

string

Valore richiesto.

IdentityRef

Nome Tipo Descrizione
_links

ReferenceLinks

Questo campo contiene zero o più collegamenti interessanti sull'oggetto grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate su questo argomento grafico.

descriptor

string

Il descrittore è il modo principale per fare riferimento all'oggetto del grafico durante l'esecuzione del sistema. Questo campo identificherà in modo univoco lo stesso soggetto grafo in account e organizzazioni.

directoryAlias

string

Deprecato: può essere recuperato eseguendo query sull'utente Graph a cui si fa riferimento nella voce "self" del dizionario IdentityRef "_links"

displayName

string

Si tratta del nome visualizzato non univoco dell'oggetto grafico. Per modificare questo campo, è necessario modificarlo nel provider di origine.

id

string

imageUrl

string

Deprecato - Disponibile nella voce "avatar" del dizionario IdentityRef "_links"

inactive

boolean

Deprecato: può essere recuperato eseguendo una query sullo stato di appartenenza Graph a cui fa riferimento nella voce "membershipState" del dizionario GraphUser "_links"

isAadIdentity

boolean

Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descrittore.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Deprecato: può essere dedotto dal tipo di soggetto del descrittore (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

Deprecato : non in uso nella maggior parte delle implementazioni preesistenti di ToIdentityRef

uniqueName

string

Deprecato: usare invece Domain+PrincipalName

url

string

Questo URL è la route completa alla risorsa di origine di questo oggetto grafico.

ProcessParameters

Nome Tipo Descrizione
dataSourceBindings

DataSourceBindingBase[]

Rappresenta l'associazione dell'origine dati per la richiesta dell'endpoint di servizio.

inputs

TaskInputDefinitionBase[]

sourceDefinitions

TaskSourceDefinitionBase[]

ProjectState

Stato del progetto.

Nome Tipo Descrizione
all

string

Tutti i progetti indipendentemente dallo stato ad eccezione di Deleted.

createPending

string

Il progetto è stato accodato per la creazione, ma il processo non è ancora stato avviato.

deleted

string

Il progetto è stato eliminato.

deleting

string

Il progetto è in fase di eliminazione.

new

string

Il progetto è in fase di creazione.

unchanged

string

Il progetto non è stato modificato.

wellFormed

string

Il progetto è completamente creato e pronto per l'uso.

ProjectVisibility

Visibilità del progetto.

Nome Tipo Descrizione
private

string

Il progetto è visibile solo agli utenti con accesso esplicito.

public

string

Il progetto è visibile a tutti.

PropertiesCollection

La classe rappresenta un contenitore di proprietà come raccolta di coppie chiave-valore. I valori di tutti i tipi primitivi (qualsiasi tipo con un TypeCode != TypeCode.Object) ad eccezione DBNull di vengono accettati. I valori di tipo Byte[], Int32, Double, DateType e String mantengono il tipo, le altre primitive vengono riattivate come String. Byte[] previsto come stringa con codifica Base64.

Nome Tipo Descrizione
count

integer

Conteggio delle proprietà nell'insieme.

item

object

keys

string[]

Set di chiavi nell'insieme.

values

string[]

Set di valori nell'insieme.

QueueOptions

Opzioni aggiuntive per accodare la compilazione.

Nome Tipo Descrizione
doNotRun

string

Creare un ID piano per la compilazione, non eseguirlo

none

string

Nessuna opzione di coda

QueuePriority

Priorità della compilazione.

Nome Tipo Descrizione
aboveNormal

string

Sopra la priorità normale.

belowNormal

string

Al di sotto della priorità normale.

high

string

Ad alta priorità.

low

string

A bassa priorità.

normal

string

Priorità normale.

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

RetentionPolicy

Rappresenta un criterio di conservazione per una definizione di compilazione.

Nome Tipo Descrizione
artifactTypesToDelete

string[]

artifacts

string[]

branches

string[]

daysToKeep

integer

Numero di giorni per la conservazione delle compilazioni.

deleteBuildRecord

boolean

Indica se il record di compilazione stesso deve essere eliminato.

deleteTestResults

boolean

Indica se eliminare i risultati dei test associati alla compilazione.

minimumToKeep

integer

Numero minimo di compilazioni da mantenere.

TaskAgentPoolReference

Rappresenta un riferimento a un pool di agenti.

Nome Tipo Descrizione
id

integer

ID pool.

isHosted

boolean

Valore che indica se il pool è gestito dal servizio o meno.

name

string

Nome del pool.

TaskInputDefinitionBase

Nome Tipo Descrizione
aliases

string[]

defaultValue

string

groupName

string

helpMarkDown

string

label

string

name

string

options

object

properties

object

required

boolean

type

string

validation

TaskInputValidation

visibleRule

string

TaskInputValidation

Nome Tipo Descrizione
expression

string

Espressione condizionale

message

string

Messaggio che spiega come l'utente può correggere se la convalida ha esito negativo

TaskOrchestrationPlanReference

Rappresenta un riferimento a un piano di orchestrazione.

Nome Tipo Descrizione
orchestrationType

integer

Tipo del piano.

planId

string

ID del piano.

TaskSourceDefinitionBase

Nome Tipo Descrizione
authKey

string

endpoint

string

keySelector

string

selector

string

target

string

TeamProjectReference

Rappresenta un riferimento superficiale a un TeamProject.

Nome Tipo Descrizione
abbreviation

string

Abbreviazione del progetto.

defaultTeamImageUrl

string

Url dell'immagine di identità del team predefinita.

description

string

Descrizione del progetto (se presente).

id

string

Identificatore del progetto.

lastUpdateTime

string

Ora dell'ultimo aggiornamento del progetto.

name

string

Nome progetto.

revision

integer

Revisione del progetto.

state

ProjectState

Stato del progetto.

url

string

Url alla versione completa dell'oggetto.

visibility

ProjectVisibility

Visibilità del progetto.

ValidationResult

Risultato.

Nome Tipo Descrizione
error

string

ok

string

warning

string

VariableGroup

Rappresenta un gruppo di variabili.

Nome Tipo Descrizione
alias

string

Nome del gruppo di variabili.

description

string

Descrizione.

id

integer

ID del gruppo di variabili.

name

string

Nome del gruppo di variabili.

type

string

Tipo del gruppo di variabili.

variables

<string,  BuildDefinitionVariable>