Condividi tramite


GitRestClient class

Classe di base da usare (derivata da) per effettuare richieste alle API REST vss

Extends

Costruttori

GitRestClient(IVssRestClientOptions)

Proprietà

RESOURCE_AREA_ID

Metodi

createAnnotatedTag(GitAnnotatedTag, string, string)

Creare un tag con annotazioni.

createAttachment(any, string, string, number, string)

Allegare un nuovo file a una richiesta pull.

createCherryPick(GitAsyncRefOperationParameters, string, string)

Cherry seleziona un commit o commit specifici associati a una richiesta pull in un nuovo ramo.

createComment(Comment, string, number, number, string)

Creare un commento su un thread specifico in una richiesta pull (è possibile creare fino a 500 commenti per thread).

createCommitStatus(GitStatus, string, string, string)

Creare lo stato del commit Git.

createFavorite(GitRefFavorite, string)

Crea un riferimento preferito

createForkSyncRequest(GitForkSyncRequestParameters, string, string, boolean)

Richiedere che i riferimenti di un altro repository vengano recuperati in questo repository. Sincronizza due fork esistenti. Per creare un fork, vedere il <un href="https://docs.microsoft.com/en-us/rest/api/vsts/git/repositories/create?view=azure-devops-rest-5.1" endpoint> repository</a>

createImportRequest(GitImportRequest, string, string)

Creare una richiesta di importazione.

createLike(string, number, number, number, string)

Aggiungere un like a un commento.

createMergeRequest(GitMergeParameters, string, string, boolean)

Richiedere un'operazione git merge. Attualmente è supportato l'unione di soli 2 commit.

createPullRequest(GitPullRequest, string, string, boolean)

Creare una richiesta pull.

createPullRequestIterationStatus(GitPullRequestStatus, string, number, number, string)

Creare uno stato della richiesta pull nell'iterazione. Questa operazione avrà lo stesso risultato di Create status on pull request with specified iteration ID nel corpo della richiesta.

createPullRequestLabel(WebApiCreateTagRequestData, string, number, string, string)

Creare un tag (se non esiste ancora) e aggiungerlo come etichetta (tag) per una richiesta pull specificata. L'unico campo obbligatorio è il nome della nuova etichetta (tag).

createPullRequestReviewer(IdentityRefWithVote, string, number, string, string)

Aggiungere un revisore a una richiesta pull o eseguire un voto.

createPullRequestReviewers(IdentityRef[], string, number, string)

Aggiungere revisori a una richiesta pull.

createPullRequestStatus(GitPullRequestStatus, string, number, string)

Creare uno stato della richiesta pull.

createPush(GitPush, string, string)

Eseguire il push delle modifiche nel repository.

createRepository(GitRepositoryCreateOptions, string, string)

Creare un repository Git in un progetto team.

createRevert(GitAsyncRefOperationParameters, string, string)

Avvia l'operazione per creare un nuovo ramo che ripristina le modifiche introdotte da un commit o commit specifici associati a una richiesta pull.

createThread(GitPullRequestCommentThread, string, number, string)

Creare un thread in una richiesta pull.

createUnmaterializedPullRequestReviewer(IdentityRefWithVote, string, number, string)

Aggiungere un'identità non materializzata ai revisori di una richiesta pull.

deleteAttachment(string, string, number, string)

Eliminare un allegato di richiesta pull.

deleteComment(string, number, number, number, string)

Eliminare un commento associato a un thread specifico in una richiesta pull.

deleteEnablementStatus(boolean, boolean, string[])

DELETE Elimina lo stato dell'abilitazione e i dati BillableCommitters dal database. L'eliminazione dei dati di abilitazione la disabilita in modo efficace per i repository interessati.

deleteLike(string, number, number, number, string)

Eliminare un like in un commento.

deletePullRequestIterationStatus(string, number, number, number, string)

Eliminare lo stato di iterazione della richiesta pull.

deletePullRequestLabels(string, number, string, string, string)

Rimuove un'etichetta (tag) dal set di quelli assegnati alla richiesta pull. Il tag stesso non verrà eliminato.

deletePullRequestReviewer(string, number, string, string)

Rimuovere un revisore da una richiesta pull.

deletePullRequestStatus(string, number, number, string)

Eliminare lo stato della richiesta pull.

deleteRefFavorite(string, number)

Elimina i riferimenti preferiti specificati

deleteRepository(string, string)

Eliminare un repository Git

deleteRepositoryFromRecycleBin(string, string)

Eliminare definitivamente (eliminare definitivamente) un repository Git eliminato temporaneo.

getAnnotatedTag(string, string, string)

Ottiene un tag con annotazioni.

getAttachmentContent(string, string, number, string)

Ottenere il contenuto del file di un allegato di richiesta pull.

getAttachments(string, number, string)

Ottenere un elenco di file allegati a una determinata richiesta pull.

getAttachmentZip(string, string, number, string)

Ottenere il contenuto del file di un allegato di richiesta pull.

getBillableCommitters(string, Date, number, number)

Recuperare i commit fatturabili effettivi per il servizio sicurezza avanzata per una determinata data.

getBillableCommittersDetail(string, string, Date)

Recuperare i commit fatturabili dettagliati per il servizio sicurezza avanzata per una determinata data. I risultati dettagliati non filtrano intenzionalmente i progetti eliminati temporaneamente e i repository per diagnosticare i problemi di fatturazione.

getBlob(string, string, string, boolean, string, boolean)

Ottenere un singolo BLOB.

getBlobContent(string, string, string, boolean, string, boolean)

Ottenere un singolo BLOB.

getBlobsZip(string[], string, string, string)

Ottiene uno o più BLOB in un download di file ZIP.

getBlobZip(string, string, string, boolean, string, boolean)

Ottenere un singolo BLOB.

getBranch(string, string, string, GitVersionDescriptor)

Recuperare le statistiche relative a un singolo ramo.

getBranches(string, string, GitVersionDescriptor)

Recuperare statistiche su tutti i rami all'interno di un repository.

getBranchStatsBatch(GitQueryBranchStatsCriteria, string, string)

Recuperare le statistiche per più commit

getChanges(string, string, string, number, number)

Recuperare le modifiche per un determinato commit.

getCherryPick(string, number, string)

Recuperare informazioni su un'operazione cherry pick in base all'ID selezione ciliegia.

getCherryPickConflict(string, number, number, string)

Recuperare un conflitto per una selezione ciliegia in base all'ID

getCherryPickConflicts(string, number, string, string, number, boolean, boolean, boolean)

Recuperare tutti i conflitti per una selezione ciliegia

getCherryPickForRefName(string, string, string)

Recuperare informazioni su un'operazione cherry pick per un ramo specifico. Questa operazione è costosa a causa della struttura di oggetti sottostante, quindi questa API esamina solo le 1000 operazioni di selezione ciliegie più recenti.

getCherryPickRelationships(string, string, string, boolean)

Dato un commitId, restituisce un elenco di commit che si trovano nella stessa famiglia cherry-pick.

getComment(string, number, number, number, string)

Recuperare un commento associato a un thread specifico in una richiesta pull.

getComments(string, number, number, string)

Recuperare tutti i commenti associati a un thread specifico in una richiesta pull.

getCommit(string, string, string, number)

Recuperare un determinato commit.

getCommitDiffs(string, string, boolean, number, number, GitBaseVersionDescriptor, GitTargetVersionDescriptor)

Trovare il commit più comune (la base di merge) tra i commit di base e di destinazione e ottenere la differenza tra i commit di base e di destinazione o i commit comuni e di destinazione.

getCommits(string, GitQueryCommitsCriteria, string)

Recuperare i commit Git per un progetto

getCommitsBatch(GitQueryCommitsCriteria, string, string, number, number, boolean)

Recuperare i commit Git per un progetto che corrisponde ai criteri di ricerca

getDeletedRepositories(string)

Recuperare i repository Git eliminati.

getEnablementStatus(string[], Date, number, number)

Stato di abilitazione GET per i repository del progetto.

getEnableOnCreateHost(boolean)
getEnableOnCreateProject(string)
getEstimatedBillableCommittersRepo(string, string)

Ottenere i commit fatturabili stimati per un repository per gli ultimi 90 giorni.

getEstimatedBillablePushersOrg()

Ottenere push fatturabili stimati per un'organizzazione per gli ultimi 90 giorni.

getEstimatedBillablePushersProject(string)

Ottenere i push fatturabili stimati per un progetto per gli ultimi 90 giorni.

getFileDiffs(FileDiffsCriteria, string, string)

Ottenere le differenze di file per ognuno dei file specificati

getForks(string, string, string, boolean)

Recuperare tutti i fork di un repository nella raccolta.

getForkSyncRequest(string, number, string, boolean)

Ottenere i dettagli di un'operazione di sincronizzazione fork specifica.

getForkSyncRequests(string, string, boolean, boolean)

Recuperare tutte le operazioni di sincronizzazione fork richieste in questo repository.

getHfsItem(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

getHfsItemContent(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

getHfsItems(string, string, string, VersionControlRecursionType, boolean, boolean, boolean, boolean, GitVersionDescriptor, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per una raccolta di elementi. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso che viene sempre restituito come download.

getHfsItemText(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

getHfsItemZip(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

getImportRequest(string, string, number)

Recuperare una determinata richiesta di importazione.

getItem(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

getItemContent(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

getItems(string, string, string, VersionControlRecursionType, boolean, boolean, boolean, boolean, GitVersionDescriptor, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per una raccolta di elementi. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso che viene sempre restituito come download.

getItemsBatch(GitItemRequestData, string, string)

Eseguire il post per il recupero di un batch da un set di elementi in un repository/progetto in base a un elenco di percorsi o a un percorso lungo

getItemText(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

getItemZip(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

getLikes(string, number, number, number, string)

Ottenere gli like per un commento.

getMergeBases(string, string, string, string, string, string)

Trovare le basi di merge di due commit, facoltativamente tra i fork. Se non viene specificato otherRepositoryId, le basi di merge verranno calcolate solo nel contesto del repository localeNameOrId.

getMergeRequest(string, string, number, boolean)

Ottenere i dettagli di un'operazione di unione specifica.

getPermission(string, string, string)

GET Advanced Security Permission status (Stato dell'autorizzazione di sicurezza avanzata).

getPullRequest(string, number, string, number, number, number, boolean, boolean)

Recuperare una richiesta pull.

getPullRequestById(number, string)

Recuperare una richiesta pull.

getPullRequestCommits(string, number, string)

Ottenere i commit per la richiesta pull specificata.

getPullRequestConflict(string, number, number, string)

Recuperare un conflitto per una richiesta pull in base all'ID

getPullRequestConflicts(string, number, string, number, number, boolean, boolean, boolean)

Recuperare tutti i conflitti per una richiesta pull

getPullRequestIteration(string, number, number, string)

Ottenere l'iterazione specificata per una richiesta pull.

getPullRequestIterationChanges(string, number, number, string, number, number, number)

Recuperare le modifiche apportate in una richiesta pull tra due iterazioni.

getPullRequestIterationCommits(string, number, number, string, number, number)

Ottenere i commit per l'iterazione specificata di una richiesta pull.

getPullRequestIterations(string, number, string, boolean)

Ottenere l'elenco di iterazioni per la richiesta pull specificata.

getPullRequestIterationStatus(string, number, number, number, string)

Ottenere lo stato di iterazione della richiesta pull specifico in base all'ID. L'ID di stato è univoco all'interno della richiesta pull in tutte le iterazioni.

getPullRequestIterationStatuses(string, number, number, string)

Ottiene tutti gli stati associati a un'iterazione della richiesta pull.

getPullRequestLabel(string, number, string, string, string)

Recupera una singola etichetta (tag) assegnata a una richiesta pull.

getPullRequestLabels(string, number, string, string)

Ottiene tutte le etichette (tag) assegnate a una richiesta pull.

getPullRequestProperties(string, number, string)

Ottiene proprietà esterne della richiesta pull.

getPullRequestQuery(GitPullRequestQuery, string, string)

Questa API viene usata per trovare le richieste pull correlate a un determinato commit. Può essere usato per trovare la richiesta pull che ha creato un commit di merge specifico oppure può essere usata per trovare tutte le richieste pull che hanno mai unito un determinato commit. L'input è un elenco di query che contengono un elenco di commit. Per ogni commit su cui si esegue la ricerca, si otterrà un dizionario di commit,> richieste pull.

getPullRequestReviewer(string, number, string, string)

Recuperare informazioni su un revisore specifico in una richiesta pull

getPullRequestReviewers(string, number, string)

Recuperare i revisori per una richiesta pull

getPullRequests(string, GitPullRequestSearchCriteria, string, number, number, number)

Recuperare tutte le richieste pull corrispondenti a un criterio specificato.

getPullRequestsByProject(string, GitPullRequestSearchCriteria, number, number, number)

Recuperare tutte le richieste pull corrispondenti a un criterio specificato.

getPullRequestStatus(string, number, number, string)

Ottenere lo stato specifico della richiesta pull in base all'ID. L'ID di stato è univoco all'interno della richiesta pull in tutte le iterazioni.

getPullRequestStatuses(string, number, string)

Ottenere tutti gli stati associati a una richiesta pull.

getPullRequestThread(string, number, number, string, number, number)

Recuperare un thread in una richiesta pull.

getPullRequestWorkItemRefs(string, number, string)

Recuperare un elenco di elementi di lavoro associati a una richiesta pull.

getPush(string, number, string, number, boolean)

Recupera un push specifico.

getPushCommits(string, number, string, number, number, boolean)

Recuperare un elenco di commit associati a un push specifico.

getPushes(string, string, number, number, GitPushSearchCriteria)

Recupera i push associati al repository specificato.

getRecycleBinRepositories(string)

Recuperare i repository Git eliminati soft dal Cestino.

getRefFavorite(string, number)

Ottiene i riferimenti preferiti per un ID preferito.

getRefFavorites(string, string, string)

Ottiene i preferiti dei riferimenti per un repository e un'identità.

getRefFavoritesForProject(string, string)
getRefs(string, string, string, boolean, boolean, boolean, boolean, boolean, string)

Esegue una query sul repository fornito per i relativi riferimenti e li restituisce.

getRepositories(string, boolean, boolean, boolean)

Recuperare i repository Git.

getRepositoriesPaged(string, boolean, boolean, boolean, string, number, string)

Recuperare i repository Git con il filtro in base al nome e alla paginazione.

getRepository(string, string)

Recuperare un repository Git.

getRepositoryWithParent(string, boolean, string)

Recuperare un repository Git.

getRevert(string, number, string)

Recuperare informazioni su un'operazione di ripristino ripristinando l'ID.

getRevertConflict(string, number, number, string)

Recuperare un conflitto per un ripristino in base all'ID

getRevertConflicts(string, number, string, string, number, boolean, boolean, boolean)

Recuperare tutti i conflitti per un ripristino

getRevertForRefName(string, string, string)

Recuperare informazioni su un'operazione di ripristino per un ramo specifico.

getStatuses(string, string, string, number, number, boolean)

Ottiene gli stati associati al commit Git.

getSuggestions(string, string, boolean)

Recuperare un suggerimento per una richiesta pull per un repository o un progetto team specifico.

getThreads(string, number, string, number, number)

Recuperare tutti i thread in una richiesta pull.

getTree(string, string, string, string, boolean, string)

L'endpoint Tree restituisce la raccolta di oggetti sotto l'albero specificato. Gli alberi sono cartelle in un repository Git.

getTreeZip(string, string, string, string, boolean, string)

L'endpoint Tree restituisce la raccolta di oggetti sotto l'albero specificato. Gli alberi sono cartelle in un repository Git.

queryImportRequests(string, string, boolean)

Recuperare le richieste di importazione per un repository.

restoreRepositoryFromRecycleBin(GitRecycleBinRepositoryDetails, string, string)

Ripristinare un repository Git eliminato temporaneo. I repository eliminati di recente passano a uno stato di eliminazione temporanea per un periodo di tempo prima che vengano eliminati definitivamente e diventino irreversibili.

setEnableOnCreateHost(boolean)
setEnableOnCreateProject(string, boolean)
sharePullRequest(ShareNotificationContext, string, number, string)

Invia una notifica tramite posta elettronica relativa a una richiesta pull specifica a un set di destinatari

updateCherryPickConflict(GitConflict, string, number, number, string)

Aggiornare la risoluzione dei conflitti di unione

updateCherryPickConflicts(GitConflict[], string, number, string)

Aggiornare più risoluzioni dei conflitti di merge

updateComment(Comment, string, number, number, number, string)

Aggiornare un commento associato a un thread specifico in una richiesta pull.

updateEnablementStatus(AdvSecEnablementUpdate[])

Stato di abilitazione POST per i repository.

updateImportRequest(GitImportRequest, string, string, number)

Riprovare o abbandonare una richiesta di importazione non riuscita.

updatePullRequest(GitPullRequest, string, number, string)

Aggiornare una richiesta pull

updatePullRequestConflict(GitConflict, string, number, number, string)

Aggiornare la risoluzione dei conflitti di unione

updatePullRequestConflicts(GitConflict[], string, number, string)

Aggiornare più risoluzioni dei conflitti di merge

updatePullRequestIterationStatuses(JsonPatchDocument, string, number, number, string)

Aggiornare la raccolta di stati di iterazione delle richieste pull. L'unico tipo di operazione supportato è remove.

updatePullRequestProperties(JsonPatchDocument, string, number, string)

Creare o aggiornare le proprietà esterne della richiesta pull. L'operazione di patch può essere add, replace o remove. Per add'operazione, il percorso può essere vuoto. Se il percorso è vuoto, il valore deve essere un elenco di coppie chiave-valore. Per replace'operazione, il percorso non può essere vuoto. Se il percorso non esiste, la proprietà verrà aggiunta all'insieme. Per remove'operazione, il percorso non può essere vuoto. Se il percorso non esiste, non verrà eseguita alcuna azione.

updatePullRequestReviewer(IdentityRefWithVote, string, number, string, string)

Modificare una voce del revisore. Questi campi sono patchable: isFlagged, hasDeclined

updatePullRequestReviewers(IdentityRefWithVote[], string, number, string)

Reimpostare i voti di più revisori in una richiesta pull. NOTA: questo endpoint supporta solo l'aggiornamento dei voti, ma non supporta l'aggiornamento dei revisori necessari (usare i criteri) o i nomi visualizzati.

updatePullRequestStatuses(JsonPatchDocument, string, number, string)

Aggiornare la raccolta di stati delle richieste pull. L'unico tipo di operazione supportato è remove.

updateRef(GitRefUpdate, string, string, string, string)

Bloccare o sbloccare un ramo.

updateRefs(GitRefUpdate[], string, string, string)

Creazione, aggiornamento o eliminazione di refs(rami).

updateRepository(GitRepository, string, string)

Aggiorna il repository Git con un nuovo nome di repository o un nuovo ramo predefinito.

updateRevertConflict(GitConflict, string, number, number, string)

Aggiornare la risoluzione dei conflitti di unione

updateRevertConflicts(GitConflict[], string, number, string)

Aggiornare più risoluzioni dei conflitti di merge

updateThread(GitPullRequestCommentThread, string, number, number, string)

Aggiornare un thread in una richiesta pull.

Dettagli costruttore

GitRestClient(IVssRestClientOptions)

new GitRestClient(options: IVssRestClientOptions)

Parametri

Dettagli proprietà

RESOURCE_AREA_ID

static RESOURCE_AREA_ID: string

Valore della proprietà

string

Dettagli metodo

createAnnotatedTag(GitAnnotatedTag, string, string)

Creare un tag con annotazioni.

function createAnnotatedTag(tagObject: GitAnnotatedTag, project: string, repositoryId: string): Promise<GitAnnotatedTag>

Parametri

tagObject
GitAnnotatedTag

Oggetto contenente i dettagli del tag da creare.

project

string

ID progetto o nome progetto

repositoryId

string

ID o nome del repository.

Restituisce

Promise<GitAnnotatedTag>

createAttachment(any, string, string, number, string)

Allegare un nuovo file a una richiesta pull.

function createAttachment(content: any, fileName: string, repositoryId: string, pullRequestId: number, project?: string): Promise<Attachment>

Parametri

content

any

Contenuto da caricare

fileName

string

Nome del file.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<Attachment>

createCherryPick(GitAsyncRefOperationParameters, string, string)

Cherry seleziona un commit o commit specifici associati a una richiesta pull in un nuovo ramo.

function createCherryPick(cherryPickToCreate: GitAsyncRefOperationParameters, project: string, repositoryId: string): Promise<GitCherryPick>

Parametri

cherryPickToCreate
GitAsyncRefOperationParameters
project

string

ID progetto o nome progetto

repositoryId

string

ID del repository.

Restituisce

Promise<GitCherryPick>

createComment(Comment, string, number, number, string)

Creare un commento su un thread specifico in una richiesta pull (è possibile creare fino a 500 commenti per thread).

function createComment(comment: Comment, repositoryId: string, pullRequestId: number, threadId: number, project?: string): Promise<Comment>

Parametri

comment
Comment

Commento da creare. I commenti possono contenere fino a 150.000 caratteri.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

threadId

number

ID del thread in cui si trova il commento desiderato.

project

string

ID progetto o nome progetto

Restituisce

Promise<Comment>

createCommitStatus(GitStatus, string, string, string)

Creare lo stato del commit Git.

function createCommitStatus(gitCommitStatusToCreate: GitStatus, commitId: string, repositoryId: string, project?: string): Promise<GitStatus>

Parametri

gitCommitStatusToCreate
GitStatus

Oggetto stato del commit Git da creare.

commitId

string

ID del commit Git.

repositoryId

string

ID del repository.

project

string

ID progetto o nome progetto

Restituisce

Promise<GitStatus>

createFavorite(GitRefFavorite, string)

Crea un riferimento preferito

function createFavorite(favorite: GitRefFavorite, project: string): Promise<GitRefFavorite>

Parametri

favorite
GitRefFavorite

Riferimento preferito da creare.

project

string

ID progetto o nome progetto

Restituisce

Promise<GitRefFavorite>

createForkSyncRequest(GitForkSyncRequestParameters, string, string, boolean)

Richiedere che i riferimenti di un altro repository vengano recuperati in questo repository. Sincronizza due fork esistenti. Per creare un fork, vedere il <un href="https://docs.microsoft.com/en-us/rest/api/vsts/git/repositories/create?view=azure-devops-rest-5.1" endpoint> repository</a>

function createForkSyncRequest(syncParams: GitForkSyncRequestParameters, repositoryNameOrId: string, project?: string, includeLinks?: boolean): Promise<GitForkSyncRequest>

Parametri

syncParams
GitForkSyncRequestParameters

Repository di origine e mapping dei riferimenti.

repositoryNameOrId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

includeLinks

boolean

True per includere i collegamenti

Restituisce

createImportRequest(GitImportRequest, string, string)

Creare una richiesta di importazione.

function createImportRequest(importRequest: GitImportRequest, project: string, repositoryId: string): Promise<GitImportRequest>

Parametri

importRequest
GitImportRequest

Richiesta di importazione da creare.

project

string

ID progetto o nome progetto

repositoryId

string

Nome o ID del repository.

Restituisce

Promise<GitImportRequest>

createLike(string, number, number, number, string)

Aggiungere un like a un commento.

function createLike(repositoryId: string, pullRequestId: number, threadId: number, commentId: number, project?: string): Promise<void>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

threadId

number

ID del thread che contiene il commento.

commentId

number

ID del commento.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

createMergeRequest(GitMergeParameters, string, string, boolean)

Richiedere un'operazione git merge. Attualmente è supportato l'unione di soli 2 commit.

function createMergeRequest(mergeParameters: GitMergeParameters, project: string, repositoryNameOrId: string, includeLinks?: boolean): Promise<GitMerge>

Parametri

mergeParameters
GitMergeParameters

CommitId padre e merge commit messsage.

project

string

ID progetto o nome progetto

repositoryNameOrId

string

Nome o ID del repository.

includeLinks

boolean

True per includere i collegamenti

Restituisce

Promise<GitMerge>

createPullRequest(GitPullRequest, string, string, boolean)

Creare una richiesta pull.

function createPullRequest(gitPullRequestToCreate: GitPullRequest, repositoryId: string, project?: string, supportsIterations?: boolean): Promise<GitPullRequest>

Parametri

gitPullRequestToCreate
GitPullRequest

Richiesta pull da creare.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

project

string

ID progetto o nome progetto

supportsIterations

boolean

Se true, i push successivi alla richiesta pull saranno verificabili singolarmente. Impostare questo valore su false per le richieste pull di grandi dimensioni per motivi di prestazioni se questa funzionalità non è necessaria.

Restituisce

Promise<GitPullRequest>

createPullRequestIterationStatus(GitPullRequestStatus, string, number, number, string)

Creare uno stato della richiesta pull nell'iterazione. Questa operazione avrà lo stesso risultato di Create status on pull request with specified iteration ID nel corpo della richiesta.

function createPullRequestIterationStatus(status: GitPullRequestStatus, repositoryId: string, pullRequestId: number, iterationId: number, project?: string): Promise<GitPullRequestStatus>

Parametri

status
GitPullRequestStatus

Stato della richiesta pull da creare.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

iterationId

number

ID dell'iterazione della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

createPullRequestLabel(WebApiCreateTagRequestData, string, number, string, string)

Creare un tag (se non esiste ancora) e aggiungerlo come etichetta (tag) per una richiesta pull specificata. L'unico campo obbligatorio è il nome della nuova etichetta (tag).

function createPullRequestLabel(label: WebApiCreateTagRequestData, repositoryId: string, pullRequestId: number, project?: string, projectId?: string): Promise<WebApiTagDefinition>

Parametri

label
WebApiCreateTagRequestData

Etichetta da assegnare alla richiesta pull.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

projectId

string

ID progetto o nome del progetto.

Restituisce

createPullRequestReviewer(IdentityRefWithVote, string, number, string, string)

Aggiungere un revisore a una richiesta pull o eseguire un voto.

function createPullRequestReviewer(reviewer: IdentityRefWithVote, repositoryId: string, pullRequestId: number, reviewerId: string, project?: string): Promise<IdentityRefWithVote>

Parametri

reviewer
IdentityRefWithVote

Voto del revisore.<br/>Se l'ID del revisore è incluso qui, deve corrispondere al parametro reviewerID.<br/>Revisori possono impostare il proprio voto con questo metodo. Quando si aggiungono altri revisori, il voto deve essere impostato su zero.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

reviewerId

string

ID del revisore.

project

string

ID progetto o nome progetto

Restituisce

createPullRequestReviewers(IdentityRef[], string, number, string)

Aggiungere revisori a una richiesta pull.

function createPullRequestReviewers(reviewers: IdentityRef[], repositoryId: string, pullRequestId: number, project?: string): Promise<IdentityRefWithVote[]>

Parametri

reviewers

IdentityRef[]

Revisori da aggiungere alla richiesta pull.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<IdentityRefWithVote[]>

createPullRequestStatus(GitPullRequestStatus, string, number, string)

Creare uno stato della richiesta pull.

function createPullRequestStatus(status: GitPullRequestStatus, repositoryId: string, pullRequestId: number, project?: string): Promise<GitPullRequestStatus>

Parametri

status
GitPullRequestStatus

Stato della richiesta pull da creare.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

createPush(GitPush, string, string)

Eseguire il push delle modifiche nel repository.

function createPush(push: GitPush, repositoryId: string, project?: string): Promise<GitPush>

Parametri

push
GitPush
repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

Restituisce

Promise<GitPush>

createRepository(GitRepositoryCreateOptions, string, string)

Creare un repository Git in un progetto team.

function createRepository(gitRepositoryToCreate: GitRepositoryCreateOptions, project?: string, sourceRef?: string): Promise<GitRepository>

Parametri

gitRepositoryToCreate
GitRepositoryCreateOptions

Specificare il nome del repository, il progetto team e/o il repository padre. Le informazioni sul progetto team possono essere omesse da gitRepositoryToCreate se la richiesta è con ambito progetto (ad esempio, include l'ID progetto).

project

string

ID progetto o nome progetto

sourceRef

string

[facoltativo] Specificare i riferimenti di origine da usare durante la creazione di un repository fork

Restituisce

Promise<GitRepository>

createRevert(GitAsyncRefOperationParameters, string, string)

Avvia l'operazione per creare un nuovo ramo che ripristina le modifiche introdotte da un commit o commit specifici associati a una richiesta pull.

function createRevert(revertToCreate: GitAsyncRefOperationParameters, project: string, repositoryId: string): Promise<GitRevert>

Parametri

project

string

ID progetto o nome progetto

repositoryId

string

ID del repository.

Restituisce

Promise<GitRevert>

createThread(GitPullRequestCommentThread, string, number, string)

Creare un thread in una richiesta pull.

function createThread(commentThread: GitPullRequestCommentThread, repositoryId: string, pullRequestId: number, project?: string): Promise<GitPullRequestCommentThread>

Parametri

commentThread
GitPullRequestCommentThread

Thread da creare. Il thread deve contenere almeno un commento.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

createUnmaterializedPullRequestReviewer(IdentityRefWithVote, string, number, string)

Aggiungere un'identità non materializzata ai revisori di una richiesta pull.

function createUnmaterializedPullRequestReviewer(reviewer: IdentityRefWithVote, repositoryId: string, pullRequestId: number, project?: string): Promise<IdentityRefWithVote>

Parametri

reviewer
IdentityRefWithVote

Revisore da aggiungere alla richiesta pull.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

deleteAttachment(string, string, number, string)

Eliminare un allegato di richiesta pull.

function deleteAttachment(fileName: string, repositoryId: string, pullRequestId: number, project?: string): Promise<void>

Parametri

fileName

string

Nome dell'allegato da eliminare.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

deleteComment(string, number, number, number, string)

Eliminare un commento associato a un thread specifico in una richiesta pull.

function deleteComment(repositoryId: string, pullRequestId: number, threadId: number, commentId: number, project?: string): Promise<void>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

threadId

number

ID del thread in cui si trova il commento desiderato.

commentId

number

ID del commento.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

deleteEnablementStatus(boolean, boolean, string[])

DELETE Elimina lo stato dell'abilitazione e i dati BillableCommitters dal database. L'eliminazione dei dati di abilitazione la disabilita in modo efficace per i repository interessati.

function deleteEnablementStatus(allProjects: boolean, includeBillableCommitters?: boolean, projectIds?: string[]): Promise<void>

Parametri

allProjects

boolean

includeBillableCommitters

boolean

projectIds

string[]

Restituisce

Promise<void>

deleteLike(string, number, number, number, string)

Eliminare un like in un commento.

function deleteLike(repositoryId: string, pullRequestId: number, threadId: number, commentId: number, project?: string): Promise<void>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

threadId

number

ID del thread che contiene il commento.

commentId

number

ID del commento.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

deletePullRequestIterationStatus(string, number, number, number, string)

Eliminare lo stato di iterazione della richiesta pull.

function deletePullRequestIterationStatus(repositoryId: string, pullRequestId: number, iterationId: number, statusId: number, project?: string): Promise<void>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

iterationId

number

ID dell'iterazione della richiesta pull.

statusId

number

ID dello stato della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

deletePullRequestLabels(string, number, string, string, string)

Rimuove un'etichetta (tag) dal set di quelli assegnati alla richiesta pull. Il tag stesso non verrà eliminato.

function deletePullRequestLabels(repositoryId: string, pullRequestId: number, labelIdOrName: string, project?: string, projectId?: string): Promise<void>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

labelIdOrName

string

Nome o ID dell'etichetta richiesta.

project

string

ID progetto o nome progetto

projectId

string

ID progetto o nome del progetto.

Restituisce

Promise<void>

deletePullRequestReviewer(string, number, string, string)

Rimuovere un revisore da una richiesta pull.

function deletePullRequestReviewer(repositoryId: string, pullRequestId: number, reviewerId: string, project?: string): Promise<void>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

reviewerId

string

ID del revisore da rimuovere.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

deletePullRequestStatus(string, number, number, string)

Eliminare lo stato della richiesta pull.

function deletePullRequestStatus(repositoryId: string, pullRequestId: number, statusId: number, project?: string): Promise<void>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

statusId

number

ID dello stato della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

deleteRefFavorite(string, number)

Elimina i riferimenti preferiti specificati

function deleteRefFavorite(project: string, favoriteId: number): Promise<void>

Parametri

project

string

ID progetto o nome progetto

favoriteId

number

ID del ref preferito da eliminare.

Restituisce

Promise<void>

deleteRepository(string, string)

Eliminare un repository Git

function deleteRepository(repositoryId: string, project?: string): Promise<void>

Parametri

repositoryId

string

ID del repository.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

deleteRepositoryFromRecycleBin(string, string)

Eliminare definitivamente (eliminare definitivamente) un repository Git eliminato temporaneo.

function deleteRepositoryFromRecycleBin(project: string, repositoryId: string): Promise<void>

Parametri

project

string

ID progetto o nome progetto

repositoryId

string

ID del repository.

Restituisce

Promise<void>

getAnnotatedTag(string, string, string)

Ottiene un tag con annotazioni.

function getAnnotatedTag(project: string, repositoryId: string, objectId: string): Promise<GitAnnotatedTag>

Parametri

project

string

ID progetto o nome progetto

repositoryId

string

ID o nome del repository.

objectId

string

ObjectId (Sha1Id) del tag da ottenere.

Restituisce

Promise<GitAnnotatedTag>

getAttachmentContent(string, string, number, string)

Ottenere il contenuto del file di un allegato di richiesta pull.

function getAttachmentContent(fileName: string, repositoryId: string, pullRequestId: number, project?: string): Promise<ArrayBuffer>

Parametri

fileName

string

Nome dell'allegato.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<ArrayBuffer>

getAttachments(string, number, string)

Ottenere un elenco di file allegati a una determinata richiesta pull.

function getAttachments(repositoryId: string, pullRequestId: number, project?: string): Promise<Attachment[]>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<Attachment[]>

getAttachmentZip(string, string, number, string)

Ottenere il contenuto del file di un allegato di richiesta pull.

function getAttachmentZip(fileName: string, repositoryId: string, pullRequestId: number, project?: string): Promise<ArrayBuffer>

Parametri

fileName

string

Nome dell'allegato.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<ArrayBuffer>

getBillableCommitters(string, Date, number, number)

Recuperare i commit fatturabili effettivi per il servizio sicurezza avanzata per una determinata data.

function getBillableCommitters(project: string, billingDate?: Date, skip?: number, take?: number): Promise<BillableCommitter[]>

Parametri

project

string

ID progetto o nome progetto

billingDate

Date

Previsto utc. Se non specificato, il valore predefinito è il giorno di fatturazione precedente.

skip

number

Ignorare le X righe del set di risultati per simulare il paging.

take

number

Restituisce righe Y del set di risultati per simulare il paging.

Restituisce

Promise<BillableCommitter[]>

getBillableCommittersDetail(string, string, Date)

Recuperare i commit fatturabili dettagliati per il servizio sicurezza avanzata per una determinata data. I risultati dettagliati non filtrano intenzionalmente i progetti eliminati temporaneamente e i repository per diagnosticare i problemi di fatturazione.

function getBillableCommittersDetail(project: string, includeDetails: string, billingDate?: Date): Promise<BillableCommitterDetail[]>

Parametri

project

string

ID progetto o nome progetto

includeDetails

string

Restituisce tutti i dettagli sui commit fatturabili.

billingDate

Date

Previsto utc. Se non specificato, il valore predefinito è il giorno di fatturazione precedente.

Restituisce

getBlob(string, string, string, boolean, string, boolean)

Ottenere un singolo BLOB.

function getBlob(repositoryId: string, sha1: string, project?: string, download?: boolean, fileName?: string, resolveLfs?: boolean): Promise<GitBlobRef>

Parametri

repositoryId

string

Nome o ID del repository.

sha1

string

Hash SHA1 del file. È possibile ottenere SHA1 di un file usando l'endpoint "Git/Items/Get Item".

project

string

ID progetto o nome progetto

download

boolean

Se true, richiedere un download anziché eseguire il rendering in un browser. Nota: il valore predefinito è true se $format è zip

fileName

string

Specificare un fileName da usare per un download.

resolveLfs

boolean

Se true, provare a risolvere un BLOB nel relativo contenuto LFS, se si tratta di un file di puntatore LFS. Compatibile solo con le intestazioni di tipo octet-stream Accept o $format

Restituisce

Promise<GitBlobRef>

getBlobContent(string, string, string, boolean, string, boolean)

Ottenere un singolo BLOB.

function getBlobContent(repositoryId: string, sha1: string, project?: string, download?: boolean, fileName?: string, resolveLfs?: boolean): Promise<ArrayBuffer>

Parametri

repositoryId

string

Nome o ID del repository.

sha1

string

Hash SHA1 del file. È possibile ottenere SHA1 di un file usando l'endpoint "Git/Items/Get Item".

project

string

ID progetto o nome progetto

download

boolean

Se true, richiedere un download anziché eseguire il rendering in un browser. Nota: il valore predefinito è true se $format è zip

fileName

string

Specificare un fileName da usare per un download.

resolveLfs

boolean

Se true, provare a risolvere un BLOB nel relativo contenuto LFS, se si tratta di un file di puntatore LFS. Compatibile solo con le intestazioni di tipo octet-stream Accept o $format

Restituisce

Promise<ArrayBuffer>

getBlobsZip(string[], string, string, string)

Ottiene uno o più BLOB in un download di file ZIP.

function getBlobsZip(blobIds: string[], repositoryId: string, project?: string, filename?: string): Promise<ArrayBuffer>

Parametri

blobIds

string[]

ID BLOB (hash SHA1) da restituire nel file ZIP.

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

filename

string

Restituisce

Promise<ArrayBuffer>

getBlobZip(string, string, string, boolean, string, boolean)

Ottenere un singolo BLOB.

function getBlobZip(repositoryId: string, sha1: string, project?: string, download?: boolean, fileName?: string, resolveLfs?: boolean): Promise<ArrayBuffer>

Parametri

repositoryId

string

Nome o ID del repository.

sha1

string

Hash SHA1 del file. È possibile ottenere SHA1 di un file usando l'endpoint "Git/Items/Get Item".

project

string

ID progetto o nome progetto

download

boolean

Se true, richiedere un download anziché eseguire il rendering in un browser. Nota: il valore predefinito è true se $format è zip

fileName

string

Specificare un fileName da usare per un download.

resolveLfs

boolean

Se true, provare a risolvere un BLOB nel relativo contenuto LFS, se si tratta di un file di puntatore LFS. Compatibile solo con le intestazioni di tipo octet-stream Accept o $format

Restituisce

Promise<ArrayBuffer>

getBranch(string, string, string, GitVersionDescriptor)

Recuperare le statistiche relative a un singolo ramo.

function getBranch(repositoryId: string, name: string, project?: string, baseVersionDescriptor?: GitVersionDescriptor): Promise<GitBranchStats>

Parametri

repositoryId

string

Nome o ID del repository.

name

string

Nome del ramo.

project

string

ID progetto o nome progetto

baseVersionDescriptor
GitVersionDescriptor

Identifica il commit o il ramo da usare come base.

Restituisce

Promise<GitBranchStats>

getBranches(string, string, GitVersionDescriptor)

Recuperare statistiche su tutti i rami all'interno di un repository.

function getBranches(repositoryId: string, project?: string, baseVersionDescriptor?: GitVersionDescriptor): Promise<GitBranchStats[]>

Parametri

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

baseVersionDescriptor
GitVersionDescriptor

Identifica il commit o il ramo da usare come base.

Restituisce

Promise<GitBranchStats[]>

getBranchStatsBatch(GitQueryBranchStatsCriteria, string, string)

Recuperare le statistiche per più commit

function getBranchStatsBatch(searchCriteria: GitQueryBranchStatsCriteria, repositoryId: string, project?: string): Promise<GitBranchStats[]>

Parametri

searchCriteria
GitQueryBranchStatsCriteria

Commit di base e elenco di commit di destinazione da confrontare.

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

Restituisce

Promise<GitBranchStats[]>

getChanges(string, string, string, number, number)

Recuperare le modifiche per un determinato commit.

function getChanges(commitId: string, repositoryId: string, project?: string, top?: number, skip?: number): Promise<GitCommitChanges>

Parametri

commitId

string

ID del commit.

repositoryId

string

ID o nome descrittivo del repository. Per usare il nome descrittivo, è necessario specificare anche projectId.

project

string

ID progetto o nome progetto

top

number

Numero massimo di modifiche da restituire.

skip

number

Numero di modifiche da ignorare.

Restituisce

Promise<GitCommitChanges>

getCherryPick(string, number, string)

Recuperare informazioni su un'operazione cherry pick in base all'ID selezione ciliegia.

function getCherryPick(project: string, cherryPickId: number, repositoryId: string): Promise<GitCherryPick>

Parametri

project

string

ID progetto o nome progetto

cherryPickId

number

ID della selezione ciliegia.

repositoryId

string

ID del repository.

Restituisce

Promise<GitCherryPick>

getCherryPickConflict(string, number, number, string)

Recuperare un conflitto per una selezione ciliegia in base all'ID

function getCherryPickConflict(repositoryId: string, cherryPickId: number, conflictId: number, project?: string): Promise<GitConflict>

Parametri

repositoryId

string

cherryPickId

number

conflictId

number

project

string

ID progetto o nome progetto

Restituisce

Promise<GitConflict>

getCherryPickConflicts(string, number, string, string, number, boolean, boolean, boolean)

Recuperare tutti i conflitti per una selezione ciliegia

function getCherryPickConflicts(repositoryId: string, cherryPickId: number, project?: string, continuationToken?: string, top?: number, excludeResolved?: boolean, onlyResolved?: boolean, includeObsolete?: boolean): Promise<PagedList<GitConflict>>

Parametri

repositoryId

string

cherryPickId

number

project

string

ID progetto o nome progetto

continuationToken

string

top

number

excludeResolved

boolean

onlyResolved

boolean

includeObsolete

boolean

Restituisce

getCherryPickForRefName(string, string, string)

Recuperare informazioni su un'operazione cherry pick per un ramo specifico. Questa operazione è costosa a causa della struttura di oggetti sottostante, quindi questa API esamina solo le 1000 operazioni di selezione ciliegie più recenti.

function getCherryPickForRefName(project: string, repositoryId: string, refName: string): Promise<GitCherryPick>

Parametri

project

string

ID progetto o nome progetto

repositoryId

string

ID del repository.

refName

string

GitAsyncRefOperationParameters generatedRefName usato per l'operazione cherry pick.

Restituisce

Promise<GitCherryPick>

getCherryPickRelationships(string, string, string, boolean)

Dato un commitId, restituisce un elenco di commit che si trovano nella stessa famiglia cherry-pick.

function getCherryPickRelationships(repositoryNameOrId: string, commitId: string, project?: string, includeLinks?: boolean): Promise<GitCommitRef[]>

Parametri

repositoryNameOrId

string

commitId

string

project

string

ID progetto o nome progetto

includeLinks

boolean

Restituisce

Promise<GitCommitRef[]>

getComment(string, number, number, number, string)

Recuperare un commento associato a un thread specifico in una richiesta pull.

function getComment(repositoryId: string, pullRequestId: number, threadId: number, commentId: number, project?: string): Promise<Comment>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

threadId

number

ID del thread in cui si trova il commento desiderato.

commentId

number

ID del commento.

project

string

ID progetto o nome progetto

Restituisce

Promise<Comment>

getComments(string, number, number, string)

Recuperare tutti i commenti associati a un thread specifico in una richiesta pull.

function getComments(repositoryId: string, pullRequestId: number, threadId: number, project?: string): Promise<Comment[]>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

threadId

number

ID del thread.

project

string

ID progetto o nome progetto

Restituisce

Promise<Comment[]>

getCommit(string, string, string, number)

Recuperare un determinato commit.

function getCommit(commitId: string, repositoryId: string, project?: string, changeCount?: number): Promise<GitCommit>

Parametri

commitId

string

ID del commit.

repositoryId

string

ID o nome descrittivo del repository. Per usare il nome descrittivo, è necessario specificare anche projectId.

project

string

ID progetto o nome progetto

changeCount

number

Numero di modifiche da includere nel risultato.

Restituisce

Promise<GitCommit>

getCommitDiffs(string, string, boolean, number, number, GitBaseVersionDescriptor, GitTargetVersionDescriptor)

Trovare il commit più comune (la base di merge) tra i commit di base e di destinazione e ottenere la differenza tra i commit di base e di destinazione o i commit comuni e di destinazione.

function getCommitDiffs(repositoryId: string, project?: string, diffCommonCommit?: boolean, top?: number, skip?: number, baseVersionDescriptor?: GitBaseVersionDescriptor, targetVersionDescriptor?: GitTargetVersionDescriptor): Promise<GitCommitDiffs>

Parametri

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

diffCommonCommit

boolean

Se true, diff tra commit comuni e di destinazione. Se false, diff tra commit di base e di destinazione.

top

number

Numero massimo di modifiche da restituire. Il valore predefinito è 100.

skip

number

Numero di modifiche da ignorare

baseVersionDescriptor
GitBaseVersionDescriptor

Descrittore per il commit di base.

targetVersionDescriptor
GitTargetVersionDescriptor

Descrittore per il commit di destinazione.

Restituisce

Promise<GitCommitDiffs>

getCommits(string, GitQueryCommitsCriteria, string)

Recuperare i commit Git per un progetto

function getCommits(repositoryId: string, searchCriteria: GitQueryCommitsCriteria, project?: string): Promise<GitCommitRef[]>

Parametri

repositoryId

string

ID o nome descrittivo del repository. Per usare il nome descrittivo, è necessario specificare anche projectId.

searchCriteria
GitQueryCommitsCriteria
project

string

ID progetto o nome progetto

Restituisce

Promise<GitCommitRef[]>

getCommitsBatch(GitQueryCommitsCriteria, string, string, number, number, boolean)

Recuperare i commit Git per un progetto che corrisponde ai criteri di ricerca

function getCommitsBatch(searchCriteria: GitQueryCommitsCriteria, repositoryId: string, project?: string, skip?: number, top?: number, includeStatuses?: boolean): Promise<GitCommitRef[]>

Parametri

searchCriteria
GitQueryCommitsCriteria

Opzioni di ricerca

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

skip

number

Numero di commit da ignorare. Il valore non può superare 3.000.000.

top

number

Numero massimo di commit da restituire. Il valore non può superare 50.000.

includeStatuses

boolean

True per includere informazioni aggiuntive sullo stato del commit.

Restituisce

Promise<GitCommitRef[]>

getDeletedRepositories(string)

Recuperare i repository Git eliminati.

function getDeletedRepositories(project: string): Promise<GitDeletedRepository[]>

Parametri

project

string

ID progetto o nome progetto

Restituisce

getEnablementStatus(string[], Date, number, number)

Stato di abilitazione GET per i repository del progetto.

function getEnablementStatus(projectIds?: string[], billingDate?: Date, skip?: number, take?: number): Promise<AdvSecEnablementStatus[]>

Parametri

projectIds

string[]

Per impostazione predefinita, Null viene impostato su tutti i progetti nell'host, elenco dello stato dei repository del progetto da restituire

billingDate

Date

Previsto UTC. Il valore predefinito Null è UtcNow(), può essere fornito per uno stato temporizzato

skip

number

Ignorare le X righe del set di risultati per simulare il paging.

take

number

Restituisce righe Y del set di risultati per simulare il paging.

Restituisce

getEnableOnCreateHost(boolean)

function getEnableOnCreateHost(enableOnCreateHost: boolean): Promise<boolean>

Parametri

enableOnCreateHost

boolean

Restituisce

Promise<boolean>

getEnableOnCreateProject(string)

function getEnableOnCreateProject(enableOnCreateProjectId: string): Promise<boolean>

Parametri

enableOnCreateProjectId

string

Restituisce

Promise<boolean>

getEstimatedBillableCommittersRepo(string, string)

Ottenere i commit fatturabili stimati per un repository per gli ultimi 90 giorni.

function getEstimatedBillableCommittersRepo(project: string, repositoryId: string): Promise<BillableCommitter[]>

Parametri

project

string

ID progetto o nome progetto

repositoryId

string

Restituisce

Promise<BillableCommitter[]>

getEstimatedBillablePushersOrg()

Ottenere push fatturabili stimati per un'organizzazione per gli ultimi 90 giorni.

function getEstimatedBillablePushersOrg(): Promise<BillablePusher[]>

Restituisce

Promise<BillablePusher[]>

getEstimatedBillablePushersProject(string)

Ottenere i push fatturabili stimati per un progetto per gli ultimi 90 giorni.

function getEstimatedBillablePushersProject(project: string): Promise<BillablePusher[]>

Parametri

project

string

ID progetto o nome progetto

Restituisce

Promise<BillablePusher[]>

getFileDiffs(FileDiffsCriteria, string, string)

Ottenere le differenze di file per ognuno dei file specificati

function getFileDiffs(fileDiffsCriteria: FileDiffsCriteria, project: string, repositoryId: string): Promise<FileDiff[]>

Parametri

fileDiffsCriteria
FileDiffsCriteria

Elenco di oggetti parametri di file

project

string

ID progetto o nome progetto

repositoryId

string

Nome o ID del repository

Restituisce

Promise<FileDiff[]>

getForks(string, string, string, boolean)

Recuperare tutti i fork di un repository nella raccolta.

function getForks(repositoryNameOrId: string, collectionId: string, project?: string, includeLinks?: boolean): Promise<GitRepositoryRef[]>

Parametri

repositoryNameOrId

string

Nome o ID del repository.

collectionId

string

ID raccolta progetto team.

project

string

ID progetto o nome progetto

includeLinks

boolean

True per includere i collegamenti.

Restituisce

Promise<GitRepositoryRef[]>

getForkSyncRequest(string, number, string, boolean)

Ottenere i dettagli di un'operazione di sincronizzazione fork specifica.

function getForkSyncRequest(repositoryNameOrId: string, forkSyncOperationId: number, project?: string, includeLinks?: boolean): Promise<GitForkSyncRequest>

Parametri

repositoryNameOrId

string

Nome o ID del repository.

forkSyncOperationId

number

OperationId della richiesta di sincronizzazione.

project

string

ID progetto o nome progetto

includeLinks

boolean

True per includere i collegamenti.

Restituisce

getForkSyncRequests(string, string, boolean, boolean)

Recuperare tutte le operazioni di sincronizzazione fork richieste in questo repository.

function getForkSyncRequests(repositoryNameOrId: string, project?: string, includeAbandoned?: boolean, includeLinks?: boolean): Promise<GitForkSyncRequest[]>

Parametri

repositoryNameOrId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

includeAbandoned

boolean

True per includere le richieste abbandonate.

includeLinks

boolean

True per includere i collegamenti.

Restituisce

Promise<GitForkSyncRequest[]>

getHfsItem(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

function getHfsItem(repositoryId: string, path: string, project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeContentMetadata?: boolean, latestProcessedChange?: boolean, download?: boolean, versionDescriptor?: GitVersionDescriptor, includeContent?: boolean, resolveHfs?: boolean, sanitize?: boolean): Promise<GitItem>

Parametri

repositoryId

string

Nome o ID del repository.

path

string

Percorso dell'elemento.

project

string

ID progetto o nome progetto

scopePath

string

Ambito del percorso. Il valore predefinito è Null.

recursionLevel
VersionControlRecursionType

Livello di ricorsione di questa richiesta. Il valore predefinito è 'none', nessuna ricorsione.

includeContentMetadata

boolean

Impostare su true per includere i metadati del contenuto. Il valore predefinito è false.

latestProcessedChange

boolean

Impostare su true per includere le modifiche più recenti. Il valore predefinito è false.

download

boolean

Impostare su true per scaricare la risposta come file. Il valore predefinito è false.

versionDescriptor
GitVersionDescriptor

Descrittore di versione. Il valore predefinito è il ramo predefinito per il repository.

includeContent

boolean

Impostare su true per includere il contenuto dell'elemento quando si richiede json. Il valore predefinito è false.

resolveHfs

boolean

Impostare su true per risolvere i file del puntatore GIT HFS per restituire il contenuto effettivo da Git HFS. Il valore predefinito è true.

sanitize

boolean

Impostare su true per purificare un file svg e restituirlo come immagine. Utile solo se richiesto per il file svg. Il valore predefinito è false.

Restituisce

Promise<GitItem>

getHfsItemContent(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

function getHfsItemContent(repositoryId: string, path: string, project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeContentMetadata?: boolean, latestProcessedChange?: boolean, download?: boolean, versionDescriptor?: GitVersionDescriptor, includeContent?: boolean, resolveHfs?: boolean, sanitize?: boolean): Promise<ArrayBuffer>

Parametri

repositoryId

string

Nome o ID del repository.

path

string

Percorso dell'elemento.

project

string

ID progetto o nome progetto

scopePath

string

Ambito del percorso. Il valore predefinito è Null.

recursionLevel
VersionControlRecursionType

Livello di ricorsione di questa richiesta. Il valore predefinito è 'none', nessuna ricorsione.

includeContentMetadata

boolean

Impostare su true per includere i metadati del contenuto. Il valore predefinito è false.

latestProcessedChange

boolean

Impostare su true per includere le modifiche più recenti. Il valore predefinito è false.

download

boolean

Impostare su true per scaricare la risposta come file. Il valore predefinito è false.

versionDescriptor
GitVersionDescriptor

Descrittore di versione. Il valore predefinito è il ramo predefinito per il repository.

includeContent

boolean

Impostare su true per includere il contenuto dell'elemento quando si richiede json. Il valore predefinito è false.

resolveHfs

boolean

Impostare su true per risolvere i file del puntatore GIT HFS per restituire il contenuto effettivo da Git HFS. Il valore predefinito è true.

sanitize

boolean

Impostare su true per purificare un file svg e restituirlo come immagine. Utile solo se richiesto per il file svg. Il valore predefinito è false.

Restituisce

Promise<ArrayBuffer>

getHfsItems(string, string, string, VersionControlRecursionType, boolean, boolean, boolean, boolean, GitVersionDescriptor, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per una raccolta di elementi. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso che viene sempre restituito come download.

function getHfsItems(repositoryId: string, project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeContentMetadata?: boolean, latestProcessedChange?: boolean, download?: boolean, includeLinks?: boolean, versionDescriptor?: GitVersionDescriptor, zipForUnix?: boolean): Promise<GitItem[]>

Parametri

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

scopePath

string

Ambito del percorso. Il valore predefinito è Null.

recursionLevel
VersionControlRecursionType

Livello di ricorsione di questa richiesta. Il valore predefinito è 'none', nessuna ricorsione.

includeContentMetadata

boolean

Impostare su true per includere i metadati del contenuto. Il valore predefinito è false.

latestProcessedChange

boolean

Impostare su true per includere le modifiche più recenti. Il valore predefinito è false.

download

boolean

Impostare su true per scaricare la risposta come file. Il valore predefinito è false.

includeLinks

boolean

Impostare su true per includere i collegamenti agli elementi. Il valore predefinito è false.

versionDescriptor
GitVersionDescriptor

Descrittore di versione. Il valore predefinito è il ramo predefinito per il repository.

zipForUnix

boolean

Impostare su true per mantenere le autorizzazioni per i file per sistemi UNIX (e POSIX), ad esempio eseguibili e collegamenti simbolici

Restituisce

Promise<GitItem[]>

getHfsItemText(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

function getHfsItemText(repositoryId: string, path: string, project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeContentMetadata?: boolean, latestProcessedChange?: boolean, download?: boolean, versionDescriptor?: GitVersionDescriptor, includeContent?: boolean, resolveHfs?: boolean, sanitize?: boolean): Promise<string>

Parametri

repositoryId

string

Nome o ID del repository.

path

string

Percorso dell'elemento.

project

string

ID progetto o nome progetto

scopePath

string

Ambito del percorso. Il valore predefinito è Null.

recursionLevel
VersionControlRecursionType

Livello di ricorsione di questa richiesta. Il valore predefinito è 'none', nessuna ricorsione.

includeContentMetadata

boolean

Impostare su true per includere i metadati del contenuto. Il valore predefinito è false.

latestProcessedChange

boolean

Impostare su true per includere le modifiche più recenti. Il valore predefinito è false.

download

boolean

Impostare su true per scaricare la risposta come file. Il valore predefinito è false.

versionDescriptor
GitVersionDescriptor

Descrittore di versione. Il valore predefinito è il ramo predefinito per il repository.

includeContent

boolean

Impostare su true per includere il contenuto dell'elemento quando si richiede json. Il valore predefinito è false.

resolveHfs

boolean

Impostare su true per risolvere i file del puntatore GIT HFS per restituire il contenuto effettivo da Git HFS. Il valore predefinito è true.

sanitize

boolean

Impostare su true per purificare un file svg e restituirlo come immagine. Utile solo se richiesto per il file svg. Il valore predefinito è false.

Restituisce

Promise<string>

getHfsItemZip(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

function getHfsItemZip(repositoryId: string, path: string, project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeContentMetadata?: boolean, latestProcessedChange?: boolean, download?: boolean, versionDescriptor?: GitVersionDescriptor, includeContent?: boolean, resolveHfs?: boolean, sanitize?: boolean): Promise<ArrayBuffer>

Parametri

repositoryId

string

Nome o ID del repository.

path

string

Percorso dell'elemento.

project

string

ID progetto o nome progetto

scopePath

string

Ambito del percorso. Il valore predefinito è Null.

recursionLevel
VersionControlRecursionType

Livello di ricorsione di questa richiesta. Il valore predefinito è 'none', nessuna ricorsione.

includeContentMetadata

boolean

Impostare su true per includere i metadati del contenuto. Il valore predefinito è false.

latestProcessedChange

boolean

Impostare su true per includere le modifiche più recenti. Il valore predefinito è false.

download

boolean

Impostare su true per scaricare la risposta come file. Il valore predefinito è false.

versionDescriptor
GitVersionDescriptor

Descrittore di versione. Il valore predefinito è il ramo predefinito per il repository.

includeContent

boolean

Impostare su true per includere il contenuto dell'elemento quando si richiede json. Il valore predefinito è false.

resolveHfs

boolean

Impostare su true per risolvere i file del puntatore GIT HFS per restituire il contenuto effettivo da Git HFS. Il valore predefinito è true.

sanitize

boolean

Impostare su true per purificare un file svg e restituirlo come immagine. Utile solo se richiesto per il file svg. Il valore predefinito è false.

Restituisce

Promise<ArrayBuffer>

getImportRequest(string, string, number)

Recuperare una determinata richiesta di importazione.

function getImportRequest(project: string, repositoryId: string, importRequestId: number): Promise<GitImportRequest>

Parametri

project

string

ID progetto o nome progetto

repositoryId

string

Nome o ID del repository.

importRequestId

number

Identificatore univoco per la richiesta di importazione.

Restituisce

Promise<GitImportRequest>

getItem(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

function getItem(repositoryId: string, path: string, project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeContentMetadata?: boolean, latestProcessedChange?: boolean, download?: boolean, versionDescriptor?: GitVersionDescriptor, includeContent?: boolean, resolveLfs?: boolean, sanitize?: boolean): Promise<GitItem>

Parametri

repositoryId

string

Nome o ID del repository.

path

string

Percorso dell'elemento.

project

string

ID progetto o nome progetto

scopePath

string

Ambito del percorso. Il valore predefinito è Null.

recursionLevel
VersionControlRecursionType

Livello di ricorsione di questa richiesta. Il valore predefinito è 'none', nessuna ricorsione.

includeContentMetadata

boolean

Impostare su true per includere i metadati del contenuto. Il valore predefinito è false.

latestProcessedChange

boolean

Impostare su true per includere le modifiche più recenti. Il valore predefinito è false.

download

boolean

Impostare su true per scaricare la risposta come file. Il valore predefinito è false.

versionDescriptor
GitVersionDescriptor

Descrittore di versione. Il valore predefinito è il ramo predefinito per il repository.

includeContent

boolean

Impostare su true per includere il contenuto dell'elemento quando si richiede json. Il valore predefinito è false.

resolveLfs

boolean

Impostare su true per risolvere i file del puntatore Git LFS per restituire il contenuto effettivo da Git LFS. Il valore predefinito è false.

sanitize

boolean

Impostare su true per purificare un file svg e restituirlo come immagine. Utile solo se richiesto per il file svg. Il valore predefinito è false.

Restituisce

Promise<GitItem>

getItemContent(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

function getItemContent(repositoryId: string, path: string, project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeContentMetadata?: boolean, latestProcessedChange?: boolean, download?: boolean, versionDescriptor?: GitVersionDescriptor, includeContent?: boolean, resolveLfs?: boolean, sanitize?: boolean): Promise<ArrayBuffer>

Parametri

repositoryId

string

Nome o ID del repository.

path

string

Percorso dell'elemento.

project

string

ID progetto o nome progetto

scopePath

string

Ambito del percorso. Il valore predefinito è Null.

recursionLevel
VersionControlRecursionType

Livello di ricorsione di questa richiesta. Il valore predefinito è 'none', nessuna ricorsione.

includeContentMetadata

boolean

Impostare su true per includere i metadati del contenuto. Il valore predefinito è false.

latestProcessedChange

boolean

Impostare su true per includere le modifiche più recenti. Il valore predefinito è false.

download

boolean

Impostare su true per scaricare la risposta come file. Il valore predefinito è false.

versionDescriptor
GitVersionDescriptor

Descrittore di versione. Il valore predefinito è il ramo predefinito per il repository.

includeContent

boolean

Impostare su true per includere il contenuto dell'elemento quando si richiede json. Il valore predefinito è false.

resolveLfs

boolean

Impostare su true per risolvere i file del puntatore Git LFS per restituire il contenuto effettivo da Git LFS. Il valore predefinito è false.

sanitize

boolean

Impostare su true per purificare un file svg e restituirlo come immagine. Utile solo se richiesto per il file svg. Il valore predefinito è false.

Restituisce

Promise<ArrayBuffer>

getItems(string, string, string, VersionControlRecursionType, boolean, boolean, boolean, boolean, GitVersionDescriptor, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per una raccolta di elementi. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso che viene sempre restituito come download.

function getItems(repositoryId: string, project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeContentMetadata?: boolean, latestProcessedChange?: boolean, download?: boolean, includeLinks?: boolean, versionDescriptor?: GitVersionDescriptor, zipForUnix?: boolean): Promise<GitItem[]>

Parametri

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

scopePath

string

Ambito del percorso. Il valore predefinito è Null.

recursionLevel
VersionControlRecursionType

Livello di ricorsione di questa richiesta. Il valore predefinito è 'none', nessuna ricorsione.

includeContentMetadata

boolean

Impostare su true per includere i metadati del contenuto. Il valore predefinito è false.

latestProcessedChange

boolean

Impostare su true per includere le modifiche più recenti. Il valore predefinito è false.

download

boolean

Impostare su true per scaricare la risposta come file. Il valore predefinito è false.

includeLinks

boolean

Impostare su true per includere i collegamenti agli elementi. Il valore predefinito è false.

versionDescriptor
GitVersionDescriptor

Descrittore di versione. Il valore predefinito è il ramo predefinito per il repository.

zipForUnix

boolean

Impostare su true per mantenere le autorizzazioni per i file per sistemi UNIX (e POSIX), ad esempio eseguibili e collegamenti simbolici

Restituisce

Promise<GitItem[]>

getItemsBatch(GitItemRequestData, string, string)

Eseguire il post per il recupero di un batch da un set di elementi in un repository/progetto in base a un elenco di percorsi o a un percorso lungo

function getItemsBatch(requestData: GitItemRequestData, repositoryId: string, project?: string): Promise<GitItem[][]>

Parametri

requestData
GitItemRequestData

Attributi dei dati della richiesta: ItemDescriptors, IncludeContentMetadata, LatestProcessedChange, IncludeLinks. ItemDescriptors: raccolta di elementi da recuperare, inclusi il percorso, la versione e il livello di ricorsione. IncludeContentMetadata: indica se includere i metadati per tutti gli elementi LatestProcessedChange: indica se includere riferimento superficiale per eseguire il commit dell'ultimo elemento modificato. IncludeLinks: indica se includere il campo _links sui riferimenti superficiali.

repositoryId

string

Nome o ID del repository

project

string

ID progetto o nome progetto

Restituisce

Promise<GitItem[][]>

getItemText(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

function getItemText(repositoryId: string, path: string, project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeContentMetadata?: boolean, latestProcessedChange?: boolean, download?: boolean, versionDescriptor?: GitVersionDescriptor, includeContent?: boolean, resolveLfs?: boolean, sanitize?: boolean): Promise<string>

Parametri

repositoryId

string

Nome o ID del repository.

path

string

Percorso dell'elemento.

project

string

ID progetto o nome progetto

scopePath

string

Ambito del percorso. Il valore predefinito è Null.

recursionLevel
VersionControlRecursionType

Livello di ricorsione di questa richiesta. Il valore predefinito è 'none', nessuna ricorsione.

includeContentMetadata

boolean

Impostare su true per includere i metadati del contenuto. Il valore predefinito è false.

latestProcessedChange

boolean

Impostare su true per includere le modifiche più recenti. Il valore predefinito è false.

download

boolean

Impostare su true per scaricare la risposta come file. Il valore predefinito è false.

versionDescriptor
GitVersionDescriptor

Descrittore di versione. Il valore predefinito è il ramo predefinito per il repository.

includeContent

boolean

Impostare su true per includere il contenuto dell'elemento quando si richiede json. Il valore predefinito è false.

resolveLfs

boolean

Impostare su true per risolvere i file del puntatore Git LFS per restituire il contenuto effettivo da Git LFS. Il valore predefinito è false.

sanitize

boolean

Impostare su true per purificare un file svg e restituirlo come immagine. Utile solo se richiesto per il file svg. Il valore predefinito è false.

Restituisce

Promise<string>

getItemZip(string, string, string, string, VersionControlRecursionType, boolean, boolean, boolean, GitVersionDescriptor, boolean, boolean, boolean)

Ottiene i metadati e/o il contenuto dell'elemento per un singolo elemento. Il parametro di download consiste nell'indicare se il contenuto deve essere disponibile come download o semplicemente inviato come flusso nella risposta. Non si applica al contenuto compresso, che viene sempre restituito come download.

function getItemZip(repositoryId: string, path: string, project?: string, scopePath?: string, recursionLevel?: VersionControlRecursionType, includeContentMetadata?: boolean, latestProcessedChange?: boolean, download?: boolean, versionDescriptor?: GitVersionDescriptor, includeContent?: boolean, resolveLfs?: boolean, sanitize?: boolean): Promise<ArrayBuffer>

Parametri

repositoryId

string

Nome o ID del repository.

path

string

Percorso dell'elemento.

project

string

ID progetto o nome progetto

scopePath

string

Ambito del percorso. Il valore predefinito è Null.

recursionLevel
VersionControlRecursionType

Livello di ricorsione di questa richiesta. Il valore predefinito è 'none', nessuna ricorsione.

includeContentMetadata

boolean

Impostare su true per includere i metadati del contenuto. Il valore predefinito è false.

latestProcessedChange

boolean

Impostare su true per includere le modifiche più recenti. Il valore predefinito è false.

download

boolean

Impostare su true per scaricare la risposta come file. Il valore predefinito è false.

versionDescriptor
GitVersionDescriptor

Descrittore di versione. Il valore predefinito è il ramo predefinito per il repository.

includeContent

boolean

Impostare su true per includere il contenuto dell'elemento quando si richiede json. Il valore predefinito è false.

resolveLfs

boolean

Impostare su true per risolvere i file del puntatore Git LFS per restituire il contenuto effettivo da Git LFS. Il valore predefinito è false.

sanitize

boolean

Impostare su true per purificare un file svg e restituirlo come immagine. Utile solo se richiesto per il file svg. Il valore predefinito è false.

Restituisce

Promise<ArrayBuffer>

getLikes(string, number, number, number, string)

Ottenere gli like per un commento.

function getLikes(repositoryId: string, pullRequestId: number, threadId: number, commentId: number, project?: string): Promise<IdentityRef[]>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

threadId

number

ID del thread che contiene il commento.

commentId

number

ID del commento.

project

string

ID progetto o nome progetto

Restituisce

Promise<IdentityRef[]>

getMergeBases(string, string, string, string, string, string)

Trovare le basi di merge di due commit, facoltativamente tra i fork. Se non viene specificato otherRepositoryId, le basi di merge verranno calcolate solo nel contesto del repository localeNameOrId.

function getMergeBases(repositoryNameOrId: string, commitId: string, otherCommitId: string, project?: string, otherCollectionId?: string, otherRepositoryId?: string): Promise<GitCommitRef[]>

Parametri

repositoryNameOrId

string

ID o nome del repository locale.

commitId

string

Primo commit, in genere il suggerimento del ramo di destinazione della potenziale unione.

otherCommitId

string

Altro commit, in genere il suggerimento del ramo di origine della potenziale unione.

project

string

ID progetto o nome progetto

otherCollectionId

string

ID raccolta in cui risiede otherCommitId.

otherRepositoryId

string

ID repository in cui risiede otherCommitId.

Restituisce

Promise<GitCommitRef[]>

getMergeRequest(string, string, number, boolean)

Ottenere i dettagli di un'operazione di unione specifica.

function getMergeRequest(project: string, repositoryNameOrId: string, mergeOperationId: number, includeLinks?: boolean): Promise<GitMerge>

Parametri

project

string

ID progetto o nome progetto

repositoryNameOrId

string

Nome o ID del repository.

mergeOperationId

number

OperationId della richiesta di merge.

includeLinks

boolean

True per includere i collegamenti

Restituisce

Promise<GitMerge>

getPermission(string, string, string)

GET Advanced Security Permission status (Stato dell'autorizzazione di sicurezza avanzata).

function getPermission(projectName?: string, repositoryId?: string, permission?: string): Promise<boolean>

Parametri

projectName

string

repositoryId

string

L'utente del repository sta tentando di accedere

permission

string

L'autorizzazione richiesta deve essere "viewAlert" "dismissAlert" "manage" "viewEnablement" o "repoRead"

Restituisce

Promise<boolean>

getPullRequest(string, number, string, number, number, number, boolean, boolean)

Recuperare una richiesta pull.

function getPullRequest(repositoryId: string, pullRequestId: number, project?: string, maxCommentLength?: number, skip?: number, top?: number, includeCommits?: boolean, includeWorkItemRefs?: boolean): Promise<GitPullRequest>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull da recuperare.

project

string

ID progetto o nome progetto

maxCommentLength

number

Non utilizzato.

skip

number

Non utilizzato.

top

number

Non utilizzato.

includeCommits

boolean

Se true, la richiesta pull verrà restituita con i commit associati.

includeWorkItemRefs

boolean

Se true, la richiesta pull verrà restituita con i riferimenti all'elemento di lavoro associato.

Restituisce

Promise<GitPullRequest>

getPullRequestById(number, string)

Recuperare una richiesta pull.

function getPullRequestById(pullRequestId: number, project?: string): Promise<GitPullRequest>

Parametri

pullRequestId

number

ID della richiesta pull da recuperare.

project

string

ID progetto o nome progetto

Restituisce

Promise<GitPullRequest>

getPullRequestCommits(string, number, string)

Ottenere i commit per la richiesta pull specificata.

function getPullRequestCommits(repositoryId: string, pullRequestId: number, project?: string): Promise<PagedList<GitCommitRef>>

Parametri

repositoryId

string

ID o nome del repository.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

getPullRequestConflict(string, number, number, string)

Recuperare un conflitto per una richiesta pull in base all'ID

function getPullRequestConflict(repositoryId: string, pullRequestId: number, conflictId: number, project?: string): Promise<GitConflict>

Parametri

repositoryId

string

pullRequestId

number

conflictId

number

project

string

ID progetto o nome progetto

Restituisce

Promise<GitConflict>

getPullRequestConflicts(string, number, string, number, number, boolean, boolean, boolean)

Recuperare tutti i conflitti per una richiesta pull

function getPullRequestConflicts(repositoryId: string, pullRequestId: number, project?: string, skip?: number, top?: number, includeObsolete?: boolean, excludeResolved?: boolean, onlyResolved?: boolean): Promise<GitConflict[]>

Parametri

repositoryId

string

Repository della richiesta pull.

pullRequestId

number

ID richiesta pull.

project

string

ID progetto o nome progetto

skip

number

Conflitti da ignorare.

top

number

Conflitti da restituire dopo ignorare.

includeObsolete

boolean

Include conflitti obsoleti.

excludeResolved

boolean

Esclude i conflitti già risolti.

onlyResolved

boolean

Restituisce solo i conflitti risolti.

Restituisce

Promise<GitConflict[]>

getPullRequestIteration(string, number, number, string)

Ottenere l'iterazione specificata per una richiesta pull.

function getPullRequestIteration(repositoryId: string, pullRequestId: number, iterationId: number, project?: string): Promise<GitPullRequestIteration>

Parametri

repositoryId

string

ID o nome del repository.

pullRequestId

number

ID della richiesta pull.

iterationId

number

ID dell'iterazione della richiesta pull da restituire.

project

string

ID progetto o nome progetto

Restituisce

getPullRequestIterationChanges(string, number, number, string, number, number, number)

Recuperare le modifiche apportate in una richiesta pull tra due iterazioni.

function getPullRequestIterationChanges(repositoryId: string, pullRequestId: number, iterationId: number, project?: string, top?: number, skip?: number, compareTo?: number): Promise<GitPullRequestIterationChanges>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

iterationId

number

ID dell'iterazione della richiesta pull. <br/> iterazione uno è l'head del ramo di origine al momento della creazione della richiesta pull e le iterazioni successive vengono create quando sono presenti push nel ramo di origine. I valori consentiti sono compresi tra 1 e l'iterazione massima per questa richiesta pull.

project

string

ID progetto o nome progetto

top

number

Opzionale. Numero di modifiche da recuperare. Il valore predefinito è 100 e il valore massimo è 2000.

skip

number

Opzionale. Numero di modifiche da ignorare. Ad esempio, per recuperare le modifiche 101-150, impostare i primi 50 e passare a 100.

compareTo

number

ID dell'iterazione della richiesta pull da confrontare. Il valore predefinito è zero che indica che il confronto viene eseguito rispetto al commit comune tra i rami di origine e di destinazione

Restituisce

getPullRequestIterationCommits(string, number, number, string, number, number)

Ottenere i commit per l'iterazione specificata di una richiesta pull.

function getPullRequestIterationCommits(repositoryId: string, pullRequestId: number, iterationId: number, project?: string, top?: number, skip?: number): Promise<GitCommitRef[]>

Parametri

repositoryId

string

ID o nome del repository.

pullRequestId

number

ID della richiesta pull.

iterationId

number

ID dell'iterazione da cui ottenere i commit.

project

string

ID progetto o nome progetto

top

number

Numero massimo di commit da restituire. Il numero massimo di commit che è possibile restituire per batch è 500.

skip

number

Numero di commit da ignorare.

Restituisce

Promise<GitCommitRef[]>

getPullRequestIterations(string, number, string, boolean)

Ottenere l'elenco di iterazioni per la richiesta pull specificata.

function getPullRequestIterations(repositoryId: string, pullRequestId: number, project?: string, includeCommits?: boolean): Promise<GitPullRequestIteration[]>

Parametri

repositoryId

string

ID o nome del repository.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

includeCommits

boolean

Se true, includere i commit associati a ogni iterazione nella risposta.

Restituisce

getPullRequestIterationStatus(string, number, number, number, string)

Ottenere lo stato di iterazione della richiesta pull specifico in base all'ID. L'ID di stato è univoco all'interno della richiesta pull in tutte le iterazioni.

function getPullRequestIterationStatus(repositoryId: string, pullRequestId: number, iterationId: number, statusId: number, project?: string): Promise<GitPullRequestStatus>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

iterationId

number

ID dell'iterazione della richiesta pull.

statusId

number

ID dello stato della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

getPullRequestIterationStatuses(string, number, number, string)

Ottiene tutti gli stati associati a un'iterazione della richiesta pull.

function getPullRequestIterationStatuses(repositoryId: string, pullRequestId: number, iterationId: number, project?: string): Promise<GitPullRequestStatus[]>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

iterationId

number

ID dell'iterazione della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

getPullRequestLabel(string, number, string, string, string)

Recupera una singola etichetta (tag) assegnata a una richiesta pull.

function getPullRequestLabel(repositoryId: string, pullRequestId: number, labelIdOrName: string, project?: string, projectId?: string): Promise<WebApiTagDefinition>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

labelIdOrName

string

Nome o ID dell'etichetta richiesta.

project

string

ID progetto o nome progetto

projectId

string

ID progetto o nome del progetto.

Restituisce

getPullRequestLabels(string, number, string, string)

Ottiene tutte le etichette (tag) assegnate a una richiesta pull.

function getPullRequestLabels(repositoryId: string, pullRequestId: number, project?: string, projectId?: string): Promise<WebApiTagDefinition[]>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

projectId

string

ID progetto o nome del progetto.

Restituisce

Promise<WebApiTagDefinition[]>

getPullRequestProperties(string, number, string)

Ottiene proprietà esterne della richiesta pull.

function getPullRequestProperties(repositoryId: string, pullRequestId: number, project?: string): Promise<any>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<any>

getPullRequestQuery(GitPullRequestQuery, string, string)

Questa API viene usata per trovare le richieste pull correlate a un determinato commit. Può essere usato per trovare la richiesta pull che ha creato un commit di merge specifico oppure può essere usata per trovare tutte le richieste pull che hanno mai unito un determinato commit. L'input è un elenco di query che contengono un elenco di commit. Per ogni commit su cui si esegue la ricerca, si otterrà un dizionario di commit,> richieste pull.

function getPullRequestQuery(queries: GitPullRequestQuery, repositoryId: string, project?: string): Promise<GitPullRequestQuery>

Parametri

queries
GitPullRequestQuery

Elenco di query da eseguire.

repositoryId

string

ID del repository.

project

string

ID progetto o nome progetto

Restituisce

getPullRequestReviewer(string, number, string, string)

Recuperare informazioni su un revisore specifico in una richiesta pull

function getPullRequestReviewer(repositoryId: string, pullRequestId: number, reviewerId: string, project?: string): Promise<IdentityRefWithVote>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

reviewerId

string

ID del revisore.

project

string

ID progetto o nome progetto

Restituisce

getPullRequestReviewers(string, number, string)

Recuperare i revisori per una richiesta pull

function getPullRequestReviewers(repositoryId: string, pullRequestId: number, project?: string): Promise<IdentityRefWithVote[]>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<IdentityRefWithVote[]>

getPullRequests(string, GitPullRequestSearchCriteria, string, number, number, number)

Recuperare tutte le richieste pull corrispondenti a un criterio specificato.

function getPullRequests(repositoryId: string, searchCriteria: GitPullRequestSearchCriteria, project?: string, maxCommentLength?: number, skip?: number, top?: number): Promise<GitPullRequest[]>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

searchCriteria
GitPullRequestSearchCriteria

Le richieste pull verranno restituite che corrispondono a questi criteri di ricerca.

project

string

ID progetto o nome progetto

maxCommentLength

number

Non utilizzato.

skip

number

Numero di richieste pull da ignorare. Ad esempio, per recuperare i risultati da 101 a 150, impostare top su 50 e passare a 100.

top

number

Numero di richieste pull da recuperare.

Restituisce

Promise<GitPullRequest[]>

getPullRequestsByProject(string, GitPullRequestSearchCriteria, number, number, number)

Recuperare tutte le richieste pull corrispondenti a un criterio specificato.

function getPullRequestsByProject(project: string, searchCriteria: GitPullRequestSearchCriteria, maxCommentLength?: number, skip?: number, top?: number): Promise<GitPullRequest[]>

Parametri

project

string

ID progetto o nome progetto

searchCriteria
GitPullRequestSearchCriteria

Le richieste pull verranno restituite che corrispondono a questi criteri di ricerca.

maxCommentLength

number

Non utilizzato.

skip

number

Numero di richieste pull da ignorare. Ad esempio, per recuperare i risultati da 101 a 150, impostare top su 50 e passare a 100.

top

number

Numero di richieste pull da recuperare.

Restituisce

Promise<GitPullRequest[]>

getPullRequestStatus(string, number, number, string)

Ottenere lo stato specifico della richiesta pull in base all'ID. L'ID di stato è univoco all'interno della richiesta pull in tutte le iterazioni.

function getPullRequestStatus(repositoryId: string, pullRequestId: number, statusId: number, project?: string): Promise<GitPullRequestStatus>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

statusId

number

ID dello stato della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

getPullRequestStatuses(string, number, string)

Ottenere tutti gli stati associati a una richiesta pull.

function getPullRequestStatuses(repositoryId: string, pullRequestId: number, project?: string): Promise<GitPullRequestStatus[]>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

getPullRequestThread(string, number, number, string, number, number)

Recuperare un thread in una richiesta pull.

function getPullRequestThread(repositoryId: string, pullRequestId: number, threadId: number, project?: string, iteration?: number, baseIteration?: number): Promise<GitPullRequestCommentThread>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

threadId

number

ID del thread.

project

string

ID progetto o nome progetto

iteration

number

Se specificato, la posizione del thread verrà rilevata usando questa iterazione come lato destro del diff.

baseIteration

number

Se specificato, la posizione del thread verrà rilevata usando questa iterazione come lato sinistro della diff.

Restituisce

getPullRequestWorkItemRefs(string, number, string)

Recuperare un elenco di elementi di lavoro associati a una richiesta pull.

function getPullRequestWorkItemRefs(repositoryId: string, pullRequestId: number, project?: string): Promise<ResourceRef[]>

Parametri

repositoryId

string

ID o nome del repository.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<ResourceRef[]>

getPush(string, number, string, number, boolean)

Recupera un push specifico.

function getPush(repositoryId: string, pushId: number, project?: string, includeCommits?: number, includeRefUpdates?: boolean): Promise<GitPush>

Parametri

repositoryId

string

Nome o ID del repository.

pushId

number

ID del push.

project

string

ID progetto o nome progetto

includeCommits

number

Numero di commit da includere nel risultato.

includeRefUpdates

boolean

Se true, includere l'elenco di riferimenti aggiornati dal push.

Restituisce

Promise<GitPush>

getPushCommits(string, number, string, number, number, boolean)

Recuperare un elenco di commit associati a un push specifico.

function getPushCommits(repositoryId: string, pushId: number, project?: string, top?: number, skip?: number, includeLinks?: boolean): Promise<GitCommitRef[]>

Parametri

repositoryId

string

ID o nome descrittivo del repository. Per usare il nome descrittivo, è necessario specificare anche projectId.

pushId

number

ID del push.

project

string

ID progetto o nome progetto

top

number

Numero massimo di commit da restituire ("ottenere i primi x commit").

skip

number

Numero di commit da ignorare.

includeLinks

boolean

Impostare su false per evitare di includere collegamenti URL REST per le risorse. Il valore predefinito è true.

Restituisce

Promise<GitCommitRef[]>

getPushes(string, string, number, number, GitPushSearchCriteria)

Recupera i push associati al repository specificato.

function getPushes(repositoryId: string, project?: string, skip?: number, top?: number, searchCriteria?: GitPushSearchCriteria): Promise<GitPush[]>

Parametri

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

skip

number

Numero di push da ignorare.

top

number

Numero di push da restituire.

searchCriteria
GitPushSearchCriteria

Attributi dei criteri di ricerca: fromDate, toDate, pusherId, refName, includeRefUpdates o includeLinks. fromDate: data di inizio da cui eseguire la ricerca. toDate: data di fine in cui eseguire la ricerca. pusherId: identità della persona che ha inviato il push. refName: nome del ramo da considerare. includeRefUpdates: se true, includere l'elenco di riferimenti aggiornati dal push. includeLinks: indica se includere il campo _links nei riferimenti superficiali.

Restituisce

Promise<GitPush[]>

getRecycleBinRepositories(string)

Recuperare i repository Git eliminati soft dal Cestino.

function getRecycleBinRepositories(project: string): Promise<GitDeletedRepository[]>

Parametri

project

string

ID progetto o nome progetto

Restituisce

getRefFavorite(string, number)

Ottiene i riferimenti preferiti per un ID preferito.

function getRefFavorite(project: string, favoriteId: number): Promise<GitRefFavorite>

Parametri

project

string

ID progetto o nome progetto

favoriteId

number

ID del preferito ref richiesto.

Restituisce

Promise<GitRefFavorite>

getRefFavorites(string, string, string)

Ottiene i preferiti dei riferimenti per un repository e un'identità.

function getRefFavorites(project: string, repositoryId?: string, identityId?: string): Promise<GitRefFavorite[]>

Parametri

project

string

ID progetto o nome progetto

repositoryId

string

ID del repository.

identityId

string

ID dell'identità i cui preferiti devono essere recuperati. Se null, viene usata l'identità richiedente.

Restituisce

Promise<GitRefFavorite[]>

getRefFavoritesForProject(string, string)

function getRefFavoritesForProject(project: string, identityId?: string): Promise<GitRefFavorite[]>

Parametri

project

string

ID progetto o nome progetto

identityId

string

Restituisce

Promise<GitRefFavorite[]>

getRefs(string, string, string, boolean, boolean, boolean, boolean, boolean, string)

Esegue una query sul repository fornito per i relativi riferimenti e li restituisce.

function getRefs(repositoryId: string, project?: string, filter?: string, includeLinks?: boolean, includeStatuses?: boolean, includeMyBranches?: boolean, latestStatusesOnly?: boolean, peelTags?: boolean, filterContains?: string): Promise<PagedList<GitRef>>

Parametri

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

filter

string

[facoltativo] Filtro da applicare ai riferimenti (inizia con).

includeLinks

boolean

[facoltativo] Specifica se referenceLinks deve essere incluso nel risultato. il valore predefinito è false.

includeStatuses

boolean

[facoltativo] Include fino ai primi 1000 stati di commit per ogni riferimento. Il valore predefinito è false.

includeMyBranches

boolean

[facoltativo] Include solo rami di proprietà dell'utente, i rami preferiti dell'utente e il ramo predefinito. Il valore predefinito è false. Non può essere combinato con il parametro di filtro.

latestStatusesOnly

boolean

[facoltativo] True per includere solo lo stato del commit della mancia per ogni riferimento. Per questa opzione è necessario che includeStatuses sia true. Il valore predefinito è false.

peelTags

boolean

[facoltativo] I tag annotati popolano la proprietà PeeledObjectId. il valore predefinito è false.

filterContains

string

[facoltativo] Filtro da applicare ai riferimenti (contiene).

Restituisce

Promise<PagedList<GitRef>>

getRepositories(string, boolean, boolean, boolean)

Recuperare i repository Git.

function getRepositories(project?: string, includeLinks?: boolean, includeAllUrls?: boolean, includeHidden?: boolean): Promise<GitRepository[]>

Parametri

project

string

ID progetto o nome progetto

includeLinks

boolean

[facoltativo] True per includere i collegamenti di riferimento. Il valore predefinito è false.

includeAllUrls

boolean

[facoltativo] True per includere tutti gli URL remoti. Il valore predefinito è false.

includeHidden

boolean

[facoltativo] True per includere repository nascosti. Il valore predefinito è false.

Restituisce

Promise<GitRepository[]>

getRepositoriesPaged(string, boolean, boolean, boolean, string, number, string)

Recuperare i repository Git con il filtro in base al nome e alla paginazione.

function getRepositoriesPaged(projectId: string, includeLinks?: boolean, includeAllUrls?: boolean, includeHidden?: boolean, filterContains?: string, top?: number, continuationToken?: string): Promise<PagedList<GitRepository>>

Parametri

projectId

string

ID o nome del progetto team.

includeLinks

boolean

[facoltativo] True per includere i collegamenti di riferimento. Il valore predefinito è false.

includeAllUrls

boolean

[facoltativo] True per includere tutti gli URL remoti. Il valore predefinito è false.

includeHidden

boolean

[facoltativo] True per includere repository nascosti. Il valore predefinito è false.

filterContains

string

[facoltativo] Filtro da applicare ai riferimenti (contiene).

top

number

[facoltativo] Numero massimo di repository da restituire. Non può essere più grande di 500. Se non viene specificato, ma continuationToken è, il valore predefinito è 100.

continuationToken

string

Token di continuazione usato per la paginazione.

Restituisce

getRepository(string, string)

Recuperare un repository Git.

function getRepository(repositoryId: string, project?: string): Promise<GitRepository>

Parametri

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

Restituisce

Promise<GitRepository>

getRepositoryWithParent(string, boolean, string)

Recuperare un repository Git.

function getRepositoryWithParent(repositoryId: string, includeParent: boolean, project?: string): Promise<GitRepository>

Parametri

repositoryId

string

Nome o ID del repository.

includeParent

boolean

True per includere il repository padre. Disponibile solo nelle chiamate autenticate.

project

string

ID progetto o nome progetto

Restituisce

Promise<GitRepository>

getRevert(string, number, string)

Recuperare informazioni su un'operazione di ripristino ripristinando l'ID.

function getRevert(project: string, revertId: number, repositoryId: string): Promise<GitRevert>

Parametri

project

string

ID progetto o nome progetto

revertId

number

ID dell'operazione di ripristino.

repositoryId

string

ID del repository.

Restituisce

Promise<GitRevert>

getRevertConflict(string, number, number, string)

Recuperare un conflitto per un ripristino in base all'ID

function getRevertConflict(repositoryId: string, revertId: number, conflictId: number, project?: string): Promise<GitConflict>

Parametri

repositoryId

string

revertId

number

conflictId

number

project

string

ID progetto o nome progetto

Restituisce

Promise<GitConflict>

getRevertConflicts(string, number, string, string, number, boolean, boolean, boolean)

Recuperare tutti i conflitti per un ripristino

function getRevertConflicts(repositoryId: string, revertId: number, project?: string, continuationToken?: string, top?: number, excludeResolved?: boolean, onlyResolved?: boolean, includeObsolete?: boolean): Promise<PagedList<GitConflict>>

Parametri

repositoryId

string

revertId

number

project

string

ID progetto o nome progetto

continuationToken

string

top

number

excludeResolved

boolean

onlyResolved

boolean

includeObsolete

boolean

Restituisce

getRevertForRefName(string, string, string)

Recuperare informazioni su un'operazione di ripristino per un ramo specifico.

function getRevertForRefName(project: string, repositoryId: string, refName: string): Promise<GitRevert>

Parametri

project

string

ID progetto o nome progetto

repositoryId

string

ID del repository.

refName

string

GitAsyncRefOperationParameters generatedRefName usato per l'operazione di ripristino.

Restituisce

Promise<GitRevert>

getStatuses(string, string, string, number, number, boolean)

Ottiene gli stati associati al commit Git.

function getStatuses(commitId: string, repositoryId: string, project?: string, top?: number, skip?: number, latestOnly?: boolean): Promise<GitStatus[]>

Parametri

commitId

string

ID del commit Git.

repositoryId

string

ID del repository.

project

string

ID progetto o nome progetto

top

number

Opzionale. Numero di stati da recuperare. Il valore predefinito è 1000.

skip

number

Opzionale. Numero di stati da ignorare. Il valore predefinito è 0. Ad esempio, per recuperare i risultati da 101 a 150, impostare top su 50 e passare a 100.

latestOnly

boolean

Il flag indica se ottenere solo gli stati più recenti raggruppati per Context.Name e Context.Genre.

Restituisce

Promise<GitStatus[]>

getSuggestions(string, string, boolean)

Recuperare un suggerimento per una richiesta pull per un repository o un progetto team specifico.

function getSuggestions(repositoryId: string, project?: string, preferCompareBranch?: boolean): Promise<GitSuggestion[]>

Parametri

repositoryId

string

ID del repository Git.

project

string

ID progetto o nome progetto

preferCompareBranch

boolean

Se true, preferire il ramo di confronto rispetto al ramo predefinito come ramo di destinazione per le richieste pull.

Restituisce

Promise<GitSuggestion[]>

getThreads(string, number, string, number, number)

Recuperare tutti i thread in una richiesta pull.

function getThreads(repositoryId: string, pullRequestId: number, project?: string, iteration?: number, baseIteration?: number): Promise<GitPullRequestCommentThread[]>

Parametri

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

iteration

number

Se specificato, le posizioni dei thread verranno rilevate usando questa iterazione come lato destro della diff.

baseIteration

number

Se specificato, le posizioni dei thread verranno rilevate usando questa iterazione come lato sinistro della diff.

Restituisce

getTree(string, string, string, string, boolean, string)

L'endpoint Tree restituisce la raccolta di oggetti sotto l'albero specificato. Gli alberi sono cartelle in un repository Git.

function getTree(repositoryId: string, sha1: string, project?: string, projectId?: string, recursive?: boolean, fileName?: string): Promise<GitTreeRef>

Parametri

repositoryId

string

ID repository.

sha1

string

Hash SHA1 dell'oggetto albero.

project

string

ID progetto o nome progetto

projectId

string

ID progetto.

recursive

boolean

Eseguire la ricerca in modo ricorsivo. Includere alberi sotto questo albero. Il valore predefinito è false.

fileName

string

Nome da utilizzare se viene restituito un file .zip. Il valore predefinito è l'ID oggetto.

Restituisce

Promise<GitTreeRef>

getTreeZip(string, string, string, string, boolean, string)

L'endpoint Tree restituisce la raccolta di oggetti sotto l'albero specificato. Gli alberi sono cartelle in un repository Git.

function getTreeZip(repositoryId: string, sha1: string, project?: string, projectId?: string, recursive?: boolean, fileName?: string): Promise<ArrayBuffer>

Parametri

repositoryId

string

ID repository.

sha1

string

Hash SHA1 dell'oggetto albero.

project

string

ID progetto o nome progetto

projectId

string

ID progetto.

recursive

boolean

Eseguire la ricerca in modo ricorsivo. Includere alberi sotto questo albero. Il valore predefinito è false.

fileName

string

Nome da utilizzare se viene restituito un file .zip. Il valore predefinito è l'ID oggetto.

Restituisce

Promise<ArrayBuffer>

queryImportRequests(string, string, boolean)

Recuperare le richieste di importazione per un repository.

function queryImportRequests(project: string, repositoryId: string, includeAbandoned?: boolean): Promise<GitImportRequest[]>

Parametri

project

string

ID progetto o nome progetto

repositoryId

string

Nome o ID del repository.

includeAbandoned

boolean

True per includere le richieste di importazione abbandonate nei risultati.

Restituisce

Promise<GitImportRequest[]>

restoreRepositoryFromRecycleBin(GitRecycleBinRepositoryDetails, string, string)

Ripristinare un repository Git eliminato temporaneo. I repository eliminati di recente passano a uno stato di eliminazione temporanea per un periodo di tempo prima che vengano eliminati definitivamente e diventino irreversibili.

function restoreRepositoryFromRecycleBin(repositoryDetails: GitRecycleBinRepositoryDetails, project: string, repositoryId: string): Promise<GitRepository>

Parametri

repositoryDetails
GitRecycleBinRepositoryDetails
project

string

ID progetto o nome progetto

repositoryId

string

ID del repository.

Restituisce

Promise<GitRepository>

setEnableOnCreateHost(boolean)

function setEnableOnCreateHost(enableOnCreateHost: boolean): Promise<void>

Parametri

enableOnCreateHost

boolean

Restituisce

Promise<void>

setEnableOnCreateProject(string, boolean)

function setEnableOnCreateProject(enableOnCreateProjectId: string, enableOnStatus: boolean): Promise<void>

Parametri

enableOnCreateProjectId

string

enableOnStatus

boolean

Restituisce

Promise<void>

sharePullRequest(ShareNotificationContext, string, number, string)

Invia una notifica tramite posta elettronica relativa a una richiesta pull specifica a un set di destinatari

function sharePullRequest(userMessage: ShareNotificationContext, repositoryId: string, pullRequestId: number, project?: string): Promise<void>

Parametri

repositoryId

string

ID del repository Git.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

updateCherryPickConflict(GitConflict, string, number, number, string)

Aggiornare la risoluzione dei conflitti di unione

function updateCherryPickConflict(conflict: GitConflict, repositoryId: string, cherryPickId: number, conflictId: number, project?: string): Promise<GitConflict>

Parametri

conflict
GitConflict
repositoryId

string

cherryPickId

number

conflictId

number

project

string

ID progetto o nome progetto

Restituisce

Promise<GitConflict>

updateCherryPickConflicts(GitConflict[], string, number, string)

Aggiornare più risoluzioni dei conflitti di merge

function updateCherryPickConflicts(conflictUpdates: GitConflict[], repositoryId: string, cherryPickId: number, project?: string): Promise<GitConflictUpdateResult[]>

Parametri

conflictUpdates

GitConflict[]

repositoryId

string

cherryPickId

number

project

string

ID progetto o nome progetto

Restituisce

updateComment(Comment, string, number, number, number, string)

Aggiornare un commento associato a un thread specifico in una richiesta pull.

function updateComment(comment: Comment, repositoryId: string, pullRequestId: number, threadId: number, commentId: number, project?: string): Promise<Comment>

Parametri

comment
Comment

Contenuto del commento da aggiornare. I commenti possono contenere fino a 150.000 caratteri.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

threadId

number

ID del thread in cui si trova il commento desiderato.

commentId

number

ID del commento da aggiornare.

project

string

ID progetto o nome progetto

Restituisce

Promise<Comment>

updateEnablementStatus(AdvSecEnablementUpdate[])

Stato di abilitazione POST per i repository.

function updateEnablementStatus(enablementUpdates: AdvSecEnablementUpdate[]): Promise<void>

Parametri

enablementUpdates

AdvSecEnablementUpdate[]

Restituisce

Promise<void>

updateImportRequest(GitImportRequest, string, string, number)

Riprovare o abbandonare una richiesta di importazione non riuscita.

function updateImportRequest(importRequestToUpdate: GitImportRequest, project: string, repositoryId: string, importRequestId: number): Promise<GitImportRequest>

Parametri

importRequestToUpdate
GitImportRequest

Versione aggiornata della richiesta di importazione. Attualmente, l'unica modifica consentita è l'impostazione di Stato su Accodato o Abbandonato.

project

string

ID progetto o nome progetto

repositoryId

string

Nome o ID del repository.

importRequestId

number

Identificatore univoco per la richiesta di importazione da aggiornare.

Restituisce

Promise<GitImportRequest>

updatePullRequest(GitPullRequest, string, number, string)

Aggiornare una richiesta pull

function updatePullRequest(gitPullRequestToUpdate: GitPullRequest, repositoryId: string, pullRequestId: number, project?: string): Promise<GitPullRequest>

Parametri

gitPullRequestToUpdate
GitPullRequest

Contenuto della richiesta pull da aggiornare.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull da aggiornare.

project

string

ID progetto o nome progetto

Restituisce

Promise<GitPullRequest>

updatePullRequestConflict(GitConflict, string, number, number, string)

Aggiornare la risoluzione dei conflitti di unione

function updatePullRequestConflict(conflict: GitConflict, repositoryId: string, pullRequestId: number, conflictId: number, project?: string): Promise<GitConflict>

Parametri

conflict
GitConflict
repositoryId

string

pullRequestId

number

conflictId

number

project

string

ID progetto o nome progetto

Restituisce

Promise<GitConflict>

updatePullRequestConflicts(GitConflict[], string, number, string)

Aggiornare più risoluzioni dei conflitti di merge

function updatePullRequestConflicts(conflictUpdates: GitConflict[], repositoryId: string, pullRequestId: number, project?: string): Promise<GitConflictUpdateResult[]>

Parametri

conflictUpdates

GitConflict[]

repositoryId

string

pullRequestId

number

project

string

ID progetto o nome progetto

Restituisce

updatePullRequestIterationStatuses(JsonPatchDocument, string, number, number, string)

Aggiornare la raccolta di stati di iterazione delle richieste pull. L'unico tipo di operazione supportato è remove.

function updatePullRequestIterationStatuses(patchDocument: JsonPatchDocument, repositoryId: string, pullRequestId: number, iterationId: number, project?: string): Promise<void>

Parametri

patchDocument
JsonPatchDocument

Operazioni da applicare agli stati delle richieste pull in formato Patch JSON.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

iterationId

number

ID dell'iterazione della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

updatePullRequestProperties(JsonPatchDocument, string, number, string)

Creare o aggiornare le proprietà esterne della richiesta pull. L'operazione di patch può essere add, replace o remove. Per add'operazione, il percorso può essere vuoto. Se il percorso è vuoto, il valore deve essere un elenco di coppie chiave-valore. Per replace'operazione, il percorso non può essere vuoto. Se il percorso non esiste, la proprietà verrà aggiunta all'insieme. Per remove'operazione, il percorso non può essere vuoto. Se il percorso non esiste, non verrà eseguita alcuna azione.

function updatePullRequestProperties(patchDocument: JsonPatchDocument, repositoryId: string, pullRequestId: number, project?: string): Promise<any>

Parametri

patchDocument
JsonPatchDocument

Proprietà da aggiungere, sostituire o rimuovere in formato Patch JSON.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<any>

updatePullRequestReviewer(IdentityRefWithVote, string, number, string, string)

Modificare una voce del revisore. Questi campi sono patchable: isFlagged, hasDeclined

function updatePullRequestReviewer(reviewer: IdentityRefWithVote, repositoryId: string, pullRequestId: number, reviewerId: string, project?: string): Promise<IdentityRefWithVote>

Parametri

reviewer
IdentityRefWithVote

Dati del revisore.<br/>Se l'ID del revisore è incluso qui, deve corrispondere al parametro reviewerID.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

reviewerId

string

ID del revisore.

project

string

ID progetto o nome progetto

Restituisce

updatePullRequestReviewers(IdentityRefWithVote[], string, number, string)

Reimpostare i voti di più revisori in una richiesta pull. NOTA: questo endpoint supporta solo l'aggiornamento dei voti, ma non supporta l'aggiornamento dei revisori necessari (usare i criteri) o i nomi visualizzati.

function updatePullRequestReviewers(patchVotes: IdentityRefWithVote[], repositoryId: string, pullRequestId: number, project?: string): Promise<void>

Parametri

patchVotes

IdentityRefWithVote[]

ID dei revisori i cui voti verranno reimpostati su zero

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

updatePullRequestStatuses(JsonPatchDocument, string, number, string)

Aggiornare la raccolta di stati delle richieste pull. L'unico tipo di operazione supportato è remove.

function updatePullRequestStatuses(patchDocument: JsonPatchDocument, repositoryId: string, pullRequestId: number, project?: string): Promise<void>

Parametri

patchDocument
JsonPatchDocument

Operazioni da applicare agli stati delle richieste pull in formato Patch JSON.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

project

string

ID progetto o nome progetto

Restituisce

Promise<void>

updateRef(GitRefUpdate, string, string, string, string)

Bloccare o sbloccare un ramo.

function updateRef(newRefInfo: GitRefUpdate, repositoryId: string, filter: string, project?: string, projectId?: string): Promise<GitRef>

Parametri

newRefInfo
GitRefUpdate

Azione di aggiornamento ref (blocco/sblocco) da eseguire

repositoryId

string

Nome o ID del repository.

filter

string

Nome del ramo da bloccare/sbloccare

project

string

ID progetto o nome progetto

projectId

string

ID o nome del progetto team. Facoltativo se si specifica un ID per il repository.

Restituisce

Promise<GitRef>

updateRefs(GitRefUpdate[], string, string, string)

Creazione, aggiornamento o eliminazione di refs(rami).

function updateRefs(refUpdates: GitRefUpdate[], repositoryId: string, project?: string, projectId?: string): Promise<GitRefUpdateResult[]>

Parametri

refUpdates

GitRefUpdate[]

Elenco di aggiornamenti di riferimento per tentare di eseguire

repositoryId

string

Nome o ID del repository.

project

string

ID progetto o nome progetto

projectId

string

ID o nome del progetto team. Facoltativo se si specifica un ID per il repository.

Restituisce

Promise<GitRefUpdateResult[]>

updateRepository(GitRepository, string, string)

Aggiorna il repository Git con un nuovo nome di repository o un nuovo ramo predefinito.

function updateRepository(newRepositoryInfo: GitRepository, repositoryId: string, project?: string): Promise<GitRepository>

Parametri

newRepositoryInfo
GitRepository

Specificare un nuovo nome di repository o un nuovo ramo predefinito del repository

repositoryId

string

ID del repository.

project

string

ID progetto o nome progetto

Restituisce

Promise<GitRepository>

updateRevertConflict(GitConflict, string, number, number, string)

Aggiornare la risoluzione dei conflitti di unione

function updateRevertConflict(conflict: GitConflict, repositoryId: string, revertId: number, conflictId: number, project?: string): Promise<GitConflict>

Parametri

conflict
GitConflict
repositoryId

string

revertId

number

conflictId

number

project

string

ID progetto o nome progetto

Restituisce

Promise<GitConflict>

updateRevertConflicts(GitConflict[], string, number, string)

Aggiornare più risoluzioni dei conflitti di merge

function updateRevertConflicts(conflictUpdates: GitConflict[], repositoryId: string, revertId: number, project?: string): Promise<GitConflictUpdateResult[]>

Parametri

conflictUpdates

GitConflict[]

repositoryId

string

revertId

number

project

string

ID progetto o nome progetto

Restituisce

updateThread(GitPullRequestCommentThread, string, number, number, string)

Aggiornare un thread in una richiesta pull.

function updateThread(commentThread: GitPullRequestCommentThread, repositoryId: string, pullRequestId: number, threadId: number, project?: string): Promise<GitPullRequestCommentThread>

Parametri

commentThread
GitPullRequestCommentThread

Contenuto del thread da aggiornare.

repositoryId

string

ID repository del ramo di destinazione della richiesta pull.

pullRequestId

number

ID della richiesta pull.

threadId

number

ID del thread da aggiornare.

project

string

ID progetto o nome progetto

Restituisce