Pull Requests - Get Pull Requests By Project
Ruft alle Pull Requests ab, die einem angegebenen Kriterium entsprechen.
Bitte beachten Sie, dass das Beschreibungsfeld im Ergebnis bis zu 400 Symbole abgeschnitten wird.
GET https://dev.azure.com/{organization}/{project}/_apis/git/pullrequests?api-version=7.1-preview.1GET https://dev.azure.com/{organization}/{project}/_apis/git/pullrequests?searchCriteria.creatorId={searchCriteria.creatorId}&searchCriteria.includeLinks={searchCriteria.includeLinks}&searchCriteria.maxTime={searchCriteria.maxTime}&searchCriteria.minTime={searchCriteria.minTime}&searchCriteria.queryTimeRangeType={searchCriteria.queryTimeRangeType}&searchCriteria.repositoryId={searchCriteria.repositoryId}&searchCriteria.reviewerId={searchCriteria.reviewerId}&searchCriteria.sourceRefName={searchCriteria.sourceRefName}&searchCriteria.sourceRepositoryId={searchCriteria.sourceRepositoryId}&searchCriteria.status={searchCriteria.status}&searchCriteria.targetRefName={searchCriteria.targetRefName}&maxCommentLength={maxCommentLength}&$skip={$skip}&$top={$top}&api-version=7.1-preview.1URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
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.1" festgelegt werden, um diese Version der API zu verwenden. |
|
$skip
|
query |
integer int32 |
Die Anzahl der zu ignorierenden Pull Requests. Um beispielsweise die Ergebnisse 101-150 abzurufen, legen Sie oben auf 50 fest, und fahren Sie mit 100 fort. |
|
|
$top
|
query |
integer int32 |
Die Anzahl der abzurufenden Pull Requests. |
|
|
max
|
query |
integer int32 |
Wird nicht verwendet. |
|
|
search
|
query |
string uuid |
Wenn festgelegt, suchen Sie nach Pull Requests, die von dieser Identität erstellt wurden. |
|
|
search
|
query |
boolean |
Gibt an, ob das _links Feld in die flachen Verweise eingeschlossen werden soll |
|
|
search
|
query |
string date-time |
Wenn angegeben, filtert Pull Requests, die vor diesem Datum erstellt/geschlossen wurden, basierend auf dem angegebenen queryTimeRangeType. |
|
|
search
|
query |
string date-time |
Wenn angegeben, filtert Pull Requests, die nach diesem Datum erstellt/geschlossen werden, basierend auf dem angegebenen queryTimeRangeType. |
|
|
search
|
query |
Pull |
Der Typ des Zeitbereichs, der für minTime und maxTime verwendet werden soll. Standardmäßig auf Erstellt, wenn nicht festgelegt. |
|
|
search
|
query |
string uuid |
Wenn festgelegt, suchen Sie nach Pull Requests, deren Zielbranch sich in diesem Repository befindet. |
|
|
search
|
query |
string uuid |
Wenn festgelegt, suchen Sie nach Pull Requests, die diese Identität als Prüfer aufweisen. |
|
|
search
|
query |
string |
Wenn festgelegt, suchen Sie nach Pull Requests aus diesem Branch. |
|
|
search
|
query |
string uuid |
Wenn festgelegt, suchen Sie nach Pull Requests, deren Quellbranch sich in diesem Repository befindet. |
|
|
search
|
query |
Pull |
Wenn festgelegt, suchen Sie nach Pull Requests, die sich in diesem Zustand befinden. Wird standardmäßig auf Aktiv festgelegt, wenn nicht festgelegt. |
|
|
search
|
query |
string |
Wenn festgelegt, suchen Sie in diesem Branch nach Pull Requests. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Git |
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
Pull requests by project
Sample Request
GET https://dev.azure.com/fabrikam/2016_10_31/_apis/git/pullrequests?api-version=7.1-preview.1
Sample Response
{
"value": [
{
"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",
"state": "unchanged"
}
},
"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": "succeeded",
"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"
},
"lastMergeCommit": {
"commitId": "39f52d24533cc712fc845ed9fd1b6c06b3942588",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/39f52d24533cc712fc845ed9fd1b6c06b3942588"
},
"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",
"supportsIterations": true
},
{
"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",
"state": "unchanged"
}
},
"pullRequestId": 21,
"codeReviewId": 21,
"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:23.8410158Z",
"title": "Added known issues document",
"description": "Added known issues document",
"sourceRefName": "refs/heads/npaulk/known_issues",
"targetRefName": "refs/heads/new_feature",
"mergeStatus": "succeeded",
"mergeId": "58a34c62-01b5-4029-8337-c99782ee9003",
"lastMergeSourceCommit": {
"commitId": "05ce817c4692afc93c1eb952643bdf7ffbab18ee",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/05ce817c4692afc93c1eb952643bdf7ffbab18ee"
},
"lastMergeTargetCommit": {
"commitId": "f47bbc106853afe3c1b07a81754bce5f4b8dbf62",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
},
"lastMergeCommit": {
"commitId": "bf27525b51b5347483ed9d7dc52ce5a3cf2b045a",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/bf27525b51b5347483ed9d7dc52ce5a3cf2b045a"
},
"reviewers": [
{
"reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/21/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/21",
"supportsIterations": true
},
{
"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",
"state": "unchanged"
}
},
"pullRequestId": 1,
"codeReviewId": 1,
"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-10-31T20:20:32.3087249Z",
"title": "some_branch edit",
"description": " - Updated README.md",
"sourceRefName": "refs/heads/some_branch",
"targetRefName": "refs/heads/master",
"mergeStatus": "succeeded",
"mergeId": "b294fd81-d539-461d-b271-71a6e61f3c24",
"lastMergeSourceCommit": {
"commitId": "34a9e500f29d119802a828d7a759f6fa2e546750",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/34a9e500f29d119802a828d7a759f6fa2e546750"
},
"lastMergeTargetCommit": {
"commitId": "f47bbc106853afe3c1b07a81754bce5f4b8dbf62",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
},
"lastMergeCommit": {
"commitId": "41e98d9939cf4ec0ce166079c22e2b40de862cf5",
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/41e98d9939cf4ec0ce166079c22e2b40de862cf5"
},
"reviewers": [
{
"reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/1/reviewers/98d08d98-a075-46e7-a81e-21bc6f12cae7",
"vote": 0,
"id": "98d08d98-a075-46e7-a81e-21bc6f12cae7",
"displayName": "[2016_10_31]\\2016_10_31 Team",
"uniqueName": "vstfs:///Classification/TeamProject/a7573007-bbb3-4341-b726-0c4148a07853\\2016_10_31 Team",
"url": "https://dev.azure.com/fabrikam/_apis/Identities/98d08d98-a075-46e7-a81e-21bc6f12cae7",
"imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=98d08d98-a075-46e7-a81e-21bc6f12cae7",
"isContainer": true
}
],
"url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/1",
"supportsIterations": true
}
],
"count": 3
}Definitionen
| Name | Beschreibung |
|---|---|
|
Change |
|
|
Git |
|
|
Git |
Stellt Eigenschaften bereit, die einen Git-Commit und die zugehörigen Metadaten beschreiben. |
|
Git |
Informationen zu einem Fork-Ref. |
|
Git |
Stellt alle Daten dar, die einem Pull Request zugeordnet sind. |
|
Git |
Einstellungen dazu, wie der Pull Request abgeschlossen werden soll. |
|
Git |
Die Optionen, die beim Erstellen einer Pull Request-Zusammenführung verwendet werden. |
|
Git |
Geben Sie die Strategie an, die zum Zusammenführen des Pull Requests während des Abschlusses verwendet wird. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, wird ein No-FF-Merge erstellt, wenn SquashMerge == false ist. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, werden die Pull Request-Commits gequetscht, wenn SquashMerge == true ist. Die SquashMerge-Eigenschaft ist veraltet. Es wird empfohlen, MergeStrategy in allen Fällen explizit festzulegen. Wenn für MergeStrategy ein expliziter Wert angegeben wird, wird die SquashMerge-Eigenschaft ignoriert. |
|
Git |
|
|
Git |
|
|
Git |
|
|
Git |
Diese Klasse enthält die Metadaten eines Diensts bzw. einer Erweiterung, die eine status. |
|
Git |
Statuskontext, der die status eindeutig identifiziert. |
|
Git |
Zustand des status. |
|
Git |
|
|
Git |
Benutzerinformationen und Datum für Git-Vorgänge. |
|
Identity |
|
|
Identity |
Identitätsinformationen, einschließlich einer Abstimmung über einen Pull Request. |
|
Item |
|
|
Item |
|
|
Project |
Projektstatus. |
|
Project |
Projektsichtbarkeit. |
|
Pull |
Die aktuelle status der Pull Request-Zusammenführung. |
|
Pull |
Der Typ des Fehlers (sofern vorhanden) der Pull Request-Merge. |
|
Pull |
Die status des Pull Requests. |
|
Pull |
Der Typ des Zeitbereichs, der für minTime und maxTime verwendet werden soll. Standardwert: Erstellt, wenn nicht festgelegt. |
|
Reference |
Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
|
Resource |
|
|
Team |
Referenzobjekt für eine TeamProjectCollection. |
|
Team |
Stellt einen flachen Verweis auf ein TeamProject dar. |
|
Version |
Der Typ der Änderung, die am Element vorgenommen wurde. |
|
Web |
Die Darstellung einer Tagdefinition, die über das Kabel gesendet wird. |
ChangeCountDictionary
GitChange
| Name | Typ | Beschreibung |
|---|---|---|
| changeId |
integer |
ID der Änderung innerhalb der Gruppe der Änderungen. |
| changeType |
Version |
Der Typ der Änderung, die am Element vorgenommen wurde. |
| item |
string |
Aktuelle Version. |
| newContent |
Item |
Inhalt des Elements nach der Änderung. |
| newContentTemplate |
Git |
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 |
Reference |
Eine Auflistung verwandter REST-Verweislinks. |
| author |
Git |
Autor des Commits. |
| changeCounts |
Change |
Anzahl der Im Commit enthaltenen Arten von Änderungen (Bearbeitungen, Löschungen usw.). |
| changes |
Git |
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 |
Git |
Committer des Commits. |
| parents |
string[] |
Eine Enumeration der übergeordneten Commit-IDs für diesen Commit. |
| push |
Git |
Der push, der diesem Commit zugeordnet ist. |
| remoteUrl |
string |
Remote-URL-Pfad zum Commit. |
| statuses |
Git |
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 |
Resource |
Eine Liste der Arbeitselemente, die diesem Commit zugeordnet sind. |
GitForkRef
Informationen zu einem Fork-Ref.
| Name | Typ | Beschreibung |
|---|---|---|
| _links |
Reference |
Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
| creator |
Identity |
|
| isLocked |
boolean |
|
| isLockedBy |
Identity |
|
| name |
string |
|
| objectId |
string |
|
| peeledObjectId |
string |
|
| repository |
Git |
Die Repository-ID des Forks. |
| statuses |
Git |
Diese Klasse enthält die Metadaten eines Diensts bzw. einer Erweiterung, die eine status. |
| url |
string |
GitPullRequest
Stellt alle Daten dar, die einem Pull Request zugeordnet sind.
| Name | Typ | Beschreibung |
|---|---|---|
| _links |
Reference |
Links zu anderen verwandten Objekten. |
| artifactId |
string |
Eine Zeichenfolge, die diesen Pull Request eindeutig identifiziert. Verwenden Sie diese Vorlage, um eine Artefakt-ID für einen Pull Request zu generieren: |
| autoCompleteSetBy |
Identity |
Wenn dieser Wert festgelegt ist, ist die automatische Vervollständigung für diesen Pull Request aktiviert, und dies ist die Identität, die ihn aktiviert hat. |
| closedBy |
Identity |
Der Benutzer, der den Pull Request geschlossen hat. |
| closedDate |
string |
Das Datum, an dem der Pull Request geschlossen wurde (abgeschlossen, abgebrochen oder extern zusammengeführt). |
| codeReviewId |
integer |
Die Codeüberprüfungs-ID des Pull Requests. Wird intern verwendet. |
| commits |
Git |
Die im Pull Request enthaltenen Commits. |
| completionOptions |
Git |
Optionen, die sich darauf auswirken, wie der Pull Request nach Abschluss zusammengeführt wird. |
| completionQueueTime |
string |
Das letzte Datum, an dem der Pull Request in die Warteschlange gelangt ist, die abgeschlossen werden soll. Wird intern verwendet. |
| createdBy |
Identity |
Die Identität des Benutzers, der den Pull Request erstellt hat. |
| creationDate |
string |
Das Datum, an dem der Pull Request erstellt wurde. |
| description |
string |
Die Beschreibung des Pull Requests. |
| forkSource |
Git |
Wenn dies ein PR von einem Fork ist, enthält dieser Informationen über die Quelle. |
| hasMultipleMergeBases |
boolean |
Warnung zu mehreren Mergebases |
| isDraft |
boolean |
Entwurf/WIP-Pull Request. |
| labels |
Web |
Die dem Pull Request zugeordneten Bezeichnungen. |
| lastMergeCommit |
Git |
Der Commit des letzten Pull Request-Merges. Wenn leer, wird die letzte Zusammenführung ausgeführt oder war nicht erfolgreich. |
| lastMergeSourceCommit |
Git |
Der Commit am Anfang des Quellbranchs zum Zeitpunkt der letzten Pull Request-Zusammenführung. |
| lastMergeTargetCommit |
Git |
Der Commit am Anfang des Zielbranchs zum Zeitpunkt der letzten Pull Request-Zusammenführung. |
| mergeFailureMessage |
string |
Falls festgelegt, ist die Pull Request-Zusammenführung aus diesem Grund fehlgeschlagen. |
| mergeFailureType |
Pull |
Der Typ des Fehlers (sofern vorhanden) der Pull Request-Merge. |
| mergeId |
string |
Die ID des Auftrags, der zum Ausführen des Pull Request-Merges verwendet wird. Wird intern verwendet. |
| mergeOptions |
Git |
Optionen, die verwendet werden, wenn die Pull Request-Mergeausführung ausgeführt wird. Diese sind von den Vervollständigungsoptionen getrennt, da der Abschluss nur einmal erfolgt und bei jeder Änderung des Quellbranchs des Pull Request eine neue Zusammenführung ausgeführt wird. |
| mergeStatus |
Pull |
Die aktuelle status der Pull Request-Zusammenführung. |
| pullRequestId |
integer |
Die ID des Pull Requests. |
| remoteUrl |
string |
Wird intern verwendet. |
| repository |
Git |
Das Repository, das den Zielbranch des Pull Requests enthält. |
| reviewers |
Identity |
Eine Liste der Prüfer im Pull Request zusammen mit dem Status ihrer Stimmen. |
| sourceRefName |
string |
Der Name des Quellbranchs des Pull Requests. |
| status |
Pull |
Die status des Pull Requests. |
| supportsIterations |
boolean |
Wenn true, unterstützt dieser Pull Request mehrere Iterationen. Iterationsunterstützung bedeutet, dass einzelne Pushvorgänge an den Quellbranch des Pull Requests überprüft werden können, und Kommentare, die in einer Iteration verbleiben, über zukünftige Iterationen hinweg nachverfolgt werden. |
| targetRefName |
string |
Der Name des Zielbranchs des Pull Requests. |
| title |
string |
Der Titel des Pull Requests. |
| url |
string |
Wird intern verwendet. |
| workItemRefs |
Resource |
Alle Arbeitselementverweise, die diesem Pull Request zugeordnet sind. |
GitPullRequestCompletionOptions
Einstellungen dazu, wie der Pull Request abgeschlossen werden soll.
| Name | Typ | Beschreibung |
|---|---|---|
| autoCompleteIgnoreConfigIds |
integer[] |
Liste aller Richtlinienkonfigurations-IDs, auf die die automatische Vervollständigung nicht warten sollte. Gilt nur für optionale Richtlinien (isBlocking == false). Die automatische Vervollständigung wartet immer auf erforderliche Richtlinien (isBlocking == true). |
| bypassPolicy |
boolean |
Wenn true, werden Richtlinien explizit umgangen, während der Pull Request abgeschlossen ist. |
| bypassReason |
string |
Wenn Richtlinien umgangen werden, wird dieser Grund als Grund für die Verwendung der Umgehung gespeichert. |
| deleteSourceBranch |
boolean |
Wenn true, wird der Quellbranch des Pull Requests nach Abschluss gelöscht. |
| mergeCommitMessage |
string |
Wenn festgelegt, wird dies als Commitmeldung des Mergecommits verwendet. |
| mergeStrategy |
Git |
Geben Sie die Strategie an, die zum Zusammenführen des Pull Requests während des Abschlusses verwendet wird. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, wird ein No-FF-Merge erstellt, wenn SquashMerge == false ist. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, werden die Pull Request-Commits gequetscht, wenn SquashMerge == true ist. Die SquashMerge-Eigenschaft ist veraltet. Es wird empfohlen, MergeStrategy in allen Fällen explizit festzulegen. Wenn für MergeStrategy ein expliziter Wert angegeben wird, wird die SquashMerge-Eigenschaft ignoriert. |
| squashMerge |
boolean |
SquashMerge ist veraltet. Sie sollten den Wert von MergeStrategy explizit festlegen. Wenn MergeStrategy auf einen beliebigen Wert festgelegt ist, wird der SquashMerge-Wert ignoriert. Wenn MergeStrategy nicht festgelegt ist, ist die Mergestrategie no-Fast-Forward, wenn dieses Flag false ist, oder squashen, wenn true. |
| transitionWorkItems |
boolean |
Wenn true, versuchen wir, alle Arbeitselemente, die mit dem Pull Request verknüpft sind, in den nächsten logischen Zustand (d. h. Aktiv –> Aufgelöst) zu übertragen. |
| triggeredByAutoComplete |
boolean |
Wenn true, wurde der aktuelle Vervollständigungsversuch über die automatische Vervollständigung ausgelöst. Wird intern verwendet. |
GitPullRequestMergeOptions
Die Optionen, die beim Erstellen einer Pull Request-Zusammenführung verwendet werden.
| Name | Typ | Beschreibung |
|---|---|---|
| conflictAuthorshipCommits |
boolean |
Wenn true, werden während der Zusammenführung angewendete Konfliktauflösungen in separate Commits eingefügt, um Autoreninformationen für Git Blame usw. beizubehalten. |
| detectRenameFalsePositives |
boolean |
|
| disableRenames |
boolean |
Wenn true, wird die Umbenennungserkennung während der Zusammenführung nicht ausgeführt. |
GitPullRequestMergeStrategy
Geben Sie die Strategie an, die zum Zusammenführen des Pull Requests während des Abschlusses verwendet wird. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, wird ein No-FF-Merge erstellt, wenn SquashMerge == false ist. Wenn MergeStrategy nicht auf einen Wert festgelegt ist, werden die Pull Request-Commits gequetscht, wenn SquashMerge == true ist. Die SquashMerge-Eigenschaft ist veraltet. Es wird empfohlen, MergeStrategy in allen Fällen explizit festzulegen. Wenn für MergeStrategy ein expliziter Wert angegeben wird, wird die SquashMerge-Eigenschaft ignoriert.
| Name | Typ | Beschreibung |
|---|---|---|
| noFastForward |
string |
Eine Zusammenführung mit zwei übergeordneten Fast-Forward. Der Quellbranch bleibt unverändert. Dies ist das Standardverhalten. |
| rebase |
string |
Neubasieren Sie den Quellbranch auf dem Zielbranch HEAD Commit, und Fast-Forward den Zielbranch. Der Quellbranch wird während des Rebasevorgangs aktualisiert. |
| rebaseMerge |
string |
Rebasen Sie den Quellbranch auf dem Zielbranch HEAD Commit, und erstellen Sie eine Zusammenführung ohne Fast-Forward mit zwei übergeordneten Fast-Forward. Der Quellbranch wird während des Rebasevorgangs aktualisiert. |
| squash |
string |
Fügen Sie alle Änderungen aus dem Pull Request in einen allein übergeordneten Commit ein. |
GitPushRef
| Name | Typ | Beschreibung |
|---|---|---|
| _links |
Reference |
Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
| date |
string |
|
| pushId |
integer |
|
| pushedBy |
Identity |
|
| url |
string |
GitRepository
| Name | Typ | Beschreibung |
|---|---|---|
| _links |
Reference |
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 |
Git |
|
| project |
Team |
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 |
Team |
Team Project Collection, in der sich dieser Fork befindet |
| id |
string |
|
| isFork |
boolean |
True, wenn das Repository als Fork erstellt wurde |
| name |
string |
|
| project |
Team |
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 |
Reference |
Referenzlinks. |
| context |
Git |
Kontext des status. |
| createdBy |
Identity |
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 |
Git |
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
Zustand des 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. |
|
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 |
Reference |
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. |
IdentityRefWithVote
Identitätsinformationen, einschließlich einer Abstimmung über einen Pull Request.
| Name | Typ | Beschreibung |
|---|---|---|
| _links |
Reference |
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. |
| hasDeclined |
boolean |
Gibt an, ob dieser Prüfer die Überprüfung dieses Pull Requests abgelehnt hat. |
| 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 |
|
| isFlagged |
boolean |
Gibt an, ob dieser Prüfer für aufmerksamkeitserregend für diesen Pull Request gekennzeichnet ist. |
| isReapprove |
boolean |
Gibt an, ob diese Genehmigungsabstimmung weiterhin behandelt werden soll, obwohl sich die Abstimmung nicht geändert hat. |
| isRequired |
boolean |
Gibt an, ob dies ein erforderlicher Prüfer für diesen Pull Request ist. |
| profileUrl |
string |
Veraltet– wird in den meisten vorhandenen Implementierungen von ToIdentityRef nicht 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 |
Abstimmung über einen Pull Request: |
| votedFor |
Identity |
Gruppen oder Teams, zu denen dieser Prüfer beigetragen hat. |
ItemContent
| Name | Typ | Beschreibung |
|---|---|---|
| content |
string |
|
| contentType |
Item |
ItemContentType
| Name | Typ | Beschreibung |
|---|---|---|
| base64Encoded |
string |
|
| rawText |
string |
ProjectState
Projektstatus.
| Name | Typ | Beschreibung |
|---|---|---|
| all |
string |
Alle Projekte unabhängig vom Zustand mit Ausnahme von "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. |
PullRequestAsyncStatus
Die aktuelle status der Pull Request-Zusammenführung.
| Name | Typ | Beschreibung |
|---|---|---|
| conflicts |
string |
Fehler beim Zusammenführen von Pull Requests aufgrund von Konflikten. |
| failure |
string |
Fehler beim Zusammenführen von Pull Requests. |
| notSet |
string |
Der Status ist nicht festgelegt. Standardzustand. |
| queued |
string |
Pull Request Merge wird in die Warteschlange eingereiht. |
| rejectedByPolicy |
string |
Pull Request Merge wird von der Richtlinie abgelehnt. |
| succeeded |
string |
Pull Request Merge erfolgreich. |
PullRequestMergeFailureType
Der Typ des Fehlers (sofern vorhanden) der Pull Request-Merge.
| Name | Typ | Beschreibung |
|---|---|---|
| caseSensitive |
string |
Fehler bei der Zusammenführung von Pull Requests aufgrund eines Konflikts zwischen Groß- und Kleinschreibung. |
| none |
string |
Der Typ ist nicht festgelegt. Standardtyp. |
| objectTooLarge |
string |
Fehler beim Zusammenführen von Pull Requests, weil ein Objekt zu groß ist. |
| unknown |
string |
Fehlertyp der Pull Request-Zusammenführung unbekannt. |
PullRequestStatus
Die status des Pull Requests.
| Name | Typ | Beschreibung |
|---|---|---|
| abandoned |
string |
Pull Request wird abgebrochen. |
| active |
string |
Pull Request ist aktiv. |
| all |
string |
Wird in Pull Request-Suchkriterien verwendet, um alle Status einzuschließen. |
| completed |
string |
Der Pull Request ist abgeschlossen. |
| notSet |
string |
Status nicht festgelegt. Standardzustand. |
PullRequestTimeRangeType
Der Typ des Zeitbereichs, der für minTime und maxTime verwendet werden soll. Standardwert: Erstellt, wenn nicht festgelegt.
| Name | Typ | Beschreibung |
|---|---|---|
| closed |
string |
Das Datum, an dem der Pull Request geschlossen wurde (abgeschlossen, abgebrochen oder extern zusammengeführt). |
| created |
string |
Das Datum, an dem der Pull Request erstellt wurde. |
ReferenceLinks
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ätsimage. |
| description |
string |
Die Projektbeschreibung (falls vorhanden). |
| id |
string |
Projektbezeichner. |
| lastUpdateTime |
string |
Zeitpunkt der letzten Aktualisierung des Projekts. |
| name |
string |
Der Projektname. |
| revision |
integer |
Projektrevision. |
| state |
Project |
Projektstatus. |
| url |
string |
URL zur Vollversion des Objekts. |
| visibility |
Project |
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 |
WebApiTagDefinition
Die Darstellung einer Tagdefinition, die über das Kabel gesendet wird.
| Name | Typ | Beschreibung |
|---|---|---|
| active |
boolean |
Gibt an, ob die Tagdefinition aktiv ist. |
| id |
string |
ID der Tagdefinition. |
| name |
string |
Der Name der Tagdefinition. |
| url |
string |
Ressourcen-URL für die Tagdefinition. |
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für