Freigeben über


Pushes - Get

Ruft einen bestimmten Push ab.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pushes/{pushId}?api-version=7.1-preview.2
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pushes/{pushId}?includeCommits={includeCommits}&includeRefUpdates={includeRefUpdates}&api-version=7.1-preview.2

URI-Parameter

Name In Erforderlich Typ Beschreibung
organization
path True

string

Der Name der Azure DevOps-Organisation.

pushId
path True

integer

int32

ID des Pushs.

repositoryId
path True

string

Der Name oder die ID des Repositorys.

project
path

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.

includeCommits
query

integer

int32

Die Anzahl der Commits, die in das Ergebnis eingeschlossen werden sollen.

includeRefUpdates
query

boolean

Wenn true, fügen Sie die Liste der Refs ein, die durch den Push aktualisiert wurden.

Antworten

Name Typ Beschreibung
200 OK

GitPush

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.code Ermöglicht das Lesen von Quellcode und Metadaten zu Commits, Changesets, Branches und anderen Versionskontrollartefakten. Ermöglicht außerdem die Suche nach Code und die Benachrichtigung über Versionskontrollereignisse über Diensthaken.

Beispiele

Just the push

Sample Request

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

Sample Response

{
  "commits": [],
  "pushedBy": {
    "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
    "displayName": "Normal Paulk",
    "uniqueName": "fabrikamfiber16@hotmail.com",
    "url": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
    "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
  },
  "pushId": 23,
  "date": "2014-06-30T18:11:18.0929091Z",
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249"
    },
    "commits": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/pushes/23/commits"
    },
    "pusher": {
      "href": "https://vssps.dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
    }
  }
}

Definitionen

Name Beschreibung
ChangeCountDictionary
GitChange
GitCommitRef

Stellt Eigenschaften bereit, die einen Git-Commit und die zugehörigen Metadaten beschreiben.

GitPush
GitPushRef
GitRefUpdate
GitRepository
GitRepositoryRef
GitStatus

Diese Klasse enthält die Metadaten eines Diensts bzw. einer Erweiterung, die eine status.

GitStatusContext

Statuskontext, der die status eindeutig identifiziert.

GitStatusState

Status der status.

GitTemplate
GitUserDate

Benutzerinformationen und Datum für Git-Vorgänge.

IdentityRef
ItemContent
ItemContentType
ProjectState

Projektstatus.

ProjectVisibility

Projektsichtbarkeit.

ReferenceLinks

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

ResourceRef
TeamProjectCollectionReference

Referenzobjekt für eine TeamProjectCollection.

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.

VersionControlChangeType

Der Typ der Änderung, die am Element vorgenommen wurde.

ChangeCountDictionary

GitChange

Name Typ Beschreibung
changeId

integer

ID der Änderung innerhalb der Gruppe der Änderungen.

changeType

VersionControlChangeType

Der Typ der Änderung, die am Element vorgenommen wurde.

item

string

Aktuelle Version.

newContent

ItemContent

Inhalt des Elements nach der Änderung.

newContentTemplate

GitTemplate

Neue Inhaltsvorlage, die beim Übertragen neuer Änderungen verwendet werden soll.

originalPath

string

Der ursprüngliche Pfad des Elements, wenn sich vom aktuellen Pfad unterscheidet.

sourceServerItem

string

Pfad des Elements auf dem Server.

url

string

URL zum Abrufen des Elements.

GitCommitRef

Stellt Eigenschaften bereit, die einen Git-Commit und die zugehörigen Metadaten beschreiben.

Name Typ Beschreibung
_links

ReferenceLinks

Eine Auflistung verwandter REST-Verweislinks.

author

GitUserDate

Autor des Commits.

changeCounts

ChangeCountDictionary

Anzahl der Im Commit enthaltenen Arten von Änderungen (Bearbeitungen, Löschungen usw.).

changes

GitChange[]

Eine Enumeration der änderungen, die im Commit enthalten sind.

comment

string

Kommentar oder Meldung des Commits.

commentTruncated

boolean

Gibt an, ob der Kommentar aus der vollständigen Git-Commitkommentarnachricht abgeschnitten wird.

commitId

string

ID (SHA-1) des Commits.

commitTooManyChanges

boolean

Gibt an, dass commit zu viele Änderungen enthält, um angezeigt zu werden.

committer

GitUserDate

Committer des Commits.

parents

string[]

Eine Enumeration der übergeordneten Commit-IDs für diesen Commit.

push

GitPushRef

Der push, der diesem Commit zugeordnet ist.

remoteUrl

string

Remote-URL-Pfad zum Commit.

statuses

GitStatus[]

Eine Liste mit status Metadaten von Diensten und Erweiterungen, die dem Commit möglicherweise zusätzliche Informationen zuordnen.

url

string

REST-URL für diese Ressource.

workItems

ResourceRef[]

Eine Liste der Arbeitselemente, die diesem Commit zugeordnet sind.

GitPush

Name Typ Beschreibung
_links

ReferenceLinks

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

commits

GitCommitRef[]

Stellt Eigenschaften bereit, die einen Git-Commit und die zugehörigen Metadaten beschreiben.

date

string

pushId

integer

pushedBy

IdentityRef

refUpdates

GitRefUpdate[]

repository

GitRepository

url

string

GitPushRef

Name Typ Beschreibung
_links

ReferenceLinks

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

date

string

pushId

integer

pushedBy

IdentityRef

url

string

GitRefUpdate

Name Typ Beschreibung
isLocked

boolean

name

string

newObjectId

string

oldObjectId

string

repositoryId

string

GitRepository

Name Typ Beschreibung
_links

ReferenceLinks

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

defaultBranch

string

id

string

isDisabled

boolean

True, wenn das Repository deaktiviert ist. Andernfalls FALSE.

isFork

boolean

True, wenn das Repository als Fork erstellt wurde.

isInMaintenance

boolean

True, wenn das Repository in Wartung ist. Andernfalls FALSE.

name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.

remoteUrl

string

size

integer

Komprimierte Größe (Bytes) des Repositorys.

sshUrl

string

url

string

validRemoteUrls

string[]

webUrl

string

GitRepositoryRef

Name Typ Beschreibung
collection

TeamProjectCollectionReference

TeamProjektsammlung, in der sich dieser Fork befindet

id

string

isFork

boolean

True, wenn das Repository als Fork erstellt wurde

name

string

project

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.

remoteUrl

string

sshUrl

string

url

string

GitStatus

Diese Klasse enthält die Metadaten eines Diensts bzw. einer Erweiterung, die eine status.

Name Typ Beschreibung
_links

ReferenceLinks

Referenzlinks.

context

GitStatusContext

Kontext des status.

createdBy

IdentityRef

Identität, die die status erstellt hat.

creationDate

string

Erstellungsdatum und -uhrzeit des status.

description

string

Statusbeschreibung. Beschreibt in der Regel den aktuellen Zustand des status.

id

integer

Statusbezeichner.

state

GitStatusState

Status der status.

targetUrl

string

URL mit status Details.

updatedDate

string

Datum und Uhrzeit der letzten Aktualisierung des status.

GitStatusContext

Statuskontext, der die status eindeutig identifiziert.

Name Typ Beschreibung
genre

string

Genre der status. In der Regel kann der Name des Diensts/Tools, der die status generiert, leer sein.

name

string

Der Namensbezeichner des status darf nicht NULL oder leer sein.

GitStatusState

Status der status.

Name Typ Beschreibung
error

string

Status mit einem Fehler.

failed

string

Fehler beim Status.

notApplicable

string

Der Status gilt nicht für das Zielobjekt.

notSet

string

Statusstatus nicht festgelegt. Standardzustand.

pending

string

Status ausstehend.

succeeded

string

Status erfolgreich.

GitTemplate

Name Typ Beschreibung
name

string

Name der Vorlage

type

string

Typ der Vorlage

GitUserDate

Benutzerinformationen und Datum für Git-Vorgänge.

Name Typ Beschreibung
date

string

Datum des Git-Vorgangs.

email

string

Email Adresse des Benutzers, der den Git-Vorgang ausführt.

imageUrl

string

URL für den Avatar des Benutzers.

name

string

Name des Benutzers, der den Git-Vorgang ausführt.

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

ItemContent

Name Typ Beschreibung
content

string

contentType

ItemContentType

ItemContentType

Name Typ Beschreibung
base64Encoded

string

rawText

string

ProjectState

Projektstatus.

Name Typ Beschreibung
all

string

Alle Projekte unabhängig vom Zustand außer Gelöscht.

createPending

string

Project wurde für die Erstellung in die Warteschlange gestellt, aber der Prozess wurde noch nicht gestartet.

deleted

string

Project wurde gelöscht.

deleting

string

Project wird gerade gelöscht.

new

string

Das Projekt wird gerade erstellt.

unchanged

string

Project wurde nicht geändert.

wellFormed

string

Project ist vollständig erstellt und einsatzbereit.

ProjectVisibility

Projektsichtbarkeit.

Name Typ Beschreibung
private

string

Das Projekt ist nur für Benutzer mit explizitem Zugriff sichtbar.

public

string

Das Projekt ist für alle sichtbar.

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.

ResourceRef

Name Typ Beschreibung
id

string

url

string

TeamProjectCollectionReference

Referenzobjekt für eine TeamProjectCollection.

Name Typ Beschreibung
avatarUrl

string

Sammlungs-Avatar-URL.

id

string

Sammlungs-ID.

name

string

Sammlungsname.

url

string

SAMMLUNGS-REST-URL.

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.

Name Typ Beschreibung
abbreviation

string

Projektkürzel.

defaultTeamImageUrl

string

URL zum Standardmäßigen Teamidentitätsbild.

description

string

Die Beschreibung des Projekts (falls vorhanden).

id

string

Projektbezeichner.

lastUpdateTime

string

Zeitpunkt der letzten Aktualisierung des Projekts.

name

string

Der Projektname.

revision

integer

Projektrevision.

state

ProjectState

Projektstatus.

url

string

URL zur Vollversion des Objekts.

visibility

ProjectVisibility

Projektsichtbarkeit.

VersionControlChangeType

Der Typ der Änderung, die am Element vorgenommen wurde.

Name Typ Beschreibung
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