Pull Requests - Create

Reference

Služba:: Git

Verze rozhraní API:: 7.1

Vytvořte žádost o přijetí změn.

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

S volitelnými parametry:

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
repositoryId	path	True	string	ID úložiště cílové větve žádosti o přijetí změn.
project	path		string	ID projektu nebo název projektu
api-version	query	True	string	Verze rozhraní API, která se má použít. Pokud chcete použít tuto verzi rozhraní API, měla by být nastavená na hodnotu 7.1.
supportsIterations	query		boolean	Pokud ano, následné nasdílení změn do žádosti o přijetí změn bude možné jednotlivě zkontrolovat. Tuto hodnotu nastavte na false pro velké žádosti o přijetí změn z důvodů výkonu, pokud tuto funkci nepotřebujete.

Text požadavku

Name	Typ	Description
_links	ReferenceLinks	Odkazy na další související objekty.
artifactId	string	Řetězec, který jednoznačně identifikuje tuto žádost o přijetí změn. Pokud chcete vygenerovat ID artefaktu pro žádost o přijetí změn, použijte tuto šablonu: `vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}`
autoCompleteSetBy	IdentityRef	Pokud je tato sada nastavená, je pro tuto žádost o přijetí změn povoleno automatické dokončování a jedná se o identitu, která ji povolila.
closedBy	IdentityRef	Uživatel, který žádost o přijetí změn zavřel.
closedDate	string (date-time)	Datum, kdy byla žádost o přijetí změn uzavřena (dokončena, opuštěna nebo sloučena externě).
codeReviewId	integer (int32)	ID kontroly kódu žádosti o přijetí změn. Používá se interně.
commits	GitCommitRef[]	Potvrzení obsažená v žádosti o přijetí změn.
completionOptions	GitPullRequestCompletionOptions	Možnosti, které ovlivňují způsob sloučení žádosti o přijetí změn po dokončení.
completionQueueTime	string (date-time)	Poslední datum, kdy žádost o přijetí změn vstoupila do fronty, která se má dokončit. Používá se interně.
createdBy	IdentityRef	Identita uživatele, který vytvořil žádost o přijetí změn.
creationDate	string (date-time)	Datum vytvoření žádosti o přijetí změn
description	string	Popis žádosti o přijetí změn
forkSource	GitForkRef	Pokud se jedná o žádost o přijetí změn z forku, bude obsahovat informace o jeho zdroji.
hasMultipleMergeBases	boolean	Upozornění na vícenásobné sloučení
isDraft	boolean	Koncept nebo žádost o přijetí změn WIP
labels	WebApiTagDefinition[]	Popisky přidružené k žádosti o přijetí změn
lastMergeCommit	GitCommitRef	Potvrzení posledního sloučení žádostí o přijetí změn Pokud je prázdné, probíhá poslední sloučení nebo bylo neúspěšné.
lastMergeSourceCommit	GitCommitRef	Potvrzení v záhlaví zdrojové větve v době posledního sloučení žádostí o přijetí změn.
lastMergeTargetCommit	GitCommitRef	Potvrzení v záhlaví cílové větve v době posledního sloučení žádostí o přijetí změn.
mergeFailureMessage	string	Pokud je tato sada nastavená, sloučení žádostí o přijetí změn se z tohoto důvodu nezdařilo.
mergeFailureType	PullRequestMergeFailureType	Typ selhání (pokud existuje) sloučení žádosti o přijetí změn.
mergeId	string (uuid)	ID úlohy použité ke spuštění sloučení žádostí o přijetí změn. Používá se interně.
mergeOptions	GitPullRequestMergeOptions	Možnosti používané při spuštění sloučení žádostí o přijetí změn Tyto možnosti jsou oddělené od možností dokončení, protože dokončení probíhá jenom jednou a při každé změně zdrojové větve žádosti o přijetí změn se spustí nová slučovací větev.
mergeStatus	PullRequestAsyncStatus	Aktuální stav sloučení žádostí o přijetí změn
pullRequestId	integer (int32)	ID žádosti o přijetí změn
remoteUrl	string	Používá se interně.
repository	GitRepository	Úložiště obsahující cílovou větev žádosti o přijetí změn.
reviewers	IdentityRefWithVote[]	Seznam revidujících na žádosti o přijetí změn spolu se stavem jejich hlasů.
sourceRefName	string	Název zdrojové větve žádosti o přijetí změn.
status	PullRequestStatus	Stav žádosti o přijetí změn
supportsIterations	boolean	Pokud je pravda, tato žádost o přijetí změn podporuje více iterací. Podpora iterace znamená, že jednotlivé vložení do zdrojové větve žádosti o přijetí změn je možné zkontrolovat a komentáře, které zůstanou v jedné iteraci, se budou sledovat napříč budoucími iteracemi.
targetRefName	string	Název cílové větve žádosti o přijetí změn.
title	string	Název žádosti o přijetí změn.
url	string	Používá se interně.
workItemRefs	ResourceRef[]	Všechny odkazy na pracovní položky přidružené k této žádosti o přijetí změn

Odpovědi

Name	Typ	Description
200 OK	GitPullRequest	úspěšná operace

Zabezpečení

oauth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL tokenu: 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

Rozsahy

Name	Description
vso.code_write	Uděluje možnost číst, aktualizovat a odstraňovat zdrojový kód, přistupovat k metadatům o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Umožňuje také vytvářet a spravovat žádosti o přijetí změn a kontroly kódu a přijímat oznámení o událostech správy verzí prostřednictvím volání služeb.

Příklady

Ukázkový požadavek

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"
    }
  ]
}

Ukázková odpověď

Stavový kód:: 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"
}

Definice

Name	Description
ChangeCountDictionary
GitChange
GitCommitRef	Poskytuje vlastnosti, které popisují potvrzení Gitu a přidružená metadata.
GitForkRef	Informace o forku odkaz.
GitPullRequest	Představuje všechna data přidružená k žádosti o přijetí změn.
GitPullRequestCompletionOptions	Předvolby týkající se dokončení žádosti o přijetí změn
GitPullRequestMergeOptions	Možnosti, které se použijí při vytvoření sloučení žádosti o přijetí změn.
GitPullRequestMergeStrategy	Zadejte strategii použitou ke sloučení žádosti o přijetí změn během dokončení. Pokud mergeStrategy není nastavena na žádnou hodnotu, vytvoří se sloučení no-FF, pokud SquashMerge == false. Pokud mergeStrategy není nastavena na žádnou hodnotu, potvrzení žádosti o přijetí změn budou squashed if SquashMerge == true. Vlastnost SquashMerge je zastaralá. Doporučujeme explicitně nastavit MergeStrategy ve všech případech. Pokud je pro MergeStrategy k dispozici explicitní hodnota, squashMerge vlastnost bude ignorována.
GitPushRef
GitRepository
GitRepositoryRef
GitStatus	Tato třída obsahuje metadata služby/rozšíření, která publikuje stav.
GitStatusContext	Kontext stavu, který jednoznačně identifikuje stav.
GitStatusState	Stav.
GitTemplate
GitUserDate	Informace a datum uživatele pro operace Gitu
IdentityRef
IdentityRefWithVote	Informace o identitě, včetně hlasování o žádosti o přijetí změn
ItemContent
ItemContentType
ProjectState	Stav projektu
ProjectVisibility	Viditelnost projektu
PullRequestAsyncStatus	Aktuální stav sloučení žádostí o přijetí změn
PullRequestMergeFailureType	Typ selhání (pokud existuje) sloučení žádosti o přijetí změn.
PullRequestStatus	Stav žádosti o přijetí změn
ReferenceLinks	Třída představující kolekci odkazů REST.
ResourceRef
TeamProjectCollectionReference	Referenční objekt pro TeamProjectCollection.
TeamProjectReference	Představuje mělký odkaz na TeamProject.
VersionControlChangeType	Typ změny provedené v položce.
WebApiTagDefinition	Reprezentace definice značky, která se odesílá přes drát.

ChangeCountDictionary

Objekt

GitChange

Objekt

Name	Typ	Description
changeId	integer (int32)	ID změny ve skupině změn
changeType	VersionControlChangeType	Typ změny provedené v položce.
item	string (T)	Aktuální verze
newContent	ItemContent	Obsah položky po změně
newContentTemplate	GitTemplate	Nová šablona obsahu, která se má použít při nabízení nových změn.
originalPath	string	Původní cesta položky, pokud se liší od aktuální cesty.
sourceServerItem	string	Cesta k položce na serveru
url	string	Adresa URL pro načtení položky

GitCommitRef

Objekt

Poskytuje vlastnosti, které popisují potvrzení Gitu a přidružená metadata.

Name	Typ	Description
_links	ReferenceLinks	Kolekce souvisejících referenčních odkazů REST.
author	GitUserDate	Autor potvrzení.
changeCounts	ChangeCountDictionary	Počítá typy změn (úpravy, odstranění atd.), které jsou součástí potvrzení.
changes	GitChange[]	Výčet změn zahrnutých do potvrzení.
comment	string	Okomentujte nebo zprávu potvrzení.
commentTruncated	boolean	Označuje, jestli je komentář zkrácený z úplné zprávy o komentáři potvrzení Gitu.
commitId	string	ID (SHA-1) potvrzení.
commitTooManyChanges	boolean	Označuje, že potvrzení obsahuje příliš mnoho změn, které se mají zobrazit.
committer	GitUserDate	Potvrzení potvrzení.
parents	string[]	Výčet ID nadřazeného potvrzení pro toto potvrzení.
push	GitPushRef	Nabízené oznámení přidružené k tomuto potvrzení.
remoteUrl	string	Vzdálená cesta URL k potvrzení.
statuses	GitStatus[]	Seznam metadat stavu ze služeb a rozšíření, která mohou přidružit další informace k potvrzení.
url	string	Adresa URL REST pro tento prostředek
workItems	ResourceRef[]	Seznam pracovních položek přidružených k tomuto potvrzení

GitForkRef

Objekt

Informace o forku odkaz.

Name	Typ	Description
_links	ReferenceLinks	Třída představující kolekci odkazů REST.
creator	IdentityRef
isLocked	boolean
isLockedBy	IdentityRef
name	string
objectId	string
peeledObjectId	string
repository	GitRepository	ID forku úložiště.
statuses	GitStatus[]	Tato třída obsahuje metadata služby/rozšíření, která publikuje stav.
url	string

GitPullRequest

Objekt

Představuje všechna data přidružená k žádosti o přijetí změn.

Name	Typ	Description
_links	ReferenceLinks	Odkazy na další související objekty.
artifactId	string	Řetězec, který jednoznačně identifikuje tuto žádost o přijetí změn. Pokud chcete vygenerovat ID artefaktu pro žádost o přijetí změn, použijte tuto šablonu: `vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}`
autoCompleteSetBy	IdentityRef	Pokud je tato sada nastavená, je pro tuto žádost o přijetí změn povoleno automatické dokončování a jedná se o identitu, která ji povolila.
closedBy	IdentityRef	Uživatel, který žádost o přijetí změn zavřel.
closedDate	string (date-time)	Datum, kdy byla žádost o přijetí změn uzavřena (dokončena, opuštěna nebo sloučena externě).
codeReviewId	integer (int32)	ID kontroly kódu žádosti o přijetí změn. Používá se interně.
commits	GitCommitRef[]	Potvrzení obsažená v žádosti o přijetí změn.
completionOptions	GitPullRequestCompletionOptions	Možnosti, které ovlivňují způsob sloučení žádosti o přijetí změn po dokončení.
completionQueueTime	string (date-time)	Poslední datum, kdy žádost o přijetí změn vstoupila do fronty, která se má dokončit. Používá se interně.
createdBy	IdentityRef	Identita uživatele, který vytvořil žádost o přijetí změn.
creationDate	string (date-time)	Datum vytvoření žádosti o přijetí změn
description	string	Popis žádosti o přijetí změn
forkSource	GitForkRef	Pokud se jedná o žádost o přijetí změn z forku, bude obsahovat informace o jeho zdroji.
hasMultipleMergeBases	boolean	Upozornění na vícenásobné sloučení
isDraft	boolean	Koncept nebo žádost o přijetí změn WIP
labels	WebApiTagDefinition[]	Popisky přidružené k žádosti o přijetí změn
lastMergeCommit	GitCommitRef	Potvrzení posledního sloučení žádostí o přijetí změn Pokud je prázdné, probíhá poslední sloučení nebo bylo neúspěšné.
lastMergeSourceCommit	GitCommitRef	Potvrzení v záhlaví zdrojové větve v době posledního sloučení žádostí o přijetí změn.
lastMergeTargetCommit	GitCommitRef	Potvrzení v záhlaví cílové větve v době posledního sloučení žádostí o přijetí změn.
mergeFailureMessage	string	Pokud je tato sada nastavená, sloučení žádostí o přijetí změn se z tohoto důvodu nezdařilo.
mergeFailureType	PullRequestMergeFailureType	Typ selhání (pokud existuje) sloučení žádosti o přijetí změn.
mergeId	string (uuid)	ID úlohy použité ke spuštění sloučení žádostí o přijetí změn. Používá se interně.
mergeOptions	GitPullRequestMergeOptions	Možnosti používané při spuštění sloučení žádostí o přijetí změn Tyto možnosti jsou oddělené od možností dokončení, protože dokončení probíhá jenom jednou a při každé změně zdrojové větve žádosti o přijetí změn se spustí nová slučovací větev.
mergeStatus	PullRequestAsyncStatus	Aktuální stav sloučení žádostí o přijetí změn
pullRequestId	integer (int32)	ID žádosti o přijetí změn
remoteUrl	string	Používá se interně.
repository	GitRepository	Úložiště obsahující cílovou větev žádosti o přijetí změn.
reviewers	IdentityRefWithVote[]	Seznam revidujících na žádosti o přijetí změn spolu se stavem jejich hlasů.
sourceRefName	string	Název zdrojové větve žádosti o přijetí změn.
status	PullRequestStatus	Stav žádosti o přijetí změn
supportsIterations	boolean	Pokud je pravda, tato žádost o přijetí změn podporuje více iterací. Podpora iterace znamená, že jednotlivé vložení do zdrojové větve žádosti o přijetí změn je možné zkontrolovat a komentáře, které zůstanou v jedné iteraci, se budou sledovat napříč budoucími iteracemi.
targetRefName	string	Název cílové větve žádosti o přijetí změn.
title	string	Název žádosti o přijetí změn.
url	string	Používá se interně.
workItemRefs	ResourceRef[]	Všechny odkazy na pracovní položky přidružené k této žádosti o přijetí změn

GitPullRequestCompletionOptions

Objekt

Předvolby týkající se dokončení žádosti o přijetí změn

Name	Typ	Description
autoCompleteIgnoreConfigIds	integer[] (int32)	Seznam všech ID konfigurace zásad, na které by automatické dokončování nemělo čekat. Platí jenom pro volitelné zásady (isBlocking == false). Automatické dokončování vždy čeká na požadované zásady (isBlocking == true).
bypassPolicy	boolean	Pokud je pravda, zásady se při dokončení žádosti o přijetí změn explicitně vynechá.
bypassReason	string	Pokud se zásady obejití, tento důvod se uloží, pokud jde o důvod použití obejití.
deleteSourceBranch	boolean	Pokud je hodnota true, zdrojová větev žádosti o přijetí změn se po dokončení odstraní.
mergeCommitMessage	string	Pokud je tato možnost nastavená, použije se jako zpráva potvrzení sloučení.
mergeStrategy	GitPullRequestMergeStrategy	Zadejte strategii použitou ke sloučení žádosti o přijetí změn během dokončení. Pokud mergeStrategy není nastavena na žádnou hodnotu, vytvoří se sloučení no-FF, pokud SquashMerge == false. Pokud mergeStrategy není nastavena na žádnou hodnotu, potvrzení žádosti o přijetí změn budou squashed if SquashMerge == true. Vlastnost SquashMerge je zastaralá. Doporučujeme explicitně nastavit MergeStrategy ve všech případech. Pokud je pro MergeStrategy k dispozici explicitní hodnota, squashMerge vlastnost bude ignorována.
squashMerge	boolean	SquashMerge je zastaralý. Měli byste explicitně nastavit hodnotu MergeStrategy. Pokud je MergeStrategy nastavena na libovolnou hodnotu, bude hodnota SquashMerge ignorována. Pokud mergeStrategy není nastavena, strategie sloučení nebude rychle vpřed, pokud je tento příznak false nebo squash pokud je true.
transitionWorkItems	boolean	Pokud je pravda, pokusíme se převést všechny pracovní položky propojené s žádostí o přijetí změn do dalšího logického stavu (tj. Aktivní –> Vyřešeno).
triggeredByAutoComplete	boolean	Pokud je hodnota true, aktuální pokus o dokončení se aktivoval prostřednictvím automatického dokončování. Používá se interně.

GitPullRequestMergeOptions

Objekt

Možnosti, které se použijí při vytvoření sloučení žádosti o přijetí změn.

Name	Typ	Description
conflictAuthorshipCommits	boolean	Pokud je pravda, řešení konfliktů použité během sloučení se vloží do samostatných potvrzení, aby se zachovaly informace o autorství pro git blame atd.
detectRenameFalsePositives	boolean
disableRenames	boolean	Pokud je hodnota true, detekce přejmenování se během sloučení neprovádí.

GitPullRequestMergeStrategy

Výčet

Zadejte strategii použitou ke sloučení žádosti o přijetí změn během dokončení. Pokud mergeStrategy není nastavena na žádnou hodnotu, vytvoří se sloučení no-FF, pokud SquashMerge == false. Pokud mergeStrategy není nastavena na žádnou hodnotu, potvrzení žádosti o přijetí změn budou squashed if SquashMerge == true. Vlastnost SquashMerge je zastaralá. Doporučujeme explicitně nastavit MergeStrategy ve všech případech. Pokud je pro MergeStrategy k dispozici explicitní hodnota, squashMerge vlastnost bude ignorována.

Hodnota	Description
noFastForward	Dvou nadřazené sloučení bez rychlého přeposlání Zdrojová větev se nezmění. Toto je výchozí chování.
rebase	Přemístit zdrojovou větev nad potvrzením HEAD cílové větve a rychle přesměrovat cílovou větev. Zdrojová větev se aktualizuje během operace opětovného základu.
rebaseMerge	Přeložte zdrojovou větev nad potvrzením HEAD cílové větve a vytvořte dvou nadřazené sloučení bez rychlého přeposlání. Zdrojová větev se aktualizuje během operace opětovného základu.
squash	Všechny změny z žádosti o přijetí změn vložte do potvrzení s jedním nadřazeným objektem.

GitPushRef

Objekt

Name	Typ	Description
_links	ReferenceLinks	Třída představující kolekci odkazů REST.
date	string (date-time)
pushId	integer (int32)
pushedBy	IdentityRef
url	string

GitRepository

Objekt

Name	Typ	Description
_links	ReferenceLinks	Třída představující kolekci odkazů REST.
defaultBranch	string
id	string (uuid)
isDisabled	boolean	Hodnota True, pokud je úložiště zakázané. Jinak je false.
isFork	boolean	Hodnota True, pokud se úložiště vytvořilo jako fork.
isInMaintenance	boolean	Hodnota True, pokud je úložiště v údržbě. Jinak je false.
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Představuje mělký odkaz na TeamProject.
remoteUrl	string
size	integer (int64)	Komprimovaná velikost (bajty) úložiště.
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryRef

Objekt

Name	Typ	Description
collection	TeamProjectCollectionReference	Kolekce týmových projektů, ve které se nachází tento fork
id	string (uuid)
isFork	boolean	Hodnota True, pokud se úložiště vytvořilo jako fork
name	string
project	TeamProjectReference	Představuje mělký odkaz na TeamProject.
remoteUrl	string
sshUrl	string
url	string

GitStatus

Objekt

Tato třída obsahuje metadata služby/rozšíření, která publikuje stav.

Name	Typ	Description
_links	ReferenceLinks	Odkazy.
context	GitStatusContext	Kontext stavu
createdBy	IdentityRef	Identita, která vytvořila stav
creationDate	string (date-time)	Datum a čas vytvoření stavu
description	string	Popis stavu Obvykle popisuje aktuální stav stavu.
id	integer (int32)	Identifikátor stavu
state	GitStatusState	Stav.
targetUrl	string	Adresa URL s podrobnostmi o stavu
updatedDate	string (date-time)	Datum a čas poslední aktualizace stavu

GitStatusContext

Objekt

Kontext stavu, který jednoznačně identifikuje stav.

Name	Typ	Description
genre	string	Žánr stavu. Obvykle může být název služby nebo nástroje, který generuje stav, prázdný.
name	string	Identifikátor názvu stavu nesmí být null ani prázdný.

GitStatusState

Výčet

Stav.

Hodnota	Description
error	Stav s chybou
failed	Stav se nezdařil.
notApplicable	Stav se nevztahuje na cílový objekt.
notSet	Stav není nastaven. Výchozí stav.
pending	Stav čeká na vyřízení.
succeeded	Stav byl úspěšný.

GitTemplate

Objekt

Name	Typ	Description
name	string	Název šablony
type	string	Typ šablony

GitUserDate

Objekt

Informace a datum uživatele pro operace Gitu

Name	Typ	Description
date	string (date-time)	Datum operace Git.
email	string	E-mailová adresa uživatele provádějícího operaci Git
imageUrl	string	Adresa URL avatara uživatele
name	string	Jméno uživatele, který provádí operaci Git.

IdentityRef

Objekt

Name	Typ	Description
_links	ReferenceLinks	Toto pole obsahuje nula nebo zajímavější odkazy na téma grafu. Tyto odkazy mohou být vyvolány za účelem získání dalších relací nebo podrobnějších informací o tomto tématu grafu.
descriptor	string	Popisovač je primární způsob, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejné téma grafu v rámci účtů i organizací.
directoryAlias	string	Zastaralé – Je možné načíst dotazováním uživatele Graphu, na který odkazuje položka "self" slovníku IdentityRef "_links".
displayName	string	Toto je ne jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém zprostředkovateli.
id	string
imageUrl	string	Zastaralé – k dispozici v položce avatar ve slovníku IdentityRef "_links"
inactive	boolean	Zastaralé – Lze načíst dotazem na stav členství v grafu odkazovaném v položce "membershipState" slovníku GraphUser "_links"
isAadIdentity	boolean	Zastaralé – lze odvodit z typu předmětu popisovače (Popisovač.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Zastaralé – lze odvodit z typu předmětu popisovače (Popisovač.IsGroupType)
isDeletedInOrigin	boolean
profileUrl	string	Zastaralé – nepoužívá se ve většině existujících implementací ToIdentityRef
uniqueName	string	Zastaralé – místo toho použijte Domain+PrincipalName.
url	string	Tato adresa URL je úplná trasa ke zdrojovému prostředku tohoto předmětu grafu.

IdentityRefWithVote

Objekt

Informace o identitě, včetně hlasování o žádosti o přijetí změn

Name	Typ	Description
_links	ReferenceLinks	Toto pole obsahuje nula nebo zajímavější odkazy na téma grafu. Tyto odkazy mohou být vyvolány za účelem získání dalších relací nebo podrobnějších informací o tomto tématu grafu.
descriptor	string	Popisovač je primární způsob, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejné téma grafu v rámci účtů i organizací.
directoryAlias	string	Zastaralé – Je možné načíst dotazováním uživatele Graphu, na který odkazuje položka "self" slovníku IdentityRef "_links".
displayName	string	Toto je ne jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém zprostředkovateli.
hasDeclined	boolean	Označuje, jestli tento kontrolor odmítl zkontrolovat tuto žádost o přijetí změn.
id	string
imageUrl	string	Zastaralé – k dispozici v položce avatar ve slovníku IdentityRef "_links"
inactive	boolean	Zastaralé – Lze načíst dotazem na stav členství v grafu odkazovaném v položce "membershipState" slovníku GraphUser "_links"
isAadIdentity	boolean	Zastaralé – lze odvodit z typu předmětu popisovače (Popisovač.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Zastaralé – lze odvodit z typu předmětu popisovače (Popisovač.IsGroupType)
isDeletedInOrigin	boolean
isFlagged	boolean	Označuje, jestli je tento kontrolor označený příznakem pro pozornost u této žádosti o přijetí změn.
isReapprove	boolean	Označuje, jestli by se toto hlasování o schválení stále mělo zpracovávat, i když se hlasování nezměnilo.
isRequired	boolean	Označuje, jestli se jedná o požadovaného revidujícím pro tuto žádost o přijetí změn. Větve můžou mít zásady, které vyžadují, aby se pro žádosti o přijetí změn vyžadovaly konkrétní revidujícím.
profileUrl	string	Zastaralé – nepoužívá se ve většině existujících implementací ToIdentityRef
reviewerUrl	string	Adresa URL pro načtení informací o této identitě
uniqueName	string	Zastaralé – místo toho použijte Domain+PrincipalName.
url	string	Tato adresa URL je úplná trasa ke zdrojovému prostředku tohoto předmětu grafu.
vote	integer (int16)	Hlasujte o žádosti o přijetí změn: 10 - schváleno 5 - schváleno s návrhy 0 - bez hlasování -5 - čekání na autora -10 - odmítnuto
votedFor	IdentityRefWithVote[]	Skupiny nebo týmy, ke kterým tento kontrolor přispěl. Skupiny a týmy můžou být revidujícím žádosti o přijetí změn, ale nemůžou hlasovat přímo. Když člen skupiny nebo týmu hlasuje, tento hlas se zahrne do skupiny nebo hlasování týmu. Hlasovali jsme pro tento seznam hlasů.

ItemContent

Objekt

Name	Typ	Description
content	string
contentType	ItemContentType

ItemContentType

Výčet

Hodnota	Description
base64Encoded
rawText

ProjectState

Výčet

Stav projektu

Hodnota	Description
all	Všechny projekty bez ohledu na stav kromě Odstraněno.
createPending	Projekt byl zařazen do fronty pro vytvoření, ale proces ještě nebyl spuštěn.
deleted	Projekt byl odstraněn.
deleting	Projekt probíhá v procesu odstranění.
new	Projekt probíhá při vytváření.
unchanged	Projekt nebyl změněn.
wellFormed	Projekt je zcela vytvořený a připravený k použití.

ProjectVisibility

Výčet

Viditelnost projektu

Hodnota	Description
private	Projekt je viditelný jenom uživatelům s explicitním přístupem.
public	Projekt je viditelný pro všechny.

PullRequestAsyncStatus

Výčet

Aktuální stav sloučení žádostí o přijetí změn

Hodnota	Description
conflicts	Sloučení žádostí o přijetí změn selhalo kvůli konfliktům.
failure	Sloučení žádostí o přijetí změn se nezdařilo.
notSet	Stav není nastavený. Výchozí stav.
queued	Sloučení žádostí o přijetí změn je zařazeno do fronty.
rejectedByPolicy	Sloučení žádostí o přijetí změn odmítnuté zásadami
succeeded	Sloučení žádostí o přijetí změn bylo úspěšné.

PullRequestMergeFailureType

Výčet

Typ selhání (pokud existuje) sloučení žádosti o přijetí změn.

Hodnota	Description
caseSensitive	Sloučení žádostí o přijetí změn selhalo kvůli neshodě případů.
none	Typ není nastaven. Výchozí typ.
objectTooLarge	Sloučení žádostí o přijetí změn se nezdařilo kvůli příliš velkému objektu.
unknown	Typ selhání sloučení žádostí o přijetí změn neznámý.

PullRequestStatus

Výčet

Stav žádosti o přijetí změn

Hodnota	Description
abandoned	Žádost o přijetí změn je opuštěná.
active	Žádost o přijetí změn je aktivní.
all	Používá se v kritériích hledání žádostí o přijetí změn k zahrnutí všech stavů.
completed	Žádost o přijetí změn je dokončená.
notSet	Stav není nastavený. Výchozí stav.

ReferenceLinks

Objekt

Třída představující kolekci odkazů REST.

Name	Typ	Description
links	object	Jen pro čtení odkazů. Vzhledem k tomu, že odkazy odkazy jsou jen pro čtení, chceme je zveřejnit jen pro čtení.

ResourceRef

Objekt

Name	Typ	Description
id	string
url	string

TeamProjectCollectionReference

Objekt

Referenční objekt pro TeamProjectCollection.

Name	Typ	Description
avatarUrl	string	Adresa URL avatara kolekce
id	string (uuid)	ID kolekce.
name	string	Název kolekce.
url	string	Adresa URL REST kolekce.

TeamProjectReference

Objekt

Představuje mělký odkaz na TeamProject.

Name	Typ	Description
abbreviation	string	Zkratka projektu.
defaultTeamImageUrl	string	Adresa URL výchozí image týmové identity
description	string	Popis projektu (pokud existuje).
id	string (uuid)	Identifikátor projektu.
lastUpdateTime	string (date-time)	Čas poslední aktualizace projektu
name	string	Název projektu.
revision	integer (int64)	Revize projektu
state	ProjectState	Stav projektu
url	string	Adresa URL úplné verze objektu.
visibility	ProjectVisibility	Viditelnost projektu

VersionControlChangeType

Výčet

Typ změny provedené v položce.

Hodnota	Description
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete

WebApiTagDefinition

Objekt

Reprezentace definice značky, která se odesílá přes drát.

Name	Typ	Description
active	boolean	Určuje, zda je definice značky aktivní.
id	string (uuid)	ID definice značky.
name	string	Název definice značky.
url	string	Adresa URL prostředku pro definici značky

AI Skills Fest

Sdílet prostřednictvím

Pull Requests - Create

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

oauth2

Rozsahy

Příklady

Ukázkový požadavek

Ukázková odpověď

Definice

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

Další materiály