Partager via


Builds - Get Changes Between Builds

Obtient les modifications apportées au dépôt entre deux builds données.

GET https://dev.azure.com/{organization}/{project}/_apis/build/changes?api-version=7.1-preview.2
GET https://dev.azure.com/{organization}/{project}/_apis/build/changes?fromBuildId={fromBuildId}&toBuildId={toBuildId}&$top={$top}&api-version=7.1-preview.2

Paramètres URI

Nom Dans Obligatoire Type Description
organization
path True

string

Nom de l’organisation Azure DevOps.

project
path True

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 « 7.1-preview.2 » pour utiliser cette version de l’API.

$top
query

integer

int32

Nombre maximal de modifications à retourner.

fromBuildId
query

integer

int32

ID de la première build.

toBuildId
query

integer

int32

ID de la dernière build.

Réponses

Nom Type Description
200 OK

Change[]

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.build Accorde la possibilité d’accéder aux artefacts de build, y compris les résultats de build, les définitions et les demandes, et la possibilité de recevoir des notifications sur les événements de build via des hooks de service.

Définitions

Nom Description
Change

Représente une modification associée à une build.

IdentityRef
ReferenceLinks

Classe pour représenter une collection de liens de référence REST.

Change

Représente une modification associée à une build.

Nom Type Description
author

IdentityRef

Auteur de la modification.

displayUri

string

Emplacement d’une représentation conviviale de la ressource.

id

string

Identificateur de la modification. Pour un commit, il s’agit du SHA1. Pour un ensemble de modifications TFVC, il s’agit de l’ID de l’ensemble de modifications.

location

string

Emplacement de la représentation complète de la ressource.

message

string

Description de la modification. Il peut s’agir d’un message de validation ou d’une description de l’ensemble de modifications.

messageTruncated

boolean

Indique si le message a été tronqué.

pusher

string

Personne ou processus qui a poussé la modification.

timestamp

string

Horodatage de la modification.

type

string

Type de modification. « commit », « changeset », etc.

IdentityRef

Nom Type Description
_links

ReferenceLinks

Ce champ contient zéro ou plus de liens intéressants sur l’objet du graphique. Ces liens peuvent être appelés pour obtenir des relations supplémentaires ou des informations plus détaillées sur ce sujet de graphique.

descriptor

string

Le descripteur est le principal moyen de référencer l’objet du graphique pendant l’exécution du système. Ce champ identifie de manière unique le même sujet de graphique dans les comptes et les organisations.

directoryAlias

string

Déconseillé : peut être récupéré en interrogeant l’utilisateur Graph référencé dans l’entrée « self » du dictionnaire IdentityRef « _links »

displayName

string

Il s’agit du nom d’affichage non unique de l’objet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source.

id

string

imageUrl

string

Déprécié : disponible dans l’entrée « avatar » du dictionnaire IdentityRef « _links »

inactive

boolean

Déconseillé : peut être récupéré en interrogeant l’état d’appartenance Graph référencé dans l’entrée « membershipState » du dictionnaire GraphUser « _links »

isAadIdentity

boolean

Déprécié : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Déprécié : peut être déduit du type d’objet du descripteur (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

Déconseillé : non utilisé dans la plupart des implémentations préexistantes de ToIdentityRef

uniqueName

string

Déconseillé : utilisez à la place Domain+PrincipalName

url

string

Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphique.

Classe pour représenter une collection de liens de référence REST.

Nom Type Description
links

object

Vue en lecture seule des liens. Étant donné que les liens référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.