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. |
repository
|
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. |
|
include
|
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 |
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 |
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 |
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 |
ú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 |
---|---|
Change |
|
Git |
|
Git |
Poskytuje vlastnosti, které popisují potvrzení Gitu a přidružená metadata. |
Git |
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. |
Git |
|
Git |
|
Git |
Tato třída obsahuje metadata služby/rozšíření, která publikuje stav. |
Git |
Kontext stavu, který jednoznačně identifikuje stav. |
Git |
Stav. |
Git |
|
Git |
Informace a datum uživatele pro operace Gitu |
Git |
|
Git |
Možnosti verze – Určení dalších modifikátorů pro verzi (např. Předchozí) |
Git |
Typ verze (větev, značka nebo potvrzení) Určuje způsob interpretace ID. |
Identity |
|
Item |
|
Item |
|
Reference |
Třída představující kolekci odkazů REST. |
Resource |
|
Version |
Typ změny provedené v položce. |
ChangeCountDictionary
GitChange
Name | Typ | Description |
---|---|---|
changeId |
integer (int32) |
ID změny ve skupině změn |
changeType |
Typ změny provedené v položce. |
|
item |
string (T) |
Aktuální verze |
newContent |
Obsah položky po změně |
|
newContentTemplate |
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 |
Kolekce souvisejících referenčních odkazů REST. |
|
author |
Autor potvrzení. |
|
changeCounts |
Počítá typy změn (úpravy, odstranění atd.), které jsou součástí potvrzení. |
|
changes |
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 |
Potvrzení potvrzení. |
|
parents |
string[] |
Výčet ID nadřazeného potvrzení pro toto potvrzení. |
push |
Nabízené oznámení přidružené k tomuto potvrzení. |
|
remoteUrl |
string |
Vzdálená cesta URL k potvrzení. |
statuses |
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 |
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ý |
fullHistory |
Režim historie používaný |
fullHistorySimplifyMerges |
Režim historie používaný |
simplifiedHistory |
Režim historie používaný |
GitPushRef
Name | Typ | Description |
---|---|---|
_links |
Třída představující kolekci odkazů REST. |
|
date |
string (date-time) |
|
pushId |
integer (int32) |
|
pushedBy | ||
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 |
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 |
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 |
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 |
Odkazy. |
|
context |
Kontext stavu |
|
createdBy |
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 |
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. |
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 |
Možnosti verze – Určení dalších modifikátorů pro verzi (např. Předchozí) |
|
versionType |
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 |
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
Hodnota | Description |
---|---|
base64Encoded | |
rawText |
ReferenceLinks
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 |