Condividi tramite

Commits - Get Commits Batch

  • Riferimento
Servizio:
Git
Versione API:
7.1

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

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commitsbatch?api-version=7.1
Con parametri facoltativi: 
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commitsbatch?$skip={$skip}&$top={$top}&includeStatuses={includeStatuses}&api-version=7.1

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
 path True

string

Nome dell'organizzazione di Azure DevOps.
repositoryId
 path True

string

Nome o ID del repository.
project
 path

string

ID progetto o nome progetto
api-version
 query True

string

Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API.
$skip
 query

integer (int32)

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

integer (int32)

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

boolean

True per includere informazioni aggiuntive sullo stato del commit.

Corpo della richiesta

Nome Tipo Descrizione
$skip

integer (int32)

Numero di voci da ignorare
$top

integer (int32)

Numero massimo di voci da recuperare
author

string

Alias o nome visualizzato dell'autore
compareVersion

GitVersionDescriptor

Applicabile solo quando ItemVersion specificato. Se specificato, iniziare a camminare la cronologia a partire da questo commit.
excludeDeletes

boolean

Si applica solo quando viene specificato un itemPath. Determina se escludere le voci di eliminazione del percorso specificato.
fromCommitId

string

Se specificato, un limite inferiore per il filtro esegue i commit in ordine alfabetico
fromDate

string

Se specificato, includere solo le voci di cronologia create dopo questa data (stringa)
historyMode

GitHistoryMode

Quale modalità di cronologia Git deve essere usata. Questo vale solo per i criteri di ricerca quando Ids = null e viene specificato itemPath.
ids

string[]

Se specificato, specifica gli ID commit esatti dei commit da recuperare. Non può essere combinato con altri parametri.
includeLinks

boolean

Indica se includere il campo _links sui riferimenti superficiali
includePushData

boolean

Indica se includere le informazioni push
includeUserImageUrl

boolean

Indica se includere l'URL dell'immagine per i commiter e gli autori
includeWorkItems

boolean

Indica se includere elementi di lavoro collegati
itemPath

string

Percorso dell'elemento in cui eseguire la ricerca
itemVersion

GitVersionDescriptor

Se specificato, identifica il commit o il ramo in cui eseguire la ricerca
showOldestCommitsFirst

boolean

Se abilitata, questa opzione ignorerà i parametri itemVersion e compareVersion
toCommitId

string

Se specificato, un limite superiore per filtrare i commit in ordine alfabetico
toDate

string

Se specificato, includere solo le voci della cronologia create prima di questa data (stringa)
user

string

Alias o nome visualizzato del commiter

Risposte

Nome Tipo Descrizione
200 OK

GitCommitRef[]

operazione riuscita

Sicurezza

oauth2

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Ambiti

Nome Descrizione
vso.code Concede la possibilità di leggere il codice sorgente e i metadati relativi a commit, insiemi di modifiche, rami e altri artefatti del controllo della versione. Concede inoltre la possibilità di cercare il codice e ricevere notifiche sugli eventi di controllo della versione tramite hook del servizio.

Esempio

Commits between two versions
Commits by a list of commit IDs

Commits between two versions

Esempio di richiesta

POST https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commitsbatch?api-version=7.1

{
  "itemVersion": {
    "versionType": "branch",
    "version": "develop"
  },
  "compareVersion": {
    "versionType": "branch",
    "version": "master"
  }
}

Risposta di esempio

Codice di stato:
200 
{
  "count": 17,
  "value": [
    {
      "commitId": "23d0bc5b128a10056dc68afece360d8a0fabb014",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/23d0bc5b128a10056dc68afece360d8a0fabb014",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/23d0bc5b128a10056dc68afece360d8a0fabb014"
    },
    {
      "commitId": "fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f"
    },
    {
      "commitId": "0360c963d7d86d040e9c33bba836feab14da4ad3",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-10T19:42:13Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-10T19:42:13Z"
      },
      "comment": "Fix for hello world class",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/0360c963d7d86d040e9c33bba836feab14da4ad3",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/0360c963d7d86d040e9c33bba836feab14da4ad3"
    },
    {
      "commitId": "097d82b8aeabe493bf4c3553d320ae2529bba591",
      "author": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-06-09T21:43:25Z"
      },
      "committer": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-06-09T21:43:25Z"
      },
      "comment": "fix registration page",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/097d82b8aeabe493bf4c3553d320ae2529bba591",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/097d82b8aeabe493bf4c3553d320ae2529bba591"
    },
    {
      "commitId": "33b55f7cb7e7e245323987634f960cf4a6e6bc74",
      "author": {
        "name": "Will Smythe",
        "email": "wismythe@microsoft.com",
        "date": "2014-05-02T19:17:05Z"
      },
      "committer": {
        "name": "Will Smythe",
        "email": "wismythe@microsoft.com",
        "date": "2014-05-02T19:17:05Z"
      },
      "comment": "Fixed bug in web.config file",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/33b55f7cb7e7e245323987634f960cf4a6e6bc74",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/33b55f7cb7e7e245323987634f960cf4a6e6bc74"
    },
    {
      "commitId": "aad331d8d3b131fa9ae03cf5e53965b51942618a",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-04-14T21:34:52Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-04-14T21:34:52Z"
      },
      "comment": "Fixed bug for address validation.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/aad331d8d3b131fa9ae03cf5e53965b51942618a",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/aad331d8d3b131fa9ae03cf5e53965b51942618a"
    },
    {
      "commitId": "7c18355d8c2d946c5e1ce7a56f49653854445a1a",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-28T17:05:58Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-28T17:05:58Z"
      },
      "comment": "Added validation logic.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/7c18355d8c2d946c5e1ce7a56f49653854445a1a",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/7c18355d8c2d946c5e1ce7a56f49653854445a1a"
    },
    {
      "commitId": "cdaeef70a358ede7b4dc7b4a089f3853f37a6d2c",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-27T19:51:11Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-27T19:51:11Z"
      },
      "comment": "Added validation logic for zip code.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/cdaeef70a358ede7b4dc7b4a089f3853f37a6d2c",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/cdaeef70a358ede7b4dc7b4a089f3853f37a6d2c"
    },
    {
      "commitId": "ef837766c5eb3ae81a4c663d36bf95a8aed91312",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T20:25:39Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T20:25:39Z"
      },
      "comment": "Add validation code for zip code values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/ef837766c5eb3ae81a4c663d36bf95a8aed91312",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/ef837766c5eb3ae81a4c663d36bf95a8aed91312"
    },
    {
      "commitId": "bd73638408daff89bcdac549a5a3396c9a7ce9dd",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:56:21Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:56:21Z"
      },
      "comment": "Added validation logic for zip code values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/bd73638408daff89bcdac549a5a3396c9a7ce9dd",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/bd73638408daff89bcdac549a5a3396c9a7ce9dd"
    },
    {
      "commitId": "03bea1cebffa5726da0e3c0bc1487796d0dd0ee8",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:42:24Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:42:24Z"
      },
      "comment": "Added validation logic for address values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/03bea1cebffa5726da0e3c0bc1487796d0dd0ee8",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/03bea1cebffa5726da0e3c0bc1487796d0dd0ee8"
    },
    {
      "commitId": "c093714168cdd190c1e171a803e996d685454352",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:37:32Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:37:32Z"
      },
      "comment": "Added validation logic for zip code values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/c093714168cdd190c1e171a803e996d685454352",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/c093714168cdd190c1e171a803e996d685454352"
    },
    {
      "commitId": "3d203ea73427cec36b77a3a5a2e4f1f8ba7de170",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:00:14Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:00:14Z"
      },
      "comment": "Added code.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/3d203ea73427cec36b77a3a5a2e4f1f8ba7de170",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/3d203ea73427cec36b77a3a5a2e4f1f8ba7de170"
    },
    {
      "commitId": "1eea03b2ad9f14a5e7297c1307e36c980eb910ea",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T16:17:11Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T16:17:11Z"
      },
      "comment": "Added code.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/1eea03b2ad9f14a5e7297c1307e36c980eb910ea",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/1eea03b2ad9f14a5e7297c1307e36c980eb910ea"
    },
    {
      "commitId": "c40b5ceb9c77096b9f59e6a9193dae527bda79d9",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:54:10Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:54:10Z"
      },
      "comment": "Added method for submitting new customer addrress.",
      "changeCounts": {
        "Edit": 2
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/c40b5ceb9c77096b9f59e6a9193dae527bda79d9",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/c40b5ceb9c77096b9f59e6a9193dae527bda79d9"
    },
    {
      "commitId": "6ff5e8f6256cc58aa062dbb1e096c1e3b3435ebe",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:50:08Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:50:08Z"
      },
      "comment": "Adding customer address module project",
      "changeCounts": {
        "Add": 12
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/6ff5e8f6256cc58aa062dbb1e096c1e3b3435ebe",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/6ff5e8f6256cc58aa062dbb1e096c1e3b3435ebe"
    },
    {
      "commitId": "03b1b831e41df536d836c95e2f68a42db4f3e0db",
      "author": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-02-10T21:52:47Z"
      },
      "committer": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-02-10T21:52:47Z"
      },
      "comment": "Add Hello World to TFS",
      "changeCounts": {
        "Add": 5
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/03b1b831e41df536d836c95e2f68a42db4f3e0db",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/03b1b831e41df536d836c95e2f68a42db4f3e0db"
    }
  ]
}

Commits by a list of commit IDs

Esempio di richiesta

POST https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commitsbatch?api-version=7.1

{
  "ids": [
    "23d0bc5b128a10056dc68afece360d8a0fabb014",
    "fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f"
  ]
}

Risposta di esempio

Codice di stato:
200 
{
  "count": 2,
  "value": [
    {
      "commitId": "23d0bc5b128a10056dc68afece360d8a0fabb014",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/23d0bc5b128a10056dc68afece360d8a0fabb014",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/23d0bc5b128a10056dc68afece360d8a0fabb014"
    },
    {
      "commitId": "fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f"
    }
  ]
}

Definizioni

Nome Descrizione
ChangeCountDictionary
GitChange
GitCommitRef

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

Quale modalità di cronologia Git deve essere usata. Questo vale solo per i criteri di ricerca quando Ids = null e viene specificato itemPath.
GitPushRef
GitQueryCommitsCriteria
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.
GitVersionDescriptor
GitVersionOptions

Opzioni di versione: specificare modificatori aggiuntivi per la versione (ad esempio Precedente)
GitVersionType

Tipo di versione (ramo, tag o commit). Determina la modalità di interpretazione dell'ID
IdentityRef
ItemContent
ItemContentType
ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.
ResourceRef
VersionControlChangeType

Tipo di modifica apportata all'elemento.

ChangeCountDictionary

Object

GitChange

Object
Nome Tipo Descrizione
changeId

integer (int32)

ID della modifica all'interno del gruppo di modifiche.
changeType

VersionControlChangeType

Tipo di modifica apportata all'elemento.
item

string (T)

Versione corrente.
newContent

ItemContent

Contenuto dell'elemento dopo la modifica.
newContentTemplate

GitTemplate

Nuovo modello di contenuto da usare durante il push delle 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

Object

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

Conteggio dei tipi di modifiche (modifiche, eliminazioni e così via) incluse 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 DELL'URL remoto al commit.
statuses

GitStatus[]

Elenco dei metadati di stato dei servizi e delle 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.

GitHistoryMode

Enumerazione

Quale modalità di cronologia Git deve essere usata. Questo vale solo per i criteri di ricerca quando Ids = null e viene specificato itemPath.

Valore Descrizione
firstParent

Modalità cronologia usata da git log --first-parent
fullHistory

Modalità cronologia usata da git log --full-history
fullHistorySimplifyMerges

Modalità cronologia usata da git log --full-history --simplify-merges
simplifiedHistory

Modalità di cronologia utilizzata da git log. Si tratta dell'impostazione predefinita.

GitPushRef

Object
Nome Tipo Descrizione
_links

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.
date

string (date-time)

pushId

integer (int32)

pushedBy

IdentityRef

url

string

GitQueryCommitsCriteria

Object
Nome Tipo Descrizione
$skip

integer (int32)

Numero di voci da ignorare
$top

integer (int32)

Numero massimo di voci da recuperare
author

string

Alias o nome visualizzato dell'autore
compareVersion

GitVersionDescriptor

Applicabile solo quando ItemVersion specificato. Se specificato, iniziare a camminare la cronologia a partire da questo commit.
excludeDeletes

boolean

Si applica solo quando viene specificato un itemPath. Determina se escludere le voci di eliminazione del percorso specificato.
fromCommitId

string

Se specificato, un limite inferiore per il filtro esegue i commit in ordine alfabetico
fromDate

string

Se specificato, includere solo le voci di cronologia create dopo questa data (stringa)
historyMode

GitHistoryMode

Quale modalità di cronologia Git deve essere usata. Questo vale solo per i criteri di ricerca quando Ids = null e viene specificato itemPath.
ids

string[]

Se specificato, specifica gli ID commit esatti dei commit da recuperare. Non può essere combinato con altri parametri.
includeLinks

boolean

Indica se includere il campo _links sui riferimenti superficiali
includePushData

boolean

Indica se includere le informazioni push
includeUserImageUrl

boolean

Indica se includere l'URL dell'immagine per i commiter e gli autori
includeWorkItems

boolean

Indica se includere elementi di lavoro collegati
itemPath

string

Percorso dell'elemento in cui eseguire la ricerca
itemVersion

GitVersionDescriptor

Se specificato, identifica il commit o il ramo in cui eseguire la ricerca
showOldestCommitsFirst

boolean

Se abilitata, questa opzione ignorerà i parametri itemVersion e compareVersion
toCommitId

string

Se specificato, un limite superiore per filtrare i commit in ordine alfabetico
toDate

string

Se specificato, includere solo le voci della cronologia create prima di questa data (stringa)
user

string

Alias o nome visualizzato del commiter

GitStatus

Object

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 (date-time)

Data e ora di creazione dello stato.
description

string

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

integer (int32)

Identificatore di stato.
state

GitStatusState

Stato dello stato.
targetUrl

string

URL con i dettagli sullo stato.
updatedDate

string (date-time)

Data e ora dell'ultimo aggiornamento dello stato.

GitStatusContext

Object

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

Enumerazione

Stato dello stato.

Valore Descrizione
error

Stato con un errore.
failed

Stato non riuscito.
notApplicable

Lo stato non è applicabile all'oggetto di destinazione.
notSet

Stato non impostato. Stato predefinito.
pending

Stato in sospeso.
succeeded

Stato completato.

GitTemplate

Object
Nome Tipo Descrizione
name

string

Nome del modello
type

string

Tipo di modello

GitUserDate

Object

Informazioni utente e data per le operazioni Git.

Nome Tipo Descrizione
date

string (date-time)

Data dell'operazione Git.
email

string

Indirizzo di posta elettronica dell'utente che esegue l'operazione Git.
imageUrl

string

URL per l'avatar dell'utente.
name

string

Nome dell'utente che esegue l'operazione Git.

GitVersionDescriptor

Object
Nome Tipo Descrizione
version

string

Identificatore della stringa di versione (nome di tag/ramo, SHA1 di commit)
versionOptions

GitVersionOptions

Opzioni di versione: specificare modificatori aggiuntivi per la versione (ad esempio Precedente)
versionType

GitVersionType

Tipo di versione (ramo, tag o commit). Determina la modalità di interpretazione dell'ID

GitVersionOptions

Enumerazione

Opzioni di versione: specificare modificatori aggiuntivi per la versione (ad esempio Precedente)

Valore Descrizione
firstParent

Primo elemento padre del commit (HEAD^)
none

Non specificato
previousChange

Eseguire il commit dell'elemento modificato prima della versione corrente

GitVersionType

Enumerazione

Tipo di versione (ramo, tag o commit). Determina la modalità di interpretazione dell'ID

Valore Descrizione
branch

Interpretare la versione come nome di ramo
commit

Interpretare la versione come ID commit (SHA1)
tag

Interpretare la versione come nome di tag

IdentityRef

Object
Nome Tipo Descrizione
_links

ReferenceLinks

Questo campo contiene zero o più collegamenti interessanti sull'oggetto grafico. Questi collegamenti possono essere richiamati per ottenere relazioni aggiuntive o informazioni più dettagliate sull'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 soggetto del 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 IdentityRef "_links"
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 "_links" GraphUser
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.

ItemContent

Object
Nome Tipo Descrizione
content

string

contentType

ItemContentType

ItemContentType

Enumerazione
Valore Descrizione
base64Encoded
rawText
Object

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

Object
Nome Tipo Descrizione
id

string

url

string

VersionControlChangeType

Enumerazione

Tipo di modifica apportata all'elemento.

Valore Descrizione
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete