Sdílet prostřednictvím


Commits - Get Commits Batch

Načtení potvrzení Gitu pro projekt odpovídající kritériím hledání

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commitsbatch?api-version=7.1
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commitsbatch?$skip={$skip}&$top={$top}&includeStatuses={includeStatuses}&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

Název nebo ID úložiště.

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.

$skip
query

integer (int32)

Počet potvrzení, která se mají přeskočit Hodnota nesmí překročit 3 000 000.

$top
query

integer (int32)

Maximální počet potvrzení, která se mají vrátit. Hodnota nesmí překročit 50 000.

includeStatuses
query

boolean

Hodnota True obsahuje další informace o stavu potvrzení.

Text požadavku

Name Typ Description
$skip

integer (int32)

Počet položek, které se mají přeskočit

$top

integer (int32)

Maximální počet položek, které se mají načíst

author

string

Alias nebo zobrazované jméno autora

compareVersion

GitVersionDescriptor

Platí pouze v případě, že je zadána položka ItemVersion. Pokud je k dispozici, začněte historii chůze od tohoto potvrzení.

excludeDeletes

boolean

Platí pouze v případech, kdy je zadána cesta k položce. Určuje, zda se mají vyloučit položky odstranění zadané cesty.

fromCommitId

string

Pokud je k dispozici, dolní mez pro filtrování potvrzení abecedně

fromDate

string

Pokud je k dispozici, zahrňte pouze položky historie vytvořené po tomto datu (řetězec).

historyMode

GitHistoryMode

Jaký režim historie Gitu byste měli použít. To platí jenom pro kritéria hledání, pokud je zadána ids = null a itemPath.

ids

string[]

Pokud je zadáno, určuje přesné ID potvrzení potvrzení, která se mají načíst. Nelze kombinovat s jinými parametry.

includeLinks

boolean

Zda zahrnout _links pole na mělké odkazy

includePushData

boolean

Zda zahrnout nabízené informace

includeUserImageUrl

boolean

Zda zahrnout adresu URL obrázku pro potvrzení a autory

includeWorkItems

boolean

Zda zahrnout propojené pracovní položky

itemPath

string

Cesta k položce pro hledání v části

itemVersion

GitVersionDescriptor

Pokud je k dispozici, identifikuje potvrzení nebo větev pro vyhledávání.

showOldestCommitsFirst

boolean

Pokud je tato možnost povolená, bude ignorovat parametry itemVersion a compareVersion.

toCommitId

string

Pokud je k dispozici, horní mez pro filtrování potvrzení abecedně

toDate

string

Pokud je k dispozici, uveďte pouze položky historie vytvořené před tímto datem (řetězec).

user

string

Alias nebo zobrazovaný název potvrzení

Odpovědi

Name Typ Description
200 OK

GitCommitRef[]

ú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 Uděluje možnost číst zdrojový kód a metadata o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Umožňuje také prohledávat kód a dostávat oznámení o událostech správy verzí prostřednictvím háků služby.

Příklady

Commits between two versions
Commits by a list of commit IDs

Commits between two versions

Ukázkový požadavek

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

{
  "itemVersion": {
    "versionType": "branch",
    "version": "develop"
  },
  "compareVersion": {
    "versionType": "branch",
    "version": "master"
  }
}

Ukázková odpověď

{
  "count": 17,
  "value": [
    {
      "commitId": "23d0bc5b128a10056dc68afece360d8a0fabb014",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/23d0bc5b128a10056dc68afece360d8a0fabb014",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/23d0bc5b128a10056dc68afece360d8a0fabb014"
    },
    {
      "commitId": "fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f"
    },
    {
      "commitId": "0360c963d7d86d040e9c33bba836feab14da4ad3",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-10T19:42:13Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-10T19:42:13Z"
      },
      "comment": "Fix for hello world class",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/0360c963d7d86d040e9c33bba836feab14da4ad3",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/0360c963d7d86d040e9c33bba836feab14da4ad3"
    },
    {
      "commitId": "097d82b8aeabe493bf4c3553d320ae2529bba591",
      "author": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-06-09T21:43:25Z"
      },
      "committer": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-06-09T21:43:25Z"
      },
      "comment": "fix registration page",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/097d82b8aeabe493bf4c3553d320ae2529bba591",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/097d82b8aeabe493bf4c3553d320ae2529bba591"
    },
    {
      "commitId": "33b55f7cb7e7e245323987634f960cf4a6e6bc74",
      "author": {
        "name": "Will Smythe",
        "email": "wismythe@microsoft.com",
        "date": "2014-05-02T19:17:05Z"
      },
      "committer": {
        "name": "Will Smythe",
        "email": "wismythe@microsoft.com",
        "date": "2014-05-02T19:17:05Z"
      },
      "comment": "Fixed bug in web.config file",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/33b55f7cb7e7e245323987634f960cf4a6e6bc74",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/33b55f7cb7e7e245323987634f960cf4a6e6bc74"
    },
    {
      "commitId": "aad331d8d3b131fa9ae03cf5e53965b51942618a",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-04-14T21:34:52Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-04-14T21:34:52Z"
      },
      "comment": "Fixed bug for address validation.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/aad331d8d3b131fa9ae03cf5e53965b51942618a",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/aad331d8d3b131fa9ae03cf5e53965b51942618a"
    },
    {
      "commitId": "7c18355d8c2d946c5e1ce7a56f49653854445a1a",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-28T17:05:58Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-28T17:05:58Z"
      },
      "comment": "Added validation logic.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/7c18355d8c2d946c5e1ce7a56f49653854445a1a",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/7c18355d8c2d946c5e1ce7a56f49653854445a1a"
    },
    {
      "commitId": "cdaeef70a358ede7b4dc7b4a089f3853f37a6d2c",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-27T19:51:11Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-27T19:51:11Z"
      },
      "comment": "Added validation logic for zip code.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/cdaeef70a358ede7b4dc7b4a089f3853f37a6d2c",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/cdaeef70a358ede7b4dc7b4a089f3853f37a6d2c"
    },
    {
      "commitId": "ef837766c5eb3ae81a4c663d36bf95a8aed91312",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T20:25:39Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T20:25:39Z"
      },
      "comment": "Add validation code for zip code values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/ef837766c5eb3ae81a4c663d36bf95a8aed91312",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/ef837766c5eb3ae81a4c663d36bf95a8aed91312"
    },
    {
      "commitId": "bd73638408daff89bcdac549a5a3396c9a7ce9dd",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:56:21Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:56:21Z"
      },
      "comment": "Added validation logic for zip code values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/bd73638408daff89bcdac549a5a3396c9a7ce9dd",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/bd73638408daff89bcdac549a5a3396c9a7ce9dd"
    },
    {
      "commitId": "03bea1cebffa5726da0e3c0bc1487796d0dd0ee8",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:42:24Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:42:24Z"
      },
      "comment": "Added validation logic for address values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/03bea1cebffa5726da0e3c0bc1487796d0dd0ee8",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/03bea1cebffa5726da0e3c0bc1487796d0dd0ee8"
    },
    {
      "commitId": "c093714168cdd190c1e171a803e996d685454352",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:37:32Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:37:32Z"
      },
      "comment": "Added validation logic for zip code values.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/c093714168cdd190c1e171a803e996d685454352",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/c093714168cdd190c1e171a803e996d685454352"
    },
    {
      "commitId": "3d203ea73427cec36b77a3a5a2e4f1f8ba7de170",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:00:14Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T18:00:14Z"
      },
      "comment": "Added code.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/3d203ea73427cec36b77a3a5a2e4f1f8ba7de170",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/3d203ea73427cec36b77a3a5a2e4f1f8ba7de170"
    },
    {
      "commitId": "1eea03b2ad9f14a5e7297c1307e36c980eb910ea",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T16:17:11Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-26T16:17:11Z"
      },
      "comment": "Added code.",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/1eea03b2ad9f14a5e7297c1307e36c980eb910ea",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/1eea03b2ad9f14a5e7297c1307e36c980eb910ea"
    },
    {
      "commitId": "c40b5ceb9c77096b9f59e6a9193dae527bda79d9",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:54:10Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:54:10Z"
      },
      "comment": "Added method for submitting new customer addrress.",
      "changeCounts": {
        "Edit": 2
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/c40b5ceb9c77096b9f59e6a9193dae527bda79d9",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/c40b5ceb9c77096b9f59e6a9193dae527bda79d9"
    },
    {
      "commitId": "6ff5e8f6256cc58aa062dbb1e096c1e3b3435ebe",
      "author": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:50:08Z"
      },
      "committer": {
        "name": "Howie Hilliker",
        "email": "hhill@microsoft.com",
        "date": "2014-03-10T20:50:08Z"
      },
      "comment": "Adding customer address module project",
      "changeCounts": {
        "Add": 12
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/6ff5e8f6256cc58aa062dbb1e096c1e3b3435ebe",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/6ff5e8f6256cc58aa062dbb1e096c1e3b3435ebe"
    },
    {
      "commitId": "03b1b831e41df536d836c95e2f68a42db4f3e0db",
      "author": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-02-10T21:52:47Z"
      },
      "committer": {
        "name": "Chuck Reinhart",
        "email": "fabrikamfiber3@hotmail.com",
        "date": "2014-02-10T21:52:47Z"
      },
      "comment": "Add Hello World to TFS",
      "changeCounts": {
        "Add": 5
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/03b1b831e41df536d836c95e2f68a42db4f3e0db",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/03b1b831e41df536d836c95e2f68a42db4f3e0db"
    }
  ]
}

Commits by a list of commit IDs

Ukázkový požadavek

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

{
  "ids": [
    "23d0bc5b128a10056dc68afece360d8a0fabb014",
    "fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f"
  ]
}

Ukázková odpověď

{
  "count": 2,
  "value": [
    {
      "commitId": "23d0bc5b128a10056dc68afece360d8a0fabb014",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T18:10:55Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/23d0bc5b128a10056dc68afece360d8a0fabb014",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/23d0bc5b128a10056dc68afece360d8a0fabb014"
    },
    {
      "commitId": "fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "author": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "committer": {
        "name": "Norman Paulk",
        "email": "Fabrikamfiber16@hotmail.com",
        "date": "2014-06-30T17:51:09Z"
      },
      "comment": "Better description for hello world",
      "changeCounts": {
        "Edit": 1
      },
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commits/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git/commit/fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f"
    }
  ]
}

Definice

Name Description
ChangeCountDictionary
GitChange
GitCommitRef

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

GitHistoryMode

Jaký režim historie Gitu byste měli použít. To platí jenom pro kritéria hledání, pokud je zadána ids = null a itemPath.

GitPushRef
GitQueryCommitsCriteria
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

GitVersionDescriptor
GitVersionOptions

Možnosti verze – Určení dalších modifikátorů pro verzi (např. Předchozí)

GitVersionType

Typ verze (větev, značka nebo potvrzení) Určuje způsob interpretace ID.

IdentityRef
ItemContent
ItemContentType
ReferenceLinks

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

ResourceRef
VersionControlChangeType

Typ změny provedené v položce.

ChangeCountDictionary

GitChange

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

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í

GitHistoryMode

Jaký režim historie Gitu byste měli použít. To platí jenom pro kritéria hledání, pokud je zadána ids = null a itemPath.

Hodnota Description
firstParent

Režim historie používaný git log --first-parent

fullHistory

Režim historie používaný git log --full-history

fullHistorySimplifyMerges

Režim historie používaný git log --full-history --simplify-merges

simplifiedHistory

Režim historie používaný git log. Toto je výchozí hodnota.

GitPushRef

Name Typ Description
_links

ReferenceLinks

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

date

string (date-time)

pushId

integer (int32)

pushedBy

IdentityRef

url

string

GitQueryCommitsCriteria

Name Typ Description
$skip

integer (int32)

Počet položek, které se mají přeskočit

$top

integer (int32)

Maximální počet položek, které se mají načíst

author

string

Alias nebo zobrazované jméno autora

compareVersion

GitVersionDescriptor

Platí pouze v případě, že je zadána položka ItemVersion. Pokud je k dispozici, začněte historii chůze od tohoto potvrzení.

excludeDeletes

boolean

Platí pouze v případech, kdy je zadána cesta k položce. Určuje, zda se mají vyloučit položky odstranění zadané cesty.

fromCommitId

string

Pokud je k dispozici, dolní mez pro filtrování potvrzení abecedně

fromDate

string

Pokud je k dispozici, zahrňte pouze položky historie vytvořené po tomto datu (řetězec).

historyMode

GitHistoryMode

Jaký režim historie Gitu byste měli použít. To platí jenom pro kritéria hledání, pokud je zadána ids = null a itemPath.

ids

string[]

Pokud je zadáno, určuje přesné ID potvrzení potvrzení, která se mají načíst. Nelze kombinovat s jinými parametry.

includeLinks

boolean

Zda zahrnout _links pole na mělké odkazy

includePushData

boolean

Zda zahrnout nabízené informace

includeUserImageUrl

boolean

Zda zahrnout adresu URL obrázku pro potvrzení a autory

includeWorkItems

boolean

Zda zahrnout propojené pracovní položky

itemPath

string

Cesta k položce pro hledání v části

itemVersion

GitVersionDescriptor

Pokud je k dispozici, identifikuje potvrzení nebo větev pro vyhledávání.

showOldestCommitsFirst

boolean

Pokud je tato možnost povolená, bude ignorovat parametry itemVersion a compareVersion.

toCommitId

string

Pokud je k dispozici, horní mez pro filtrování potvrzení abecedně

toDate

string

Pokud je k dispozici, uveďte pouze položky historie vytvořené před tímto datem (řetězec).

user

string

Alias nebo zobrazovaný název potvrzení

GitStatus

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

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

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

Name Typ Description
name

string

Název šablony

type

string

Typ šablony

GitUserDate

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.

GitVersionDescriptor

Name Typ Description
version

string

Identifikátor řetězce verze (název značky/větve, SHA1 potvrzení)

versionOptions

GitVersionOptions

Možnosti verze – Určení dalších modifikátorů pro verzi (např. Předchozí)

versionType

GitVersionType

Typ verze (větev, značka nebo potvrzení) Určuje způsob interpretace ID.

GitVersionOptions

Možnosti verze – Určení dalších modifikátorů pro verzi (např. Předchozí)

Hodnota Description
firstParent

První nadřazený prvek potvrzení (HEAD^)

none

Nezadá se

previousChange

Potvrzení změny položky před aktuální verzí

GitVersionType

Typ verze (větev, značka nebo potvrzení) Určuje způsob interpretace ID.

Hodnota Description
branch

Interpretace verze jako názvu větve

commit

Interpretace verze jako ID potvrzení (SHA1)

tag

Interpretace verze jako názvu značky

IdentityRef

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.

ItemContent

Name Typ Description
content

string

contentType

ItemContentType

ItemContentType

Hodnota Description
base64Encoded
rawText

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

Name Typ Description
id

string

url

string

VersionControlChangeType

Typ změny provedené v položce.

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