Freigeben über


Builds - Get Build Changes

Ruft die einem Build zugeordneten Änderungen ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
buildId
path True

integer

int32
organization
path True

string

Der Name der Azure DevOps-Organisation.

project
path True

string

Projekt-ID oder Projektname

api-version
query True

string

Version der zu verwendenden API. Dies sollte auf "7.1-preview.2" festgelegt werden, um diese Version der API zu verwenden.

$top
query

integer

int32

Die maximale Anzahl der zurückzugebenden Änderungen

continuationToken
query

string

includeSourceChange
query

boolean

Antworten

Name Typ Beschreibung
200 OK

Change[]

Erfolgreicher Vorgang

Sicherheit

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

Name Beschreibung
vso.build Ermöglicht den Zugriff auf Buildartefakte, einschließlich Buildergebnissen, Definitionen und Anforderungen, sowie die Möglichkeit, Benachrichtigungen über Buildereignisse über Diensthooks zu empfangen.

Definitionen

Name Beschreibung
Change

Stellt eine Änderung dar, die einem Build zugeordnet ist.

IdentityRef
ReferenceLinks

Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Change

Stellt eine Änderung dar, die einem Build zugeordnet ist.

Name Typ Beschreibung
author

IdentityRef

Der Autor der Änderung.

displayUri

string

Der Speicherort einer benutzerfreundlichen Darstellung der Ressource.

id

string

Der Bezeichner für die Änderung. Bei einem Commit wäre dies der SHA1. Bei einem TFVC-Changeset wäre dies die Changeset-ID.

location

string

Der Speicherort der vollständigen Darstellung der Ressource.

message

string

Die Beschreibung der Änderung. Dies kann eine Commitnachricht oder eine Changesetbeschreibung sein.

messageTruncated

boolean

Gibt an, ob die Nachricht abgeschnitten wurde.

pusher

string

Die Person oder der Prozess, der die Änderung gepusht hat.

timestamp

string

Der Zeitstempel für die Änderung.

type

string

Der Typ der Änderung. "commit", "changeset" usw.

IdentityRef

Name Typ Beschreibung
_links

ReferenceLinks

Dieses Feld enthält null oder interessantere Links zum Graphthema. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Graphthema zu erhalten.

descriptor

string

Der Deskriptor ist die primäre Methode, um auf den Graph-Betreff zu verweisen, während das System ausgeführt wird. In diesem Feld wird derselbe Graph-Betreff sowohl für Konten als auch für Organisationen eindeutig identifiziert.

directoryAlias

string

Veraltet: Kann abgerufen werden, indem der Graph-Benutzer abgefragt wird, auf den im Eintrag "self" des IdentityRef-Wörterbuchs "_links" verwiesen wird.

displayName

string

Dies ist der nicht eindeutige Anzeigename des Graph-Betreffs. Um dieses Feld zu ändern, müssen Sie seinen Wert im Quellanbieter ändern.

id

string

imageUrl

string

Veraltet: Im Eintrag "avatar" des IdentityRef-Wörterbuchs "_links" verfügbar

inactive

boolean

Veraltet: Kann abgerufen werden, indem der Graph-Mitgliedschaftsstatus abgefragt wird, auf den im Eintrag "membershipState" des GraphUser-Wörterbuchs "_links" verwiesen wird.

isAadIdentity

boolean

Veraltet: Kann vom Betrefftyp des Deskriptors abgeleitet werden (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Veraltet: Kann vom Betrefftyp des Deskriptors abgeleitet werden (Descriptor.IsGroupType)

isDeletedInOrigin

boolean

profileUrl

string

Veraltet– wird in den meisten vorhandenen Implementierungen von ToIdentityRef nicht verwendet.

uniqueName

string

Veraltet: Verwenden Sie stattdessen Domain+PrincipalName.

url

string

Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs.

Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name Typ Beschreibung
links

object

Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützter Sind, möchten wir sie nur als schreibgeschützter Link verfügbar machen.