Commits - Get Changes

Référence

Service:: Git

API Version:: 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

With optional parameters:

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
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

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

Sample Request

HTTP

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

Sample Response

Status code:: 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

GitChange

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

Nom	Type	Description
changeCounts	ChangeCountDictionary
changes	GitChange[]

GitTemplate

Nom	Type	Description
name	string	Nom du modèle
type	string	Type du modèle

ItemContent

Nom	Type	Description
content	string
contentType	ItemContentType

ItemContentType

Nom	Type	Description
base64Encoded	string
rawText	string

VersionControlChangeType

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

Nom	Type	Description
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

Partager via