Sdílet prostřednictvím


Pull Requests - Create

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

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?api-version=7.1-preview.1
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/pullrequests?supportsIterations={supportsIterations}&api-version=7.1-preview.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. Tato verze rozhraní API by měla být nastavená na 7.1-preview.1.

supportsIterations
query

boolean

Pokud ano, následná nabízená oznámení do žádosti o přijetí změn budou jednotlivě kontrolovatelná. U velkých žádostí o přijetí změn z důvodu výkonu nastavte tuto hodnotu na false, pokud tato funkce není potřeba.

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. K vygenerování ID artefaktu pro žádost o přijetí změn použijte tuto šablonu: vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}

autoCompleteSetBy

IdentityRef

Pokud je tato možnost nastavená, je pro tuto žádost o přijetí změn povolené automatické dokončování a tato identita ji povolila.

closedBy

IdentityRef

Uživatel, který zavřel žádost o přijetí změn.

closedDate

string

Datum, kdy byla žádost o přijetí změn uzavřena (dokončena, opuštěna nebo sloučena externě).

codeReviewId

integer

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

Poslední datum, ke kterému žá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

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íce slučovacích základech

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í žádosti 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í žádosti o přijetí změn

lastMergeTargetCommit

GitCommitRef

Potvrzení v čele cílové větve v době posledního sloučení žádosti o přijetí změn.

mergeFailureMessage

string

Pokud je tato možnost nastavená, sloučení žádosti 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

ID úlohy použité ke spuštění sloučení žádosti o přijetí změn. Používá se interně.

mergeOptions

GitPullRequestMergeOptions

Možnosti použité při spuštění sloučení žádosti o přijetí změn Tyto možnosti jsou oddělené od možností dokončení, protože k dokončení dochází pouze jednou a nové sloučení se spustí pokaždé, když se změní zdrojová větev žádosti o přijetí změn.

mergeStatus

PullRequestAsyncStatus

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

pullRequestId

integer

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 kontrolorů žá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 ano, tato žádost o přijetí změn podporuje více iterací. Podpora iterace znamená, že jednotlivá oznámení do zdrojové větve žádosti o přijetí změn je možné zkontrolovat a komentáře, které zůstaly v jedné iteraci, budou sledovány v budoucích iteracích.

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

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 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í. Uděluje také možnost vytvářet a spravovat žádosti o přijetí změn a revize kódu a přijímat oznámení o událostech správy verzí prostřednictvím služby Hooks.

Příklady

Sample Request

POST https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullrequests?api-version=7.1-preview.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"
    }
  ]
}

Sample Response

{
  "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 referenčním odkazu forku

GitPullRequest

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

GitPullRequestCompletionOptions

Předvolby způsobu dokončení žádosti o přijetí změn

GitPullRequestMergeOptions

Možnosti, které se používají při vytváření sloučení žádostí o přijetí změn.

GitPullRequestMergeStrategy

Zadejte strategii, která se použije 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 zrušena, pokud SquashMerge == true. Vlastnost SquashMerge je zastaralá. Doporučuje se explicitně nastavit MergeStrategy ve všech případech. Pokud je explicitní hodnota pro MergeStrategy, SquashMerge vlastnost bude ignorována.

GitPushRef
GitRepository
GitRepositoryRef
GitStatus

Tato třída obsahuje metadata služby nebo rozšíření, které zveřejňuje stav.

GitStatusContext

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

GitStatusState

Stav stavu.

GitTemplate
GitUserDate

Informace o uživateli a datum operací 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í žádosti o přijetí změn

PullRequestMergeFailureType

Typ selhání sloučení žádosti o přijetí změn (pokud k nějakému došlo).

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, která byla provedena u položky.

WebApiTagDefinition

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

ChangeCountDictionary

GitChange

Name Typ Description
changeId

integer

ID změny v rámci skupiny změn.

changeType

VersionControlChangeType

Typ změny provedené u položky

item

string

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 k položce, 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

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

Name Typ Description
_links

ReferenceLinks

Kolekce souvisejících odkazů REST.

author

GitUserDate

Autor potvrzení

changeCounts

ChangeCountDictionary

Počty typů změn (úpravy, odstranění atd.), které jsou součástí potvrzení.

changes

GitChange[]

Výčet změn zahrnutých s potvrzením.

comment

string

Komentář nebo zpráva potvrzení

commentTruncated

boolean

Označuje, jestli je komentář zkrácený od úplné zprávy komentáře k potvrzení Gitu.

commitId

string

ID (SHA-1) potvrzení.

commitTooManyChanges

boolean

Označuje, že potvrzení obsahuje příliš mnoho změn, které se dají zobrazit.

committer

GitUserDate

Committer potvrzení.

parents

string[]

Výčet ID nadřazeného potvrzení pro toto potvrzení.

push

GitPushRef

Nasdílení změn přidružené k tomuto potvrzení

remoteUrl

string

Cesta vzdálené adresy URL k potvrzení.

statuses

GitStatus[]

Seznam metadat stavu ze služeb a rozšíření, která můžou k potvrzení přidružit další informace.

url

string

Adresa URL REST pro tento prostředek.

workItems

ResourceRef[]

Seznam pracovních položek přidružených k tomuto potvrzení.

GitForkRef

Informace o referenčním odkazu forku

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 úložiště forku.

statuses

GitStatus[]

Tato třída obsahuje metadata služby nebo rozšíření, které zveřejňuje stav.

url

string

GitPullRequest

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. K vygenerování ID artefaktu pro žádost o přijetí změn použijte tuto šablonu: vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}

autoCompleteSetBy

IdentityRef

Pokud je tato možnost nastavená, je pro tuto žádost o přijetí změn povolené automatické dokončování a identita, která ji povolila.

closedBy

IdentityRef

Uživatel, který zavřel žádost o přijetí změn.

closedDate

string

Datum, kdy byla žádost o přijetí změn uzavřena (dokončena, zrušena nebo sloučena externě).

codeReviewId

integer

ID revize 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

Poslední datum, kdy žádost o přijetí změn vstoupila do fronty k dokončení. Používá se interně.

createdBy

IdentityRef

Identita uživatele, který vytvořil žádost o přijetí změn.

creationDate

string

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 svém zdroji.

hasMultipleMergeBases

boolean

Upozornění na více sloučení

isDraft

boolean

Koncept / žá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í žádosti o přijetí změn Pokud je tato hodnota prázdná, poslední sloučení probíhá nebo bylo neúspěšné.

lastMergeSourceCommit

GitCommitRef

Potvrzení v čele zdrojové větve v době posledního sloučení žádosti o přijetí změn.

lastMergeTargetCommit

GitCommitRef

Potvrzení v čele cílové větve v době posledního sloučení žádosti o přijetí změn.

mergeFailureMessage

string

Pokud je nastavení nastavené, sloučení žádostí o přijetí změn se z tohoto důvodu nezdařilo.

mergeFailureType

PullRequestMergeFailureType

Typ selhání sloučení žádosti o přijetí změn (pokud k nějakému došlo).

mergeId

string

ID úlohy použité ke spuštění sloučení žádosti o přijetí změn Používá se interně.

mergeOptions

GitPullRequestMergeOptions

Možnosti použité při spuštění sloučení žádosti o přijetí změn Tyto možnosti jsou oddělené od možností dokončení, protože k dokončení dojde pouze jednou a nové sloučení se spustí pokaždé, když se změní zdrojová větev žádosti o přijetí změn.

mergeStatus

PullRequestAsyncStatus

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

pullRequestId

integer

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 v žá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 true, 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ůstaly 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

Předvolby způsobu dokončení žádosti o přijetí změn

Name Typ Description
autoCompleteIgnoreConfigIds

integer[]

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 hodnota true, zásady se během dokončení žádosti o přijetí změn explicitně obejdou.

bypassReason

string

Pokud se zásady obejdou, uloží se tento důvod jako důvod, proč se bypass použil.

deleteSourceBranch

boolean

Pokud je true, zdrojová větev žádosti o přijetí změn se po dokončení odstraní.

mergeCommitMessage

string

Pokud je toto nastavení nastaveno, použije se jako zpráva potvrzení sloučení.

mergeStrategy

GitPullRequestMergeStrategy

Zadejte strategii, která se použije 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 zrušena, pokud SquashMerge == true. Vlastnost SquashMerge je zastaralá. Doporučuje se explicitně nastavit MergeStrategy ve všech případech. Pokud je explicitní hodnota pro MergeStrategy, SquashMerge vlastnost bude ignorována.

squashMerge

boolean

SquashMerge je zastaralý. Měli byste explicitně nastavit hodnotu MergeStrategy. Pokud MergeStrategy je nastavena na libovolnou hodnotu, SquashMerge hodnota bude ignorována. Pokud MergeStrategy není nastaven, bude strategie sloučení no-fast-forward, pokud je tento příznak false, nebo squash, pokud je true.

transitionWorkItems

boolean

Pokud je true, 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 true, aktuální pokus o dokončení se aktivoval prostřednictvím automatického dokončení. Používá se interně.

GitPullRequestMergeOptions

Možnosti, které se používají při vytváření sloučení žádostí o přijetí změn.

Name Typ Description
conflictAuthorshipCommits

boolean

Pokud je hodnota true, řešení konfliktů použitá během sloučení se umístí do samostatných potvrzení, aby se zachovaly informace o autorství pro příčinu gitu atd.

detectRenameFalsePositives

boolean

disableRenames

boolean

Pokud je hodnota true, nebude během sloučení provedeno zjišťování přejmenování.

GitPullRequestMergeStrategy

Zadejte strategii, která se použije 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 zrušena, pokud SquashMerge == true. Vlastnost SquashMerge je zastaralá. Doporučuje se explicitně nastavit MergeStrategy ve všech případech. Pokud je explicitní hodnota pro MergeStrategy, SquashMerge vlastnost bude ignorována.

Name Typ Description
noFastForward

string

Sloučení se dvěma nadřazeným objekty bez rychlého přesměrování. Zdrojová větev se nezmění. Toto je výchozí chování.

rebase

string

Přemístit zdrojovou větev na potvrzení HEAD cílové větve a rychle dopředu cílovou větev. Zdrojová větev se aktualizuje během operace překládání.

rebaseMerge

string

Přeložte zdrojovou větev na potvrzení HEAD cílové větve a vytvořte sloučení se dvěma nadřazenci bez rychlého přesměrování. Zdrojová větev se aktualizuje během operace překládání.

squash

string

Vložte všechny změny z žádosti o přijetí změn do jednoho nadřazeného potvrzení.

GitPushRef

Name Typ Description
_links

ReferenceLinks

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

date

string

pushId

integer

pushedBy

IdentityRef

url

string

GitRepository

Name Typ Description
_links

ReferenceLinks

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

defaultBranch

string

id

string

isDisabled

boolean

True, pokud je úložiště zakázané. V ostatních případech False

isFork

boolean

Hodnota True, pokud se úložiště vytvořilo jako fork.

isInMaintenance

boolean

Hodnota True, pokud je úložiště v režimu údržby. V ostatních případech False

name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Představuje mělký odkaz na TeamProject.

remoteUrl

string

size

integer

Komprimovaná velikost (bajty) úložiště.

sshUrl

string

url

string

validRemoteUrls

string[]

webUrl

string

GitRepositoryRef

Name Typ Description
collection

TeamProjectCollectionReference

Kolekce týmových projektů, kde se nachází tento fork

id

string

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

Tato třída obsahuje metadata služby nebo rozšíření, které zveřejňuje stav.

Name Typ Description
_links

ReferenceLinks

Odkazy.

context

GitStatusContext

Kontext stavu

createdBy

IdentityRef

Identita, která vytvořila stav.

creationDate

string

Datum a čas vytvoření stavu.

description

string

Popis stavu. Obvykle popisuje aktuální stav stavu.

id

integer

Identifikátor stavu.

state

GitStatusState

Stav stavu.

targetUrl

string

Adresa URL s podrobnostmi o stavu

updatedDate

string

Datum a čas poslední aktualizace stavu.

GitStatusContext

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

Name Typ Description
genre

string

Žánr stavu. Název služby nebo nástroje, který generuje stav, může být obvykle prázdný.

name

string

Identifikátor názvu stavu nesmí být null nebo prázdný.

GitStatusState

Stav stavu.

Name Typ Description
error

string

Stav s chybou.

failed

string

Stav selhal.

notApplicable

string

Stav se nevztahuje na cílový objekt.

notSet

string

Stav není nastavený. Výchozí stav.

pending

string

Stav čeká na vyřízení.

succeeded

string

Stav byl úspěšný.

GitTemplate

Name Typ Description
name

string

Název šablony

type

string

Typ šablony

GitUserDate

Informace o uživateli a datum operací Gitu

Name Typ Description
date

string

Datum operace Git.

email

string

Email adresu uživatele, který provádí operaci Gitu.

imageUrl

string

Adresa URL avatara uživatele

name

string

Jméno uživatele, který provádí operaci Git.

IdentityRef

Name Typ Description
_links

ReferenceLinks

Toto pole neobsahuje žádný nebo více zajímavých odkazů 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 předmětu grafu.

descriptor

string

Popisovač je primárním způsobem, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejný předmět grafu v rámci účtů i organizací.

directoryAlias

string

Zastaralé – Dá se načíst dotazem na uživatele Graphu odkazovaného v položce "self" slovníku IdentityRef "_links"

displayName

string

Toto je jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém poskytovateli.

id

string

imageUrl

string

Zastaralé – k dispozici v položce "avatar" ve slovníku IdentityRef "_links"

inactive

boolean

Zastaralé – Můžete ho načíst dotazem na stav členství v Graphu, na který odkazuje položka membershipState slovníku _links GraphUser.

isAadIdentity

boolean

Zastaralé – lze odvodit z typu předmětu popisovače (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Zastaralé – Lze odvodit z typu předmětu popisovače (Descriptor.IsGroupType).

isDeletedInOrigin

boolean

profileUrl

string

Zastaralé – nepoužívá se ve většině dříve existujících implementací ToIdentityRef

uniqueName

string

Zastaralé – místo toho použijte Domain+PrincipalName.

url

string

Tato adresa URL představuje úplnou trasu ke zdrojovému prostředku tohoto předmětu grafu.

IdentityRefWithVote

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

Name Typ Description
_links

ReferenceLinks

Toto pole neobsahuje žádný nebo více zajímavých odkazů 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 předmětu grafu.

descriptor

string

Popisovač je primárním způsobem, jak odkazovat na předmět grafu, když je systém spuštěný. Toto pole jednoznačně identifikuje stejný předmět grafu v rámci účtů i organizací.

directoryAlias

string

Zastaralé – Dá se načíst dotazem na uživatele Graphu odkazovaného v položce "self" slovníku IdentityRef "_links"

displayName

string

Toto je jedinečný zobrazovaný název předmětu grafu. Pokud chcete toto pole změnit, musíte změnit jeho hodnotu ve zdrojovém poskytovateli.

hasDeclined

boolean

Označuje, jestli 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é – Můžete ho načíst dotazem na stav členství v Graphu, na který odkazuje položka membershipState slovníku _links GraphUser.

isAadIdentity

boolean

Zastaralé – lze odvodit z typu předmětu popisovače (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)

isContainer

boolean

Zastaralé – Lze odvodit z typu předmětu popisovače (Descriptor.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

Určuje, jestli by se mělo toto hlasování o schválení pořád zpracovat, i když se hlasování nezměnilo.

isRequired

boolean

Určuje, jestli se jedná o požadovaného revidujícího pro tuto žádost o přijetí změn.
Větve můžou mít zásady, které vyžadují, aby pro žádosti o přijetí změn museli být konkrétní revidující.

profileUrl

string

Zastaralé – nepoužívá se ve většině dříve 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 představuje úplnou trasu ke zdrojovému prostředku tohoto předmětu grafu.

vote

integer

Hlasování o žádosti o přijetí změn:
10 - schváleno 5 - schváleno s návrhy 0 - žádné hlasování -5 - čekání na autora -10 - zamítnuto

votedFor

IdentityRefWithVote[]

Skupiny nebo týmy, do které tento revidující přispěl.
Skupiny a týmy můžou revidovat žádosti o přijetí změn, ale nemůžou hlasovat přímo. Když člen skupiny nebo týmu hlasuje, je tento hlas zahrnut do hlasování skupiny nebo týmu. VotedFor je seznam takových hlasů.

ItemContent

Name Typ Description
content

string

contentType

ItemContentType

ItemContentType

Name Typ Description
base64Encoded

string

rawText

string

ProjectState

Stav projektu.

Name Typ Description
all

string

Všechny projekty bez ohledu na stav s výjimkou Odstraněno.

createPending

string

Projekt byl zařazen do fronty pro vytvoření, ale proces ještě nebyl zahájen.

deleted

string

Projekt byl odstraněn.

deleting

string

Projekt se právě odstraňuje.

new

string

Projekt se právě vytváří.

unchanged

string

Projekt nebyl změněn.

wellFormed

string

Projekt je zcela vytvořený a připravený k použití.

ProjectVisibility

Viditelnost projektu.

Name Typ Description
private

string

Projekt je viditelný pouze uživatelům s explicitním přístupem.

public

string

Projekt je viditelný pro všechny.

PullRequestAsyncStatus

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

Name Typ Description
conflicts

string

Sloučení žádostí o přijetí změn se nezdařilo kvůli konfliktům.

failure

string

Sloučení žádosti o přijetí změn se nezdařilo.

notSet

string

Stav není nastavený. Výchozí stav.

queued

string

Sloučení žádostí o přijetí změn je zařazeno do fronty.

rejectedByPolicy

string

Sloučení žádostí o přijetí změn odmítly zásady.

succeeded

string

Sloučení žádostí o přijetí změn bylo úspěšné.

PullRequestMergeFailureType

Typ selhání sloučení žádosti o přijetí změn (pokud k nějakému došlo).

Name Typ Description
caseSensitive

string

Sloučení žádostí o přijetí změn se nezdařilo kvůli neshodě velkých a malých písmen.

none

string

Typ není nastaven. Výchozí typ.

objectTooLarge

string

Sloučení žádosti o přijetí změn se nezdařilo kvůli příliš velkému objektu.

unknown

string

Typ chyby sloučení žádosti o přijetí změn je neznámý.

PullRequestStatus

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

Name Typ Description
abandoned

string

Žádost o přijetí změn je zrušena.

active

string

Žádost o přijetí změn je aktivní.

all

string

Používá se v kritériích hledání žádostí o přijetí změn k zahrnutí všech stavů.

completed

string

Žádost o přijetí změn je dokončena.

notSet

string

Stav není nastavený. Výchozí stav.

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

Name Typ Description
links

object

Zobrazení odkazů jen pro čtení. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako odkazy jen pro čtení.

ResourceRef

Name Typ Description
id

string

url

string

TeamProjectCollectionReference

Referenční objekt pro TeamProjectCollection.

Name Typ Description
avatarUrl

string

Adresa URL avatara kolekce.

id

string

ID kolekce.

name

string

Název kolekce.

url

string

Adresa URL REST kolekce.

TeamProjectReference

Představuje mělký odkaz na TeamProject.

Name Typ Description
abbreviation

string

Zkratka projektu

defaultTeamImageUrl

string

Adresa URL výchozího obrázku týmové identity

description

string

Popis projektu (pokud existuje).

id

string

Identifikátor projektu.

lastUpdateTime

string

Čas poslední aktualizace projektu.

name

string

Název projektu.

revision

integer

Revize projektu.

state

ProjectState

Stav projektu.

url

string

Adresa URL na plnou verzi objektu.

visibility

ProjectVisibility

Viditelnost projektu.

VersionControlChangeType

Typ změny, která byla provedena u položky.

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

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

Name Typ Description
active

boolean

Určuje, jestli je definice značky aktivní nebo ne.

id

string

ID definice značky.

name

string

Název definice značky.

url

string

Adresa URL prostředku pro definici značky