Pull Requests - Create

Referenz

Dienst:: Git

API-Version:: 7.1

Erstellen Sie eine Pullanforderung.

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?api-version=7.1

Mit optionalen Parametern:

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?supportsIterations={supportsIterations}&api-version=7.1

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
repositoryId	path	True	string	Die Repository-ID des Zielzweigs der Pullanforderung.
project	path		string	Projekt-ID oder Projektname
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1" festgelegt werden, um diese Version der API zu verwenden.
supportsIterations	query		boolean	Bei "true" können nachfolgende Pushs an die Pullanforderung einzeln überprüft werden. Legen Sie diesen Wert für große Pullanforderungen aus Leistungsgründen auf "false" fest, wenn diese Funktion nicht benötigt wird.

Anforderungstext

Name	Typ	Beschreibung
_links	ReferenceLinks	Links zu anderen verwandten Objekten.
artifactId	string	Eine Zeichenfolge, die diese Pullanforderung eindeutig identifiziert. Um eine Artefakt-ID für eine Pullanforderung zu generieren, verwenden Sie diese Vorlage: `vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}`
autoCompleteSetBy	IdentityRef	Wenn diese Einstellung festgelegt ist, ist autovervollständigen für diese Pullanforderung aktiviert, und dies ist die Identität, die sie aktiviert hat.
closedBy	IdentityRef	Der Benutzer, der die Pullanforderung geschlossen hat.
closedDate	string (date-time)	Das Datum, an dem die Pullanforderung geschlossen wurde (abgeschlossen, abgebrochen oder extern zusammengeführt).
codeReviewId	integer (int32)	Die Codeüberprüfungs-ID der Pullanforderung. Intern verwendet.
commits	GitCommitRef[]	Die in der Pullanforderung enthaltenen Commits.
completionOptions	GitPullRequestCompletionOptions	Optionen, die sich darauf auswirken, wie die Pullanforderung zusammengeführt wird, wenn sie abgeschlossen ist.
completionQueueTime	string (date-time)	Das letzte Datum, an dem die Pullanforderung die Warteschlange eingegeben hat, die abgeschlossen werden soll. Intern verwendet.
createdBy	IdentityRef	Die Identität des Benutzers, der die Pullanforderung erstellt hat.
creationDate	string (date-time)	Das Datum, an dem die Pullanforderung erstellt wurde.
description	string	Die Beschreibung der Pullanforderung.
forkSource	GitForkRef	Wenn es sich um eine PR aus einer Verzweigung handelt, enthält dies Informationen über seine Quelle.
hasMultipleMergeBases	boolean	Warnung für mehrere Mergebases
isDraft	boolean	Entwurf/WIP-Pullanforderung.
labels	WebApiTagDefinition[]	Die Bezeichnungen, die der Pullanforderung zugeordnet sind.
lastMergeCommit	GitCommitRef	Der Commit des letzten Pullanforderungszusammenführungsvorgangs. Wenn leer, wird die letzte Zusammenführung ausgeführt oder war nicht erfolgreich.
lastMergeSourceCommit	GitCommitRef	Der Commit am Anfang der Quell-Verzweigung zum Zeitpunkt des letzten Zusammenführens der Pullanforderung.
lastMergeTargetCommit	GitCommitRef	Der Commit an der Kopfzeile der Ziel-Verzweigung zum Zeitpunkt des letzten Zusammenführens der Pullanforderung.
mergeFailureMessage	string	Bei Festlegung ist der Zusammenführungsvorgang der Pullanforderung aus diesem Grund fehlgeschlagen.
mergeFailureType	PullRequestMergeFailureType	Der Typ des Fehlers (falls vorhanden) des Zusammenführens der Pullanforderung.
mergeId	string (uuid)	Die ID des Auftrags, der zum Ausführen des Seriendrucks der Pullanforderung verwendet wird. Intern verwendet.
mergeOptions	GitPullRequestMergeOptions	Optionen, die verwendet werden, wenn der Seriendruck der Pullanforderung ausgeführt wird. Diese unterscheiden sich von den Abschlussoptionen, da der Abschluss nur einmal erfolgt und bei jeder Änderung des Quellzweigs der Pullanforderung ein neuer Seriendruck ausgeführt wird.
mergeStatus	PullRequestAsyncStatus	Der aktuelle Status des Pullanforderungszusammenführungsvorgangs.
pullRequestId	integer (int32)	Die ID der Pullanforderung.
remoteUrl	string	Intern verwendet.
repository	GitRepository	Das Repository, das den Zielzweig der Pullanforderung enthält.
reviewers	IdentityRefWithVote[]	Eine Liste der Prüfer auf dem Pull-Antrag zusammen mit dem Status ihrer Stimmen.
sourceRefName	string	Der Name des Quellzweigs der Pullanforderung.
status	PullRequestStatus	Der Status der Pullanforderung.
supportsIterations	boolean	Wenn dies der Fall ist, unterstützt diese Pullanforderung mehrere Iterationen. Iterationsunterstützung bedeutet, dass einzelne Pushs an den Quellzweig der Pullanforderung überprüft werden können und Kommentare in einer Iteration in zukünftigen Iterationen nachverfolgt werden.
targetRefName	string	Der Name des Zielzweigs der Pullanforderung.
title	string	Der Titel der Pullanforderung.
url	string	Intern verwendet.
workItemRefs	ResourceRef[]	Alle Arbeitsaufgabenverweise, die dieser Pullanforderung zugeordnet sind.

Antworten

Name	Typ	Beschreibung
200 OK	GitPullRequest	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

Name	Beschreibung
vso.code_write	Gewährt die Möglichkeit, Quellcode zu lesen, zu aktualisieren und zu löschen, auf Metadaten zu Commits, Änderungenets, Verzweigungen und anderen Versionssteuerungsartefakten zuzugreifen. Gewährt außerdem die Möglichkeit, Pullanforderungen und Codeüberprüfungen zu erstellen und zu verwalten und Benachrichtigungen über Versionssteuerungsereignisse über Dienst-Hooks zu erhalten.

Beispiele

Beispielanforderung

HTTP

POST https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullrequests?api-version=7.1

{
  "sourceRefName": "refs/heads/npaulk/my_work",
  "targetRefName": "refs/heads/new_feature",
  "title": "A new feature",
  "description": "Adding a new feature",
  "reviewers": [
    {
      "id": "d6245f20-2af8-44f4-9451-8107cb2767db"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:: 201

{
  "repository": {
    "id": "3411ebc1-d5aa-464f-9615-0b527bc66719",
    "name": "2016_10_31",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719",
    "project": {
      "id": "a7573007-bbb3-4341-b726-0c4148a07853",
      "name": "2016_10_31",
      "description": "test project created on Halloween 2016",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/a7573007-bbb3-4341-b726-0c4148a07853",
      "state": "wellFormed",
      "revision": 7
    },
    "remoteUrl": "https://dev.azure.com/fabrikam/_git/2016_10_31"
  },
  "pullRequestId": 22,
  "codeReviewId": 22,
  "status": "active",
  "createdBy": {
    "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
    "displayName": "Normal Paulk",
    "uniqueName": "fabrikamfiber16@hotmail.com",
    "url": "https://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"
  },
  "creationDate": "2016-11-01T16:30:31.6655471Z",
  "title": "A new feature",
  "description": "Adding a new feature",
  "sourceRefName": "refs/heads/npaulk/my_work",
  "targetRefName": "refs/heads/new_feature",
  "mergeStatus": "queued",
  "mergeId": "f5fc8381-3fb2-49fe-8a0d-27dcc2d6ef82",
  "lastMergeSourceCommit": {
    "commitId": "b60280bc6e62e2f880f1b63c1e24987664d3bda3",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/b60280bc6e62e2f880f1b63c1e24987664d3bda3"
  },
  "lastMergeTargetCommit": {
    "commitId": "f47bbc106853afe3c1b07a81754bce5f4b8dbf62",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
  },
  "reviewers": [
    {
      "reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/reviewers/d6245f20-2af8-44f4-9451-8107cb2767db",
      "vote": 0,
      "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
      "displayName": "Normal Paulk",
      "uniqueName": "fabrikamfiber16@hotmail.com",
      "url": "https://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"
    }
  ],
  "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719"
    },
    "workItems": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/workitems"
    },
    "sourceBranch": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/refs"
    },
    "targetBranch": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/refs"
    },
    "sourceCommit": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/b60280bc6e62e2f880f1b63c1e24987664d3bda3"
    },
    "targetCommit": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
    },
    "createdBy": {
      "href": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db"
    },
    "iterations": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/iterations"
    }
  },
  "supportsIterations": true,
  "artifactId": "vstfs:///Git/PullRequestId/a7573007-bbb3-4341-b726-0c4148a07853%2f3411ebc1-d5aa-464f-9615-0b527bc66719%2f22"
}

Definitionen

Name	Beschreibung
ChangeCountDictionary
GitChange
GitCommitRef	Stellt Eigenschaften bereit, die einen Git-Commit und zugehörige Metadaten beschreiben.
GitForkRef	Informationen zu einer Verzweigungs-Referenz.
GitPullRequest	Stellt alle Daten dar, die einer Pullanforderung zugeordnet sind.
GitPullRequestCompletionOptions	Einstellungen zum Abschließen der Pullanforderung.
GitPullRequestMergeOptions	Die Optionen, die beim Erstellen eines Seriendrucks für Pullanforderungen verwendet werden.
GitPullRequestMergeStrategy	Geben Sie die Strategie an, mit der die Pullanforderung während des Abschlusses zusammengeführt wird. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, wird ein no-FF Zusammenführung erstellt, wenn DatasetMerge == false. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, werden die Pull-Anforderungs-Commits abgekürtet, wenn Commits im Rahmen von DatasetMerge == true. Die ShapeMerge-Eigenschaft ist veraltet. Es wird empfohlen, mergeStrategy in allen Fällen explizit festzulegen. Wenn für MergeStrategy ein expliziter Wert angegeben wird, wird die Eigenschaft ShapeMerge ignoriert.
GitPushRef
GitRepository
GitRepositoryRef
GitStatus	Diese Klasse enthält die Metadaten eines Diensts/einer Erweiterung, der einen Status veröffentlicht.
GitStatusContext	Statuskontext, der den Status eindeutig identifiziert.
GitStatusState	Status des Status.
GitTemplate
GitUserDate	Benutzerinformationen und Datum für Git-Vorgänge.
IdentityRef
IdentityRefWithVote	Identitätsinformationen, einschließlich einer Abstimmung über einen Pull-Antrag.
ItemContent
ItemContentType
ProjectState	Projektstatus.
ProjectVisibility	Projektsichtbarkeit.
PullRequestAsyncStatus	Der aktuelle Status des Pullanforderungszusammenführungsvorgangs.
PullRequestMergeFailureType	Der Typ des Fehlers (falls vorhanden) des Zusammenführens der Pullanforderung.
PullRequestStatus	Der Status der Pullanforderung.
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
ResourceRef
TeamProjectCollectionReference	Reference-Objekt für eine TeamProjectCollection.
TeamProjectReference	Stellt einen flachen Verweis auf ein TeamProject dar.
VersionControlChangeType	Der Typ der Änderung, die an dem Element vorgenommen wurde.
WebApiTagDefinition	Die Darstellung einer Tagdefinition, die über das Netzwerk gesendet wird.

ChangeCountDictionary

Objekt

GitChange

Objekt

Name	Typ	Beschreibung
changeId	integer (int32)	ID der Änderung innerhalb der Gruppe der Änderungen.
changeType	VersionControlChangeType	Der Typ der Änderung, die an dem Element vorgenommen wurde.
item	string (T)	Aktuelle Version.
newContent	ItemContent	Inhalt des Elements nach der Änderung.
newContentTemplate	GitTemplate	Neue Inhaltsvorlage, die beim Pushen neuer Änderungen verwendet werden soll.
originalPath	string	Ursprünglicher Pfad des Elements, wenn es sich von dem aktuellen Pfad unterscheidet.
sourceServerItem	string	Pfad des Elements auf dem Server.
url	string	URL zum Abrufen des Elements.

GitCommitRef

Objekt

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

Name	Typ	Beschreibung
_links	ReferenceLinks	Eine Sammlung verwandter REST-Referenzverknüpfungslinks.
author	GitUserDate	Autor des Commits.
changeCounts	ChangeCountDictionary	Zählt die Typen von Änderungen (Bearbeitungen, Löschungen usw.), die im Commit enthalten sind.
changes	GitChange[]	Eine Aufzählung der Änderungen, die im Commit enthalten sind.
comment	string	Kommentar oder Nachricht des Commits.
commentTruncated	boolean	Gibt an, ob der Kommentar aus der vollständigen Git Commit-Kommentarnachricht abgeschnitten wird.
commitId	string	ID (SHA-1) des Commits.
commitTooManyChanges	boolean	Gibt an, dass commit zu viele Änderungen enthält, die angezeigt werden sollen.
committer	GitUserDate	Committer des Commits.
parents	string[]	Eine Aufzählung 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 der Statusmetadaten von Diensten und Erweiterungen, die dem Commit zusätzliche Informationen zuordnen können.
url	string	REST-URL für diese Ressource.
workItems	ResourceRef[]	Eine Liste der Arbeitsaufgaben, die diesem Commit zugeordnet sind.

GitForkRef

Objekt

Informationen zu einer Verzweigungs-Referenz.

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
creator	IdentityRef
isLocked	boolean
isLockedBy	IdentityRef
name	string
objectId	string
peeledObjectId	string
repository	GitRepository	Die Repository-ID der Verzweigung.
statuses	GitStatus[]	Diese Klasse enthält die Metadaten eines Diensts/einer Erweiterung, der einen Status veröffentlicht.
url	string

GitPullRequest

Objekt

Stellt alle Daten dar, die einer Pullanforderung zugeordnet sind.

Name	Typ	Beschreibung
_links	ReferenceLinks	Links zu anderen verwandten Objekten.
artifactId	string	Eine Zeichenfolge, die diese Pullanforderung eindeutig identifiziert. Um eine Artefakt-ID für eine Pullanforderung zu generieren, verwenden Sie diese Vorlage: `vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}`
autoCompleteSetBy	IdentityRef	Wenn diese Einstellung festgelegt ist, ist autovervollständigen für diese Pullanforderung aktiviert, und dies ist die Identität, die sie aktiviert hat.
closedBy	IdentityRef	Der Benutzer, der die Pullanforderung geschlossen hat.
closedDate	string (date-time)	Das Datum, an dem die Pullanforderung geschlossen wurde (abgeschlossen, abgebrochen oder extern zusammengeführt).
codeReviewId	integer (int32)	Die Codeüberprüfungs-ID der Pullanforderung. Intern verwendet.
commits	GitCommitRef[]	Die in der Pullanforderung enthaltenen Commits.
completionOptions	GitPullRequestCompletionOptions	Optionen, die sich darauf auswirken, wie die Pullanforderung zusammengeführt wird, wenn sie abgeschlossen ist.
completionQueueTime	string (date-time)	Das letzte Datum, an dem die Pullanforderung die Warteschlange eingegeben hat, die abgeschlossen werden soll. Intern verwendet.
createdBy	IdentityRef	Die Identität des Benutzers, der die Pullanforderung erstellt hat.
creationDate	string (date-time)	Das Datum, an dem die Pullanforderung erstellt wurde.
description	string	Die Beschreibung der Pullanforderung.
forkSource	GitForkRef	Wenn es sich um eine PR aus einer Verzweigung handelt, enthält dies Informationen über seine Quelle.
hasMultipleMergeBases	boolean	Warnung für mehrere Mergebases
isDraft	boolean	Entwurf/WIP-Pullanforderung.
labels	WebApiTagDefinition[]	Die Bezeichnungen, die der Pullanforderung zugeordnet sind.
lastMergeCommit	GitCommitRef	Der Commit des letzten Pullanforderungszusammenführungsvorgangs. Wenn leer, wird die letzte Zusammenführung ausgeführt oder war nicht erfolgreich.
lastMergeSourceCommit	GitCommitRef	Der Commit am Anfang der Quell-Verzweigung zum Zeitpunkt des letzten Zusammenführens der Pullanforderung.
lastMergeTargetCommit	GitCommitRef	Der Commit an der Kopfzeile der Ziel-Verzweigung zum Zeitpunkt des letzten Zusammenführens der Pullanforderung.
mergeFailureMessage	string	Bei Festlegung ist der Zusammenführungsvorgang der Pullanforderung aus diesem Grund fehlgeschlagen.
mergeFailureType	PullRequestMergeFailureType	Der Typ des Fehlers (falls vorhanden) des Zusammenführens der Pullanforderung.
mergeId	string (uuid)	Die ID des Auftrags, der zum Ausführen des Seriendrucks der Pullanforderung verwendet wird. Intern verwendet.
mergeOptions	GitPullRequestMergeOptions	Optionen, die verwendet werden, wenn der Seriendruck der Pullanforderung ausgeführt wird. Diese unterscheiden sich von den Abschlussoptionen, da der Abschluss nur einmal erfolgt und bei jeder Änderung des Quellzweigs der Pullanforderung ein neuer Seriendruck ausgeführt wird.
mergeStatus	PullRequestAsyncStatus	Der aktuelle Status des Pullanforderungszusammenführungsvorgangs.
pullRequestId	integer (int32)	Die ID der Pullanforderung.
remoteUrl	string	Intern verwendet.
repository	GitRepository	Das Repository, das den Zielzweig der Pullanforderung enthält.
reviewers	IdentityRefWithVote[]	Eine Liste der Prüfer auf dem Pull-Antrag zusammen mit dem Status ihrer Stimmen.
sourceRefName	string	Der Name des Quellzweigs der Pullanforderung.
status	PullRequestStatus	Der Status der Pullanforderung.
supportsIterations	boolean	Wenn dies der Fall ist, unterstützt diese Pullanforderung mehrere Iterationen. Iterationsunterstützung bedeutet, dass einzelne Pushs an den Quellzweig der Pullanforderung überprüft werden können und Kommentare in einer Iteration in zukünftigen Iterationen nachverfolgt werden.
targetRefName	string	Der Name des Zielzweigs der Pullanforderung.
title	string	Der Titel der Pullanforderung.
url	string	Intern verwendet.
workItemRefs	ResourceRef[]	Alle Arbeitsaufgabenverweise, die dieser Pullanforderung zugeordnet sind.

GitPullRequestCompletionOptions

Objekt

Einstellungen zum Abschließen der Pullanforderung.

Name	Typ	Beschreibung
autoCompleteIgnoreConfigIds	integer[] (int32)	Liste der Richtlinienkonfigurations-IDs, auf die automatisch abgeschlossen werden soll, sollte nicht warten. Gilt nur für optionale Richtlinien (isBlocking == false). AutoVervollständigen wartet immer auf erforderliche Richtlinien (isBlocking == true).
bypassPolicy	boolean	Bei "true" werden Richtlinien explizit umgangen, während die Pullanforderung abgeschlossen ist.
bypassReason	string	Wenn Richtlinien umgangen werden, wird dieser Grund gespeichert, um zu erfahren, warum die Umgehung verwendet wurde.
deleteSourceBranch	boolean	Wenn true, wird der Quellzweig der Pullanforderung nach Abschluss gelöscht.
mergeCommitMessage	string	Wenn festgelegt, wird dies als Commit-Nachricht des Seriendruck-Commits verwendet.
mergeStrategy	GitPullRequestMergeStrategy	Geben Sie die Strategie an, mit der die Pullanforderung während des Abschlusses zusammengeführt wird. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, wird ein no-FF Zusammenführung erstellt, wenn DatasetMerge == false. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, werden die Pull-Anforderungs-Commits abgekürtet, wenn Commits im Rahmen von DatasetMerge == true. Die ShapeMerge-Eigenschaft ist veraltet. Es wird empfohlen, mergeStrategy in allen Fällen explizit festzulegen. Wenn für MergeStrategy ein expliziter Wert angegeben wird, wird die Eigenschaft ShapeMerge ignoriert.
squashMerge	boolean	Decodmerge ist veraltet. Sie sollten den Wert von MergeStrategy explizit festlegen. Wenn "MergeStrategy" auf einen beliebigen Wert festgelegt ist, wird der Wert "ShapeMerge" ignoriert. Wenn MergeStrategy nicht festgelegt ist, ist die Zusammenführungsstrategie nicht schnell vorwärts, wenn diese Kennzeichnung falsch ist, oder wenn true.
transitionWorkItems	boolean	Wenn true, versuchen wir, alle Arbeitsaufgaben, die mit der Pullanforderung verknüpft sind, in den nächsten logischen Zustand zu übertragen (d. h. Aktiv -> Aufgelöst)
triggeredByAutoComplete	boolean	Bei "true" wurde der aktuelle Abschlussversuch über den automatischen Abschluss ausgelöst. Intern verwendet.

GitPullRequestMergeOptions

Objekt

Die Optionen, die beim Erstellen eines Seriendrucks für Pullanforderungen verwendet werden.

Name	Typ	Beschreibung
conflictAuthorshipCommits	boolean	Wenn wahr, werden während der Zusammenführung angewendete Konfliktauflösungen in separate Commits gesetzt, um Autoreninformationen für Git-Schuld usw. beizubehalten.
detectRenameFalsePositives	boolean
disableRenames	boolean	Wenn true, wird die Umbenennenerkennung während der Zusammenführung nicht ausgeführt.

GitPullRequestMergeStrategy

Enumeration

Geben Sie die Strategie an, mit der die Pullanforderung während des Abschlusses zusammengeführt wird. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, wird ein no-FF Zusammenführung erstellt, wenn DatasetMerge == false. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, werden die Pull-Anforderungs-Commits abgekürtet, wenn Commits im Rahmen von DatasetMerge == true. Die ShapeMerge-Eigenschaft ist veraltet. Es wird empfohlen, mergeStrategy in allen Fällen explizit festzulegen. Wenn für MergeStrategy ein expliziter Wert angegeben wird, wird die Eigenschaft ShapeMerge ignoriert.

Wert	Beschreibung
noFastForward	Ein zwei übergeordneter, nicht schneller Zusammenführungsvorgang. Der Quellzweig ist unverändert. Dies ist das Standardverhalten.
rebase	Ordnen Sie die Quellverzweigung über dem Zielzweig HEAD commit zurück, und leiten Sie die Zielverzweigung schnell weiter. Der Quellverzweigung wird während des Rebase-Vorgangs aktualisiert.
rebaseMerge	Ordnen Sie die Quellverzweigung über dem Zielverzweigungs-HEAD-Commit neu zu, und erstellen Sie einen zwei übergeordneten, no-fast-forward-Merge. Der Quellverzweigung wird während des Rebase-Vorgangs aktualisiert.
squash	Fügen Sie alle Änderungen aus der Pullanforderung in einen commit für ein einzelnes übergeordnetes Element ein.

GitPushRef

Objekt

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
date	string (date-time)
pushId	integer (int32)
pushedBy	IdentityRef
url	string

GitRepository

Objekt

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.
defaultBranch	string
id	string (uuid)
isDisabled	boolean	True, wenn das Repository deaktiviert ist. Andernfalls "False".
isFork	boolean	True, wenn das Repository als Verzweigung erstellt wurde.
isInMaintenance	boolean	True, wenn sich das Repository in der Wartung befindet. Andernfalls "False".
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Stellt einen flachen Verweis auf ein TeamProject dar.
remoteUrl	string
size	integer (int64)	Komprimierte Größe (Bytes) des Repositorys.
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryRef

Objekt

Name	Typ	Beschreibung
collection	TeamProjectCollectionReference	Teamprojektsammlung, in der sich diese Verzweigung befindet
id	string (uuid)
isFork	boolean	True, wenn das Repository als Verzweigung erstellt wurde
name	string
project	TeamProjectReference	Stellt einen flachen Verweis auf ein TeamProject dar.
remoteUrl	string
sshUrl	string
url	string

GitStatus

Objekt

Diese Klasse enthält die Metadaten eines Diensts/einer Erweiterung, der einen Status veröffentlicht.

Name	Typ	Beschreibung
_links	ReferenceLinks	Referenzlinks.
context	GitStatusContext	Kontext des Status.
createdBy	IdentityRef	Identität, die den Status erstellt hat.
creationDate	string (date-time)	Erstellungsdatum und -uhrzeit des Status.
description	string	Statusbeschreibung. Beschreibt in der Regel den aktuellen Status des Status.
id	integer (int32)	Statusbezeichner.
state	GitStatusState	Status des Status.
targetUrl	string	URL mit Statusdetails.
updatedDate	string (date-time)	Datum und Uhrzeit der letzten Aktualisierung des Status.

GitStatusContext

Objekt

Statuskontext, der den Status eindeutig identifiziert.

Name	Typ	Beschreibung
genre	string	Genre des Status. Normalerweise kann der Name des Diensts/Tools, der den Status generiert, leer sein.
name	string	Der Namensbezeichner des Status darf nicht null oder leer sein.

GitStatusState

Enumeration

Status des Status.

Wert	Beschreibung
error	Status mit einem Fehler.
failed	Fehler beim Status.
notApplicable	Der Status gilt nicht für das Zielobjekt.
notSet	Statusstatus nicht festgelegt. Standardstatus.
pending	Status steht aus.
succeeded	Status erfolgreich.

GitTemplate

Objekt

Name	Typ	Beschreibung
name	string	Name der Vorlage
type	string	Typ der Vorlage

GitUserDate

Objekt

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

Name	Typ	Beschreibung
date	string (date-time)	Datum des Git-Vorgangs.
email	string	E-Mail-Adresse des Benutzers, der den Git-Vorgang ausführt.
imageUrl	string	URL für den Avatar des Benutzers.
name	string	Der Name des Benutzers, der den Git-Vorgang ausführt.

IdentityRef

Objekt

Name	Typ	Beschreibung
_links	ReferenceLinks	Dieses Feld enthält null oder interessantere Links zum Thema Diagramm. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Diagrammbetreff zu erhalten.
descriptor	string	Der Deskriptor ist die primäre Möglichkeit, auf den Diagrammbetreff zu verweisen, während das System ausgeführt wird. In diesem Feld wird dasselbe Diagrammthema sowohl in Firmen als auch in Organisationen eindeutig identifiziert.
directoryAlias	string	Veraltet – Kann abgerufen werden, indem der Graph-Benutzer abgefragt wird, auf den im "Self"-Eintrag des IdentityRef -Wörterbuchs "_links" verwiesen wird
displayName	string	Dies ist der nicht eindeutige Anzeigename des Diagrammbetreffs. Um dieses Feld zu ändern, müssen Sie den Wert im Quellanbieter ändern.
id	string
imageUrl	string	Veraltet – Verfügbar im "Avatar"-Eintrag des IdentityRef-Wörterbuchs "_links"
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 – nicht in den meisten bereits vorhandenen Implementierungen von ToIdentityRef verwendet
uniqueName	string	Veraltet – Verwenden Sie stattdessen "Domain+PrincipalName".
url	string	Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs.

IdentityRefWithVote

Objekt

Identitätsinformationen, einschließlich einer Abstimmung über einen Pull-Antrag.

Name	Typ	Beschreibung
_links	ReferenceLinks	Dieses Feld enthält null oder interessantere Links zum Thema Diagramm. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Diagrammbetreff zu erhalten.
descriptor	string	Der Deskriptor ist die primäre Möglichkeit, auf den Diagrammbetreff zu verweisen, während das System ausgeführt wird. In diesem Feld wird dasselbe Diagrammthema sowohl in Firmen als auch in Organisationen eindeutig identifiziert.
directoryAlias	string	Veraltet – Kann abgerufen werden, indem der Graph-Benutzer abgefragt wird, auf den im "Self"-Eintrag des IdentityRef -Wörterbuchs "_links" verwiesen wird
displayName	string	Dies ist der nicht eindeutige Anzeigename des Diagrammbetreffs. Um dieses Feld zu ändern, müssen Sie den Wert im Quellanbieter ändern.
hasDeclined	boolean	Gibt an, ob dieser Prüfer die Überprüfung dieser Pullanforderung abgelehnt hat.
id	string
imageUrl	string	Veraltet – Verfügbar im "Avatar"-Eintrag des IdentityRef-Wörterbuchs "_links"
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
isFlagged	boolean	Gibt an, ob dieser Prüfer für die Aufmerksamkeit für diese Pullanforderung gekennzeichnet ist.
isReapprove	boolean	Gibt an, ob diese Abstimmung noch behandelt werden soll, obwohl sich die Abstimmung nicht geändert hat.
isRequired	boolean	Gibt an, ob dies ein erforderlicher Prüfer für diese Pullanforderung ist. Verzweigungen können Richtlinien enthalten, die bestimmte Prüfer erfordern, für Pullanforderungen erforderlich sind.
profileUrl	string	Veraltet – nicht in den meisten bereits vorhandenen Implementierungen von ToIdentityRef verwendet
reviewerUrl	string	URL zum Abrufen von Informationen zu dieser Identität
uniqueName	string	Veraltet – Verwenden Sie stattdessen "Domain+PrincipalName".
url	string	Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs.
vote	integer (int16)	Abstimmung über einen Pull-Antrag: 10 - genehmigt 5 - mit Vorschlägen 0 genehmigt - keine Abstimmung -5 - warten auf Autor -10 - abgelehnt
votedFor	IdentityRefWithVote[]	Gruppen oder Teams, zu denen dieser Bearbeiter beigetragen hat. Gruppen und Teams können Prüfer für Pullanfragen sein, können aber nicht direkt abstimmen. Wenn ein Mitglied der Gruppe oder des Teams stimmt, wird diese Abstimmung in die Gruppe oder das Team abgestimmt. "VoteFor" ist eine Liste solcher Stimmen.

ItemContent

Objekt

Name	Typ	Beschreibung
content	string
contentType	ItemContentType

ItemContentType

Enumeration

Wert	Beschreibung
base64Encoded
rawText

ProjectState

Enumeration

Projektstatus.

Wert	Beschreibung
all	Alle Projekte unabhängig vom Status außer "Gelöscht".
createPending	Projekt wurde zur Erstellung in die Warteschlange gestellt, aber der Prozess wurde noch nicht gestartet.
deleted	Projekt wurde gelöscht.
deleting	Project wird gerade gelöscht.
new	Projekt wird gerade erstellt.
unchanged	Projekt wurde nicht geändert.
wellFormed	Project wird vollständig erstellt und kann verwendet werden.

ProjectVisibility

Enumeration

Projektsichtbarkeit.

Wert	Beschreibung
private	Das Projekt ist nur für Benutzer mit expliziten Zugriff sichtbar.
public	Das Projekt ist für alle sichtbar.

PullRequestAsyncStatus

Enumeration

Der aktuelle Status des Pullanforderungszusammenführungsvorgangs.

Wert	Beschreibung
conflicts	Fehler beim Zusammenführen von Pullanforderungen aufgrund von Konflikten.
failure	Fehler beim Zusammenführen von Pullanforderungen.
notSet	Status ist nicht festgelegt. Standardstatus.
queued	Pullanforderungszusammenführung wird in die Warteschlange gestellt.
rejectedByPolicy	Pullanforderungszusammenführung, die von der Richtlinie abgelehnt wurde.
succeeded	Die Zusammenführung der Pullanforderung war erfolgreich.

PullRequestMergeFailureType

Enumeration

Der Typ des Fehlers (falls vorhanden) des Zusammenführens der Pullanforderung.

Wert	Beschreibung
caseSensitive	Fehler beim Zusammenführen von Pull-Anforderungen aufgrund eines Konflikts zwischen Groß- und Kleinschreibung.
none	Der Typ ist nicht festgelegt. Standardtyp.
objectTooLarge	Fehler beim Zusammenführen von Pullanforderungen, da ein Objekt zu groß ist.
unknown	Fehlertyp der Pullanforderungszusammenführung unbekannt.

PullRequestStatus

Enumeration

Der Status der Pullanforderung.

Wert	Beschreibung
abandoned	Pull-Anforderung wird abgebrochen.
active	Pull-Anforderung ist aktiv.
all	Wird in Pull-Anforderungssuchkriterien verwendet, um alle Status einzuschließen.
completed	Die Pullanforderung ist abgeschlossen.
notSet	Status nicht festgelegt. Standardstatus.

ReferenceLinks

Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Referenzlinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

ResourceRef

Objekt

Name	Typ	Beschreibung
id	string
url	string

TeamProjectCollectionReference

Objekt

Reference-Objekt für eine TeamProjectCollection.

Name	Typ	Beschreibung
avatarUrl	string	Sammlung Avatar-URL.
id	string (uuid)	Sammlungs-ID.
name	string	Sammlungsname.
url	string	Rest-URL der Sammlung.

TeamProjectReference

Objekt

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 (uuid)	Projektbezeichner.
lastUpdateTime	string (date-time)	Zeitpunkt der letzten Aktualisierung des Projekts.
name	string	Projektname.
revision	integer (int64)	Projektrevision.
state	ProjectState	Projektstatus.
url	string	Die URL zur Vollversion des Objekts.
visibility	ProjectVisibility	Projektsichtbarkeit.

VersionControlChangeType

Enumeration

Der Typ der Änderung, die an dem Element vorgenommen wurde.

Wert	Beschreibung
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete

WebApiTagDefinition

Objekt

Die Darstellung einer Tagdefinition, die über das Netzwerk gesendet wird.

Name	Typ	Beschreibung
active	boolean	Gibt an, ob die Tagdefinition aktiv ist.
id	string (uuid)	ID der Tagdefinition.
name	string	Der Name der Tagdefinition.
url	string	Ressourcen-URL für die Tagdefinition.

Freigeben über

Pull Requests - Create

URI-Parameter

Anforderungstext

Antworten

Sicherheit

oauth2

Bereiche

Beispiele

Beispielanforderung

Beispiel für eine Antwort

Definitionen

ChangeCountDictionary

GitChange

GitCommitRef

GitForkRef

GitPullRequest

GitPullRequestCompletionOptions

GitPullRequestMergeOptions

GitPullRequestMergeStrategy

GitPushRef

GitRepository

GitRepositoryRef

GitStatus

GitStatusContext

GitStatusState

GitTemplate

GitUserDate

IdentityRef

IdentityRefWithVote

ItemContent

ItemContentType

ProjectState

ProjectVisibility

PullRequestAsyncStatus

PullRequestMergeFailureType

PullRequestStatus

ReferenceLinks

ResourceRef

TeamProjectCollectionReference

TeamProjectReference

VersionControlChangeType

WebApiTagDefinition

Zusätzliche Ressourcen