Partager via

Commits - Get Changes

  • Référence
Service:
Git
Version d'API:
5.0

Récupérer les modifications pour un commit particulier.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commits/{commitId}/changes?api-version=5.0
Avec des paramètres facultatifs: 
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commits/{commitId}/changes?top={top}&skip={skip}&api-version=5.0

Paramètres URI

Nom Dans Obligatoire Type Description
commitId
 path True

string

ID du commit.
organization
 path True

string

Nom de l’organisation Azure DevOps.
repositoryId
 path True

string

ID ou nom convivial du dépôt. Pour utiliser le nom convivial, projectId doit également être spécifié.
project
 path

string

ID de projet ou nom du projet
api-version
 query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 5.0 » pour utiliser cette version de l’API.
skip
 query

integer

int32

Nombre de modifications à ignorer.
top
 query

integer

int32

Nombre maximal de modifications à retourner.

Réponses

Nom Type Description
200 OK

GitCommitChanges

opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom Description
vso.code Permet de lire le code source et les métadonnées sur les commits, les ensembles de modifications, les branches et d’autres artefacts de contrôle de version. Accorde également la possibilité de rechercher du code et d’être informé des événements de contrôle de version via des hooks de service.

Exemples

With changes

Exemple de requête

GET https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/be67f8871a4d2c75f13a51c1d3c30ac0d74d4ef4/changes?top=2&skip=10&api-version=5.0

Exemple de réponse

Code d’état:
200 
{
  "changeCounts": {
    "Add": 456
  },
  "changes": [
    {
      "item": {
        "gitObjectType": "blob",
        "path": "/MyWebSite/MyWebSite/favicon.ico",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/MyWebSite/favicon.ico?versionType=Commit"
      },
      "changeType": "add"
    },
    {
      "item": {
        "gitObjectType": "tree",
        "path": "/MyWebSite/MyWebSite/fonts",
        "isFolder": true,
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/items/MyWebSite/MyWebSite/fonts?versionType=Commit"
      },
      "changeType": "add"
    }
  ]
}

Définitions

Nom Description
ChangeCountDictionary
GitChange
GitCommitChanges
GitTemplate
ItemContent
ItemContentType
VersionControlChangeType

Type de modification apportée à l’élément.

ChangeCountDictionary

Object

GitChange

Object
Nom Type Description
changeId

integer

ID de la modification dans le groupe de modifications.
changeType

VersionControlChangeType

Type de modification apportée à l’élément.
item

string

Version actuelle.
newContent

ItemContent

Contenu de l’élément après la modification.
newContentTemplate

GitTemplate

Nouveau modèle de contenu à utiliser lors de l’envoi de nouvelles modifications.
originalPath

string

Chemin d’accès d’origine de l’élément s’il est différent du chemin d’accès actuel.
sourceServerItem

string

Chemin de l’élément sur le serveur.
url

string

URL pour récupérer l’élément.

GitCommitChanges

Object
Nom Type Description
changeCounts

ChangeCountDictionary

changes

GitChange[]

GitTemplate

Object
Nom Type Description
name

string

Nom du modèle
type

string

Type du modèle

ItemContent

Object
Nom Type Description
content

string

contentType

ItemContentType

ItemContentType

Enumeration
Valeur Description
base64Encoded
rawText

VersionControlChangeType

Enumeration

Type de modification apportée à l’élément.

Valeur Description
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete