Pull Requests - Create

Creare una richiesta pull.

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?api-version=7.1-preview.1
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?supportsIterations={supportsIterations}&api-version=7.1-preview.1

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
path True

string

Nome dell'organizzazione di Azure DevOps.

repositoryId
path True

string

ID repository del ramo di destinazione della richiesta pull.

project
path

string

ID progetto o nome progetto

api-version
query True

string

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

supportsIterations
query

boolean

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

Corpo della richiesta

Nome Tipo Descrizione
_links

ReferenceLinks

Collegamenti ad altri oggetti correlati.

artifactId

string

Stringa che identifica in modo univoco questa richiesta pull. Per generare un ID artefatto per una richiesta pull, usare questo modello: vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}

autoCompleteSetBy

IdentityRef

Se impostato, il completamento automatico è abilitato per questa richiesta pull e questa è l'identità abilitata.

closedBy

IdentityRef

Utente che ha chiuso la richiesta pull.

closedDate

string

Data di chiusura della richiesta pull (completata, abbandonata o unita esternamente).

codeReviewId

integer

ID di revisione del codice della richiesta pull. Per uso interno.

commits

GitCommitRef[]

I commit contenuti nella richiesta pull.

completionOptions

GitPullRequestCompletionOptions

Opzioni che influiscono sul modo in cui la richiesta pull verrà unita al completamento.

completionQueueTime

string

Data più recente in cui la richiesta pull ha immesso la coda da completare. Per uso interno.

createdBy

IdentityRef

Identità dell'utente che ha creato la richiesta pull.

creationDate

string

Data di creazione della richiesta pull.

description

string

Descrizione della richiesta pull.

forkSource

GitForkRef

Se si tratta di una richiesta pr da un fork, questo conterrà informazioni sulla relativa origine.

hasMultipleMergeBases

boolean

Avviso di più mergebase

isDraft

boolean

Richiesta pull bozza/WIP.

labels

WebApiTagDefinition[]

Etichette associate alla richiesta pull.

lastMergeCommit

GitCommitRef

Commit del merge della richiesta pull più recente. Se vuoto, l'unione più recente è in corso o ha avuto esito negativo.

lastMergeSourceCommit

GitCommitRef

Commit all'inizio del ramo di origine al momento dell'ultima unione della richiesta pull.

lastMergeTargetCommit

GitCommitRef

Commit all'inizio del ramo di destinazione al momento dell'ultima unione della richiesta pull.

mergeFailureMessage

string

Se impostato, l'unione della richiesta pull non è riuscita per questo motivo.

mergeFailureType

PullRequestMergeFailureType

Tipo di errore (se presente) dell'unione della richiesta pull.

mergeId

string

ID del processo usato per eseguire l'unione della richiesta pull. Per uso interno.

mergeOptions

GitPullRequestMergeOptions

Opzioni usate quando viene eseguita l'unione della richiesta pull. Queste sono separate dalle opzioni di completamento poiché il completamento avviene una sola volta e una nuova unione verrà eseguita ogni volta che il ramo di origine della richiesta pull cambia.

mergeStatus

PullRequestAsyncStatus

Stato corrente dell'unione della richiesta pull.

pullRequestId

integer

ID della richiesta pull.

remoteUrl

string

Per uso interno.

repository

GitRepository

Repository contenente il ramo di destinazione della richiesta pull.

reviewers

IdentityRefWithVote[]

Elenco di revisori sulla richiesta pull insieme allo stato dei loro voti.

sourceRefName

string

Nome del ramo di origine della richiesta pull.

status

PullRequestStatus

Stato della richiesta pull.

supportsIterations

boolean

Se true, questa richiesta pull supporta più iterazioni. Il supporto dell'iterazione significa che i singoli push nel ramo di origine della richiesta pull possono essere esaminati e i commenti lasciati in un'iterazione verranno rilevati tra iterazioni future.

targetRefName

string

Nome del ramo di destinazione della richiesta pull.

title

string

Titolo della richiesta pull.

url

string

Per uso interno.

workItemRefs

ResourceRef[]

Tutti i riferimenti all'elemento di lavoro associati a questa richiesta pull.

Risposte

Nome Tipo Descrizione
200 OK

GitPullRequest

operazione riuscita

Sicurezza

oauth2

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

Scopes

Nome Descrizione
vso.code_write Concede la possibilità di leggere, aggiornare ed eliminare codice sorgente, accedere ai metadati relativi ai commit, ai set di modifiche, ai rami e ad altri artefatti del controllo della versione. Concede inoltre la possibilità di creare e gestire richieste pull e revisioni del codice e di ricevere notifiche sugli eventi di controllo della versione tramite gli hook del servizio.

Esempio

Sample Request

POST https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullrequests?api-version=7.1-preview.1

{
  "sourceRefName": "refs/heads/npaulk/my_work",
  "targetRefName": "refs/heads/new_feature",
  "title": "A new feature",
  "description": "Adding a new feature",
  "reviewers": [
    {
      "id": "d6245f20-2af8-44f4-9451-8107cb2767db"
    }
  ]
}

Sample Response

{
  "repository": {
    "id": "3411ebc1-d5aa-464f-9615-0b527bc66719",
    "name": "2016_10_31",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719",
    "project": {
      "id": "a7573007-bbb3-4341-b726-0c4148a07853",
      "name": "2016_10_31",
      "description": "test project created on Halloween 2016",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/a7573007-bbb3-4341-b726-0c4148a07853",
      "state": "wellFormed",
      "revision": 7
    },
    "remoteUrl": "https://dev.azure.com/fabrikam/_git/2016_10_31"
  },
  "pullRequestId": 22,
  "codeReviewId": 22,
  "status": "active",
  "createdBy": {
    "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
    "displayName": "Normal Paulk",
    "uniqueName": "fabrikamfiber16@hotmail.com",
    "url": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
  },
  "creationDate": "2016-11-01T16:30:31.6655471Z",
  "title": "A new feature",
  "description": "Adding a new feature",
  "sourceRefName": "refs/heads/npaulk/my_work",
  "targetRefName": "refs/heads/new_feature",
  "mergeStatus": "queued",
  "mergeId": "f5fc8381-3fb2-49fe-8a0d-27dcc2d6ef82",
  "lastMergeSourceCommit": {
    "commitId": "b60280bc6e62e2f880f1b63c1e24987664d3bda3",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/b60280bc6e62e2f880f1b63c1e24987664d3bda3"
  },
  "lastMergeTargetCommit": {
    "commitId": "f47bbc106853afe3c1b07a81754bce5f4b8dbf62",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
  },
  "reviewers": [
    {
      "reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/reviewers/d6245f20-2af8-44f4-9451-8107cb2767db",
      "vote": 0,
      "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
      "displayName": "Normal Paulk",
      "uniqueName": "fabrikamfiber16@hotmail.com",
      "url": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
      "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719"
    },
    "workItems": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/workitems"
    },
    "sourceBranch": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/refs"
    },
    "targetBranch": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/refs"
    },
    "sourceCommit": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/b60280bc6e62e2f880f1b63c1e24987664d3bda3"
    },
    "targetCommit": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
    },
    "createdBy": {
      "href": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
    },
    "iterations": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/iterations"
    }
  },
  "supportsIterations": true,
  "artifactId": "vstfs:///Git/PullRequestId/a7573007-bbb3-4341-b726-0c4148a07853%2f3411ebc1-d5aa-464f-9615-0b527bc66719%2f22"
}

Definizioni

Nome Descrizione
ChangeCountDictionary
GitChange
GitCommitRef

Fornisce proprietà che descrivono un commit Git e i metadati associati.

GitForkRef

Informazioni su un riferimento fork.

GitPullRequest

Rappresenta tutti i dati associati a una richiesta pull.

GitPullRequestCompletionOptions

Preferenze su come deve essere completata la richiesta pull.

GitPullRequestMergeOptions

Opzioni utilizzate quando viene creata un'unione di richieste pull.

GitPullRequestMergeStrategy

Specificare la strategia utilizzata per unire la richiesta pull durante il completamento. Se MergeStrategy non è impostato su alcun valore, verrà creata un'unione no-FF se SquashMerge == false. Se MergeStrategy non è impostato su alcun valore, i commit della richiesta pull verranno schiacciati se SquashMerge == true. La proprietà SquashMerge è deprecata. È consigliabile impostare in modo esplicito MergeStrategy in tutti i casi. Se viene specificato un valore esplicito per MergeStrategy, la proprietà SquashMerge verrà ignorata.

GitPushRef
GitRepository
GitRepositoryRef
GitStatus

Questa classe contiene i metadati di un servizio o di un'estensione che registra uno stato.

GitStatusContext

Contesto di stato che identifica in modo univoco lo stato.

GitStatusState

Stato dello stato.

GitTemplate
GitUserDate

Informazioni utente e data per le operazioni Git.

IdentityRef
IdentityRefWithVote

Informazioni sull'identità, tra cui un voto su una richiesta pull.

ItemContent
ItemContentType
ProjectState

Stato del progetto.

ProjectVisibility

Visibilità del progetto.

PullRequestAsyncStatus

Stato corrente dell'unione della richiesta pull.

PullRequestMergeFailureType

Tipo di errore (se presente) dell'unione della richiesta pull.

PullRequestStatus

Stato della richiesta pull.

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

ResourceRef
TeamProjectCollectionReference

Oggetto di riferimento per un Oggetto TeamProjectCollection.

TeamProjectReference

Rappresenta un riferimento superficiale a un oggetto TeamProject.

VersionControlChangeType

Tipo di modifica apportata all'elemento.

WebApiTagDefinition

Rappresentazione di una definizione di tag inviata attraverso il cavo.

ChangeCountDictionary

GitChange

Nome Tipo Descrizione
changeId

integer

ID della modifica all'interno del gruppo di modifiche.

changeType

VersionControlChangeType

Tipo di modifica apportata all'elemento.

item

string

Versione corrente.

newContent

ItemContent

Contenuto dell'elemento dopo la modifica.

newContentTemplate

GitTemplate

Nuovo modello di contenuto da usare durante il push di nuove modifiche.

originalPath

string

Percorso originale dell'elemento se diverso dal percorso corrente.

sourceServerItem

string

Percorso dell'elemento nel server.

url

string

URL per recuperare l'elemento.

GitCommitRef

Fornisce proprietà che descrivono un commit Git e i metadati associati.

Nome Tipo Descrizione
_links

ReferenceLinks

Raccolta di collegamenti di riferimento REST correlati.

author

GitUserDate

Autore del commit.

changeCounts

ChangeCountDictionary

Conteggi dei tipi di modifiche (modifiche, eliminazioni e così via) inclusi nel commit.

changes

GitChange[]

Enumerazione delle modifiche incluse nel commit.

comment

string

Commento o messaggio del commit.

commentTruncated

boolean

Indica se il commento viene troncato dal messaggio di commento del commit Git completo.

commitId

string

ID (SHA-1) del commit.

commitTooManyChanges

boolean

Indica che il commit contiene troppe modifiche da visualizzare

committer

GitUserDate

Commiter del commit.

parents

string[]

Enumerazione degli ID commit padre per questo commit.

push

GitPushRef

Push associato a questo commit.

remoteUrl

string

Percorso URL remoto per il commit.

statuses

GitStatus[]

Elenco di metadati di stato dai servizi e dalle estensioni che possono associare informazioni aggiuntive al commit.

url

string

URL REST per questa risorsa.

workItems

ResourceRef[]

Elenco di elementi di lavoro associati al commit.

GitForkRef

Informazioni su un riferimento fork.

Nome Tipo Descrizione
_links

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

creator

IdentityRef

isLocked

boolean

isLockedBy

IdentityRef

name

string

objectId

string

peeledObjectId

string

repository

GitRepository

ID del repository del fork.

statuses

GitStatus[]

Questa classe contiene i metadati di un servizio o di un'estensione che registra uno stato.

url

string

GitPullRequest

Rappresenta tutti i dati associati a una richiesta pull.

Nome Tipo Descrizione
_links

ReferenceLinks

Collegamenti ad altri oggetti correlati.

artifactId

string

Stringa che identifica in modo univoco questa richiesta pull. Per generare un ID artefatto per una richiesta pull, usare questo modello: vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}

autoCompleteSetBy

IdentityRef

Se impostato, il completamento automatico è abilitato per questa richiesta pull e questa è l'identità che l'ha abilitata.

closedBy

IdentityRef

Utente che ha chiuso la richiesta pull.

closedDate

string

Data di chiusura della richiesta pull (completata, abbandonata o unita esternamente).

codeReviewId

integer

ID di revisione del codice della richiesta pull. Per uso interno.

commits

GitCommitRef[]

Commit contenuti nella richiesta pull.

completionOptions

GitPullRequestCompletionOptions

Opzioni che influiscono sulla modalità di unione della richiesta pull al termine.

completionQueueTime

string

Data più recente in cui la richiesta pull ha immesso la coda da completare. Per uso interno.

createdBy

IdentityRef

Identità dell'utente che ha creato la richiesta pull.

creationDate

string

Data di creazione della richiesta pull.

description

string

Descrizione della richiesta pull.

forkSource

GitForkRef

Se si tratta di una richiesta pull da una copia tramite fork, verranno contenute informazioni sulla relativa origine.

hasMultipleMergeBases

boolean

Avviso di più mergebase

isDraft

boolean

Bozza/richiesta pull WIP.

labels

WebApiTagDefinition[]

Etichette associate alla richiesta pull.

lastMergeCommit

GitCommitRef

Commit del merge della richiesta pull più recente. Se vuoto, l'unione più recente è in corso o ha avuto esito negativo.

lastMergeSourceCommit

GitCommitRef

Commit all'inizio del ramo di origine al momento dell'ultima unione della richiesta pull.

lastMergeTargetCommit

GitCommitRef

Commit all'inizio del ramo di destinazione al momento dell'ultima unione delle richieste pull.

mergeFailureMessage

string

Se impostato, l'unione delle richieste pull non è riuscita per questo motivo.

mergeFailureType

PullRequestMergeFailureType

Tipo di errore (se presente) dell'unione della richiesta pull.

mergeId

string

ID del processo utilizzato per eseguire l'unione della richiesta pull. Per uso interno.

mergeOptions

GitPullRequestMergeOptions

Opzioni utilizzate quando viene eseguita l'unione delle richieste pull. Queste opzioni sono separate dalle opzioni di completamento perché il completamento viene eseguito una sola volta e una nuova unione verrà eseguita ogni volta che il ramo di origine della richiesta pull cambia.

mergeStatus

PullRequestAsyncStatus

Stato corrente dell'unione della richiesta pull.

pullRequestId

integer

ID della richiesta pull.

remoteUrl

string

Per uso interno.

repository

GitRepository

Repository contenente il ramo di destinazione della richiesta pull.

reviewers

IdentityRefWithVote[]

Elenco di revisori nella richiesta pull insieme allo stato dei voti.

sourceRefName

string

Nome del ramo di origine della richiesta pull.

status

PullRequestStatus

Stato della richiesta pull.

supportsIterations

boolean

Se true, questa richiesta pull supporta più iterazioni. Il supporto per l'iterazione significa che i singoli push nel ramo di origine della richiesta pull possono essere esaminati e i commenti lasciati in un'iterazione verranno monitorati nelle iterazioni future.

targetRefName

string

Nome del ramo di destinazione della richiesta pull.

title

string

Titolo della richiesta pull.

url

string

Per uso interno.

workItemRefs

ResourceRef[]

Tutti i riferimenti agli elementi di lavoro associati a questa richiesta pull.

GitPullRequestCompletionOptions

Preferenze su come deve essere completata la richiesta pull.

Nome Tipo Descrizione
autoCompleteIgnoreConfigIds

integer[]

Elenco degli ID di configurazione dei criteri che non devono attendere il completamento automatico. Si applica solo ai criteri facoltativi (isBlocking == false). Il completamento automatico attende sempre i criteri richiesti (isBlocking == true).

bypassPolicy

boolean

Se true, i criteri verranno ignorati in modo esplicito mentre la richiesta pull viene completata.

bypassReason

string

Se i criteri vengono ignorati, questo motivo viene archiviato come motivo per cui è stato usato il bypass.

deleteSourceBranch

boolean

Se true, il ramo di origine della richiesta pull verrà eliminato dopo il completamento.

mergeCommitMessage

string

Se impostato, verrà usato come messaggio di commit del commit del commit.

mergeStrategy

GitPullRequestMergeStrategy

Specificare la strategia utilizzata per unire la richiesta pull durante il completamento. Se MergeStrategy non è impostato su alcun valore, verrà creata un'unione no-FF se SquashMerge == false. Se MergeStrategy non è impostato su alcun valore, i commit della richiesta pull verranno schiacciati se SquashMerge == true. La proprietà SquashMerge è deprecata. È consigliabile impostare in modo esplicito MergeStrategy in tutti i casi. Se viene specificato un valore esplicito per MergeStrategy, la proprietà SquashMerge verrà ignorata.

squashMerge

boolean

SquashMerge è deprecato. È consigliabile impostare in modo esplicito il valore di MergeStrategy. Se MergeStrategy è impostato su qualsiasi valore, il valore SquashMerge verrà ignorato. Se MergeStrategy non è impostato, la strategia di merge sarà no-fast-forward se questo flag è false o squash se true.

transitionWorkItems

boolean

Se true, si tenterà di eseguire la transizione di tutti gli elementi di lavoro collegati alla richiesta pull nello stato logico successivo (ad esempio Active -> Resolved)

triggeredByAutoComplete

boolean

Se true, il tentativo di completamento corrente è stato attivato tramite il completamento automatico. Per uso interno.

GitPullRequestMergeOptions

Opzioni utilizzate quando viene creata un'unione di richieste pull.

Nome Tipo Descrizione
conflictAuthorshipCommits

boolean

Se true, le risoluzioni dei conflitti applicate durante l'unione verranno inserite in commit separati per mantenere le informazioni di autorizzazione per git blame e così via.

detectRenameFalsePositives

boolean

disableRenames

boolean

Se true, il rilevamento della ridenominazione non verrà eseguito durante l'unione.

GitPullRequestMergeStrategy

Specificare la strategia utilizzata per unire la richiesta pull durante il completamento. Se MergeStrategy non è impostato su alcun valore, verrà creata un'unione no-FF se SquashMerge == false. Se MergeStrategy non è impostato su alcun valore, i commit della richiesta pull verranno schiacciati se SquashMerge == true. La proprietà SquashMerge è deprecata. È consigliabile impostare in modo esplicito MergeStrategy in tutti i casi. Se viene specificato un valore esplicito per MergeStrategy, la proprietà SquashMerge verrà ignorata.

Nome Tipo Descrizione
noFastForward

string

Unione a due elementi padre, senza avanzamento rapido. Il ramo di origine rimane invariato. Questo è il comportamento predefinito.

rebase

string

Ribasere il ramo di origine sopra il commit HEAD del ramo di destinazione e inoltrare rapidamente il ramo di destinazione. Il ramo di origine viene aggiornato durante l'operazione di ribase.

rebaseMerge

string

Ribasere il ramo di origine sopra il commit HEAD del ramo di destinazione e creare un'unione bidirezionale senza inoltro rapido. Il ramo di origine viene aggiornato durante l'operazione di ribase.

squash

string

Inserire tutte le modifiche dalla richiesta pull in un commit padre singolo.

GitPushRef

Nome Tipo Descrizione
_links

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

date

string

pushId

integer

pushedBy

IdentityRef

url

string

GitRepository

Nome Tipo Descrizione
_links

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

defaultBranch

string

id

string

isDisabled

boolean

True se il repository è disabilitato. False in caso contrario.

isFork

boolean

True se il repository è stato creato come fork.

isInMaintenance

boolean

True se il repository è in fase di manutenzione. False in caso contrario.

name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Rappresenta un riferimento superficiale a un oggetto TeamProject.

remoteUrl

string

size

integer

Dimensioni compresse (byte) del repository.

sshUrl

string

url

string

validRemoteUrls

string[]

webUrl

string

GitRepositoryRef

Nome Tipo Descrizione
collection

TeamProjectCollectionReference

Raccolta di progetti team in cui si trova questo fork

id

string

isFork

boolean

True se il repository è stato creato come fork

name

string

project

TeamProjectReference

Rappresenta un riferimento superficiale a un oggetto TeamProject.

remoteUrl

string

sshUrl

string

url

string

GitStatus

Questa classe contiene i metadati di un servizio o di un'estensione che registra uno stato.

Nome Tipo Descrizione
_links

ReferenceLinks

Collegamenti di riferimento.

context

GitStatusContext

Contesto dello stato.

createdBy

IdentityRef

Identità che ha creato lo stato.

creationDate

string

Data e ora di creazione dello stato.

description

string

Descrizione dello stato. Descrive in genere lo stato corrente dello stato.

id

integer

Identificatore di stato.

state

GitStatusState

Stato dello stato.

targetUrl

string

URL con i dettagli sullo stato.

updatedDate

string

Data e ora dell'ultimo aggiornamento dello stato.

GitStatusContext

Contesto di stato che identifica in modo univoco lo stato.

Nome Tipo Descrizione
genre

string

Genere dello stato. In genere, il nome del servizio o dello strumento che genera lo stato può essere vuoto.

name

string

L'identificatore del nome dello stato non può essere null o vuoto.

GitStatusState

Stato dello stato.

Nome Tipo Descrizione
error

string

Stato con un errore.

failed

string

Stato non riuscito.

notApplicable

string

Lo stato non è applicabile all'oggetto di destinazione.

notSet

string

Stato non impostato. Stato predefinito.

pending

string

Stato in sospeso.

succeeded

string

Stato completato.

GitTemplate

Nome Tipo Descrizione
name

string

Nome del modello

type

string

Tipo del modello

GitUserDate

Informazioni utente e data per le operazioni Git.

Nome Tipo Descrizione
date

string

Data dell'operazione Git.

email

string

Email indirizzo dell'utente che esegue l'operazione Git.

imageUrl

string

URL dell'avatar dell'utente.

name

string

Nome dell'utente che esegue l'operazione Git.

IdentityRef

Nome Tipo Descrizione
_links

ReferenceLinks

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

descriptor

string

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

directoryAlias

string

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

displayName

string

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

id

string

imageUrl

string

Deprecato : disponibile nella voce "avatar" del dizionario IdentityRef "_links"

inactive

boolean

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

isAadIdentity

boolean

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

isContainer

boolean

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

isDeletedInOrigin

boolean

profileUrl

string

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

uniqueName

string

Deprecato: usare invece Domain+PrincipalName

url

string

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

IdentityRefWithVote

Informazioni sull'identità, tra cui un voto su una richiesta pull.

Nome Tipo Descrizione
_links

ReferenceLinks

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

descriptor

string

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

directoryAlias

string

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

displayName

string

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

hasDeclined

boolean

Indica se il revisore ha rifiutato di esaminare questa richiesta pull.

id

string

imageUrl

string

Deprecato : disponibile nella voce "avatar" del dizionario IdentityRef "_links"

inactive

boolean

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

isAadIdentity

boolean

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

isContainer

boolean

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

isDeletedInOrigin

boolean

isFlagged

boolean

Indica se il revisore è contrassegnato per l'attenzione su questa richiesta pull.

isReapprove

boolean

Indica se il voto approvato deve comunque essere gestito anche se il voto non è stato modificato.

isRequired

boolean

Indica se si tratta di un revisore obbligatorio per questa richiesta pull.
I rami possono avere criteri che richiedono revisori specifici per le richieste pull.

profileUrl

string

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

reviewerUrl

string

URL per recuperare informazioni su questa identità

uniqueName

string

Deprecato: usare invece Domain+PrincipalName

url

string

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

vote

integer

Votare su una richiesta pull:
10 - approvato 5 - approvato con suggerimenti 0 - nessun voto -5 - in attesa dell'autore -10 - rifiutato

votedFor

IdentityRefWithVote[]

Gruppi o team a cui ha contribuito il revisore.
I gruppi e i team possono essere revisori nelle richieste pull, ma non possono votare direttamente. Quando un membro del gruppo o del team vota, tale voto viene inserito nel gruppo o nel voto del team. VotedFor è un elenco di tali voti.

ItemContent

Nome Tipo Descrizione
content

string

contentType

ItemContentType

ItemContentType

Nome Tipo Descrizione
base64Encoded

string

rawText

string

ProjectState

Stato del progetto.

Nome Tipo Descrizione
all

string

Tutti i progetti indipendentemente dallo stato tranne Deleted.

createPending

string

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

deleted

string

Il progetto è stato eliminato.

deleting

string

Il progetto si trova nel processo di eliminazione.

new

string

Il progetto è in fase di creazione.

unchanged

string

Il progetto non è stato modificato.

wellFormed

string

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

ProjectVisibility

Visibilità del progetto.

Nome Tipo Descrizione
private

string

Il progetto è visibile solo agli utenti con accesso esplicito.

public

string

Il progetto è visibile a tutti.

PullRequestAsyncStatus

Stato corrente dell'unione della richiesta pull.

Nome Tipo Descrizione
conflicts

string

Unione della richiesta pull non riuscita a causa di conflitti.

failure

string

Unione della richiesta pull non riuscita.

notSet

string

Lo stato non è impostato. Stato predefinito.

queued

string

L'unione della richiesta pull viene accodata.

rejectedByPolicy

string

Unione della richiesta pull rifiutata dai criteri.

succeeded

string

Unione della richiesta pull completata.

PullRequestMergeFailureType

Tipo di errore (se presente) dell'unione della richiesta pull.

Nome Tipo Descrizione
caseSensitive

string

Unione della richiesta pull non riuscita a causa della mancata corrispondenza tra maiuscole e minuscole.

none

string

Il tipo non è impostato. Tipo predefinito.

objectTooLarge

string

Unione richiesta pull non riuscita a causa di un oggetto troppo grande.

unknown

string

Tipo di errore di unione della richiesta pull sconosciuto.

PullRequestStatus

Stato della richiesta pull.

Nome Tipo Descrizione
abandoned

string

La richiesta pull viene abbandonata.

active

string

La richiesta pull è attiva.

all

string

Usato nei criteri di ricerca della richiesta pull per includere tutti gli stati.

completed

string

La richiesta pull viene completata.

notSet

string

Stato non impostato. Stato predefinito.

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

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

ResourceRef

Nome Tipo Descrizione
id

string

url

string

TeamProjectCollectionReference

Oggetto di riferimento per un Oggetto TeamProjectCollection.

Nome Tipo Descrizione
avatarUrl

string

Url dell'avatar della raccolta.

id

string

ID raccolta.

name

string

Nome raccolta.

url

string

URL REST raccolta.

TeamProjectReference

Rappresenta un riferimento superficiale a un oggetto TeamProject.

Nome Tipo Descrizione
abbreviation

string

Abbreviazione del progetto.

defaultTeamImageUrl

string

URL dell'immagine di identità del team predefinita.

description

string

Descrizione del progetto (se presente).

id

string

Identificatore del progetto.

lastUpdateTime

string

Ora dell'ultimo aggiornamento del progetto.

name

string

Nome progetto.

revision

integer

Revisione del progetto.

state

ProjectState

Stato del progetto.

url

string

URL della versione completa dell'oggetto.

visibility

ProjectVisibility

Visibilità del progetto.

VersionControlChangeType

Tipo di modifica apportata all'elemento.

Nome Tipo Descrizione
add

string

all

string

branch

string

delete

string

edit

string

encoding

string

lock

string

merge

string

none

string

property

string

rename

string

rollback

string

sourceRename

string

targetRename

string

undelete

string

WebApiTagDefinition

Rappresentazione di una definizione di tag inviata attraverso il cavo.

Nome Tipo Descrizione
active

boolean

Indica se la definizione del tag è attiva o meno.

id

string

ID della definizione del tag.

name

string

Nome della definizione del tag.

url

string

URL della risorsa per la definizione del tag.