Udostępnij za pośrednictwem

Commits - Get Commits Batch

  • Odwołanie
Usługa:
Git
Wersja interfejsu API:
7.1

Pobieranie zatwierdzeń git dla projektu spełniającego kryteria wyszukiwania

POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commitsbatch?api-version=7.1
Z parametrami opcjonalnymi: 
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commitsbatch?$skip={$skip}&$top={$top}&includeStatuses={includeStatuses}&api-version=7.1

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
 path True

string

Nazwa organizacji usługi Azure DevOps.
repositoryId
 path True

string

Nazwa lub identyfikator repozytorium.
project
 path

string

Identyfikator projektu lub nazwa projektu
api-version
 query True

string

Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.
$skip
 query

integer (int32)

Liczba zatwierdzeń do pominięcia. Wartość nie może przekraczać 3000 000.
$top
 query

integer (int32)

Maksymalna liczba zatwierdzeń do zwrócenia. Wartość nie może przekraczać 50 000.
includeStatuses
 query

boolean

Wartość True, aby uwzględnić dodatkowe informacje o stanie zatwierdzenia.

Treść żądania

Nazwa Typ Opis
$skip

integer (int32)

Liczba wpisów do pominięcia
$top

integer (int32)

Maksymalna liczba wpisów do pobrania
author

string

Alias lub nazwa wyświetlana autora
compareVersion

GitVersionDescriptor

Dotyczy tylko wtedy, gdy określono element ItemVersion. Jeśli zostanie podana, rozpocznij od tego zatwierdzenia historię chodzenia.
excludeDeletes

boolean

Ma zastosowanie tylko wtedy, gdy parametr itemPath jest określony. Określa, czy należy wykluczyć wpisy usuwania określonej ścieżki.
fromCommitId

string

Jeśli zostanie podana, dolna granica dotycząca filtrowania zatwierdzeń alfabetycznie
fromDate

string

Jeśli zostanie podana, uwzględnij tylko wpisy historii utworzone po tej dacie (ciąg)
historyMode

GitHistoryMode

Jakiego trybu historii usługi Git należy użyć. Dotyczy to tylko kryteriów wyszukiwania, gdy określono identyfikatory = null i element itemPath.
ids

string[]

Jeśli zostanie podana, określa dokładne identyfikatory zatwierdzeń do pobrania. Nie można łączyć z innymi parametrami.
includeLinks

boolean

Czy należy uwzględnić pole _links na płytkich odwołaniach
includePushData

boolean

Czy należy uwzględnić informacje wypychane
includeUserImageUrl

boolean

Czy dołączyć adres URL obrazu dla osób zatwierdzających i autorów
includeWorkItems

boolean

Czy dołączać połączone elementy robocze
itemPath

string

Ścieżka elementu do wyszukiwania w obszarze
itemVersion

GitVersionDescriptor

Jeśli zostanie podana, identyfikuje zatwierdzenie lub gałąź do wyszukiwania
showOldestCommitsFirst

boolean

Jeśli ta opcja jest włączona, ta opcja zignoruje parametry itemVersion i compareVersion
toCommitId

string

Jeśli zostanie podana, górna granica dotycząca filtrowania zatwierdzeń alfabetycznie
toDate

string

Jeśli zostanie podana, uwzględnij tylko wpisy historii utworzone przed tą datą (ciąg)
user

string

Alias lub nazwa wyświetlana obiektu zatwierdzającego

Odpowiedzi

Nazwa Typ Opis
200 OK

GitCommitRef[]

operacja zakończona powodzeniem

Zabezpieczenia

oauth2

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

Zakresy

Nazwa Opis
vso.code Przyznaje możliwość odczytywania kodu źródłowego i metadanych dotyczących zatwierdzeń, zestawów zmian, gałęzi i innych artefaktów kontroli wersji. Umożliwia również wyszukiwanie kodu i otrzymywanie powiadomień o zdarzeniach kontroli wersji za pośrednictwem punktów zaczepienia usługi.

Przykłady

Commits between two versions
Commits by a list of commit IDs

Commits between two versions

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
200 
{
  "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

Przykładowe żądanie

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

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

Przykładowa odpowiedź

Kod stanu:
200 
{
  "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"
    }
  ]
}

Definicje

Nazwa Opis
ChangeCountDictionary
GitChange
GitCommitRef

Zawiera właściwości opisujące zatwierdzenie usługi Git i skojarzone metadane.
GitHistoryMode

Jakiego trybu historii usługi Git należy użyć. Dotyczy to tylko kryteriów wyszukiwania, gdy określono identyfikatory = null i element itemPath.
GitPushRef
GitQueryCommitsCriteria
GitStatus

Ta klasa zawiera metadane usługi/rozszerzenia publikujące stan.
GitStatusContext

Kontekst stanu, który jednoznacznie identyfikuje stan.
GitStatusState

Stan stanu.
GitTemplate
GitUserDate

Informacje o użytkowniku i data operacji usługi Git.
GitVersionDescriptor
GitVersionOptions

Opcje wersji — określ dodatkowe modyfikatory do wersji (np. Poprzednie)
GitVersionType

Typ wersji (gałąź, tag lub zatwierdzenie). Określa, jak identyfikator jest interpretowany
IdentityRef
ItemContent
ItemContentType
ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.
ResourceRef
VersionControlChangeType

Typ zmiany wprowadzonej w elemencie.

ChangeCountDictionary

Objekt

GitChange

Objekt
Nazwa Typ Opis
changeId

integer (int32)

Identyfikator zmiany w grupie zmian.
changeType

VersionControlChangeType

Typ zmiany wprowadzonej w elemencie.
item

string (T)

Bieżąca wersja.
newContent

ItemContent

Zawartość elementu po zmianie.
newContentTemplate

GitTemplate

Nowy szablon zawartości do użycia podczas wypychania nowych zmian.
originalPath

string

Oryginalna ścieżka elementu, jeśli różni się od bieżącej ścieżki.
sourceServerItem

string

Ścieżka elementu na serwerze.
url

string

Adres URL pobierania elementu.

GitCommitRef

Objekt

Zawiera właściwości opisujące zatwierdzenie usługi Git i skojarzone metadane.

Nazwa Typ Opis
_links

ReferenceLinks

Kolekcja powiązanych linków referencyjnych REST.
author

GitUserDate

Autor zatwierdzenia.
changeCounts

ChangeCountDictionary

Liczba typów zmian (edycji, usuwania itp.) uwzględnionych w zatwierdzeniu.
changes

GitChange[]

Wyliczenie zmian uwzględnionych w zatwierdzeniu.
comment

string

Komentarz lub wiadomość zatwierdzenia.
commentTruncated

boolean

Wskazuje, czy komentarz jest obcięty z pełnego komunikatu komentarza zatwierdzenia usługi Git.
commitId

string

Identyfikator (SHA-1) zatwierdzenia.
commitTooManyChanges

boolean

Wskazuje, że zatwierdzenie zawiera zbyt wiele zmian do wyświetlenia
committer

GitUserDate

Zatwierdzanie zatwierdzenia.
parents

string[]

Wyliczenie identyfikatorów zatwierdzeń nadrzędnych dla tego zatwierdzenia.
push

GitPushRef

Wypychanie skojarzone z tym zatwierdzeniem.
remoteUrl

string

Zdalna ścieżka adresu URL do zatwierdzenia.
statuses

GitStatus[]

Lista metadanych stanu z usług i rozszerzeń, które mogą kojarzyć dodatkowe informacje z zatwierdzeniem.
url

string

Adres URL REST dla tego zasobu.
workItems

ResourceRef[]

Lista elementów roboczych skojarzonych z tym zatwierdzeniem.

GitHistoryMode

Wyliczanie

Jakiego trybu historii usługi Git należy użyć. Dotyczy to tylko kryteriów wyszukiwania, gdy określono identyfikatory = null i element itemPath.

Wartość Opis
firstParent

Tryb historii używany przez git log --first-parent
fullHistory

Tryb historii używany przez git log --full-history
fullHistorySimplifyMerges

Tryb historii używany przez git log --full-history --simplify-merges
simplifiedHistory

Tryb historii używany przez git log. Jest to wartość domyślna.

GitPushRef

Objekt
Nazwa Typ Opis
_links

ReferenceLinks

Klasa reprezentująca kolekcję linków referencyjnych REST.
date

string (date-time)

pushId

integer (int32)

pushedBy

IdentityRef

url

string

GitQueryCommitsCriteria

Objekt
Nazwa Typ Opis
$skip

integer (int32)

Liczba wpisów do pominięcia
$top

integer (int32)

Maksymalna liczba wpisów do pobrania
author

string

Alias lub nazwa wyświetlana autora
compareVersion

GitVersionDescriptor

Dotyczy tylko wtedy, gdy określono element ItemVersion. Jeśli zostanie podana, rozpocznij od tego zatwierdzenia historię chodzenia.
excludeDeletes

boolean

Ma zastosowanie tylko wtedy, gdy parametr itemPath jest określony. Określa, czy należy wykluczyć wpisy usuwania określonej ścieżki.
fromCommitId

string

Jeśli zostanie podana, dolna granica dotycząca filtrowania zatwierdzeń alfabetycznie
fromDate

string

Jeśli zostanie podana, uwzględnij tylko wpisy historii utworzone po tej dacie (ciąg)
historyMode

GitHistoryMode

Jakiego trybu historii usługi Git należy użyć. Dotyczy to tylko kryteriów wyszukiwania, gdy określono identyfikatory = null i element itemPath.
ids

string[]

Jeśli zostanie podana, określa dokładne identyfikatory zatwierdzeń do pobrania. Nie można łączyć z innymi parametrami.
includeLinks

boolean

Czy należy uwzględnić pole _links na płytkich odwołaniach
includePushData

boolean

Czy należy uwzględnić informacje wypychane
includeUserImageUrl

boolean

Czy dołączyć adres URL obrazu dla osób zatwierdzających i autorów
includeWorkItems

boolean

Czy dołączać połączone elementy robocze
itemPath

string

Ścieżka elementu do wyszukiwania w obszarze
itemVersion

GitVersionDescriptor

Jeśli zostanie podana, identyfikuje zatwierdzenie lub gałąź do wyszukiwania
showOldestCommitsFirst

boolean

Jeśli ta opcja jest włączona, ta opcja zignoruje parametry itemVersion i compareVersion
toCommitId

string

Jeśli zostanie podana, górna granica dotycząca filtrowania zatwierdzeń alfabetycznie
toDate

string

Jeśli zostanie podana, uwzględnij tylko wpisy historii utworzone przed tą datą (ciąg)
user

string

Alias lub nazwa wyświetlana obiektu zatwierdzającego

GitStatus

Objekt

Ta klasa zawiera metadane usługi/rozszerzenia publikujące stan.

Nazwa Typ Opis
_links

ReferenceLinks

Linki referencyjne.
context

GitStatusContext

Kontekst stanu.
createdBy

IdentityRef

Tożsamość, która utworzyła stan.
creationDate

string (date-time)

Data i godzina utworzenia stanu.
description

string

Opis stanu. Zazwyczaj opisuje bieżący stan stanu.
id

integer (int32)

Identyfikator stanu.
state

GitStatusState

Stan stanu.
targetUrl

string

Adres URL ze szczegółami stanu.
updatedDate

string (date-time)

Data i godzina ostatniej aktualizacji stanu.

GitStatusContext

Objekt

Kontekst stanu, który jednoznacznie identyfikuje stan.

Nazwa Typ Opis
genre

string

Gatunek stanu. Zazwyczaj nazwa usługi/narzędzia generującego stan może być pusta.
name

string

Identyfikator nazwy stanu nie może mieć wartości null ani być pusty.

GitStatusState

Wyliczanie

Stan stanu.

Wartość Opis
error

Stan z błędem.
failed

Stan nie powiódł się.
notApplicable

Stan nie ma zastosowania do obiektu docelowego.
notSet

Stan nie jest ustawiony. Stan domyślny.
pending

Oczekiwanie na stan.
succeeded

Stan zakończył się pomyślnie.

GitTemplate

Objekt
Nazwa Typ Opis
name

string

Nazwa szablonu
type

string

Typ szablonu

GitUserDate

Objekt

Informacje o użytkowniku i data operacji usługi Git.

Nazwa Typ Opis
date

string (date-time)

Data operacji git.
email

string

Adres e-mail użytkownika wykonującego operację Git.
imageUrl

string

Adres URL awatara użytkownika.
name

string

Nazwa użytkownika wykonującego operację Git.

GitVersionDescriptor

Objekt
Nazwa Typ Opis
version

string

Identyfikator ciągu wersji (nazwa tagu/gałęzi, SHA1 zatwierdzenia)
versionOptions

GitVersionOptions

Opcje wersji — określ dodatkowe modyfikatory do wersji (np. Poprzednie)
versionType

GitVersionType

Typ wersji (gałąź, tag lub zatwierdzenie). Określa, jak identyfikator jest interpretowany

GitVersionOptions

Wyliczanie

Opcje wersji — określ dodatkowe modyfikatory do wersji (np. Poprzednie)

Wartość Opis
firstParent

Pierwszy element nadrzędny zatwierdzenia (HEAD^)
none

Nie określono
previousChange

Zatwierdzanie zmienionego elementu przed bieżącą wersją

GitVersionType

Wyliczanie

Typ wersji (gałąź, tag lub zatwierdzenie). Określa, jak identyfikator jest interpretowany

Wartość Opis
branch

Interpretowanie wersji jako nazwy gałęzi
commit

Interpretowanie wersji jako identyfikatora zatwierdzenia (SHA1)
tag

Interpretowanie wersji jako nazwy tagu

IdentityRef

Objekt
Nazwa Typ Opis
_links

ReferenceLinks

To pole zawiera zero lub więcej interesujących linków dotyczących tematu grafu. Te linki mogą być wywoływane w celu uzyskania dodatkowych relacji lub bardziej szczegółowych informacji na temat tego tematu grafu.
descriptor

string

Deskryptor jest podstawowym sposobem odwołowania się do tematu grafu podczas działania systemu. To pole będzie jednoznacznie identyfikować ten sam temat grafu zarówno w ramach kont, jak i organizacji.
directoryAlias

string

Przestarzałe — można go pobrać, wykonując zapytanie względem użytkownika programu Graph, do których odwołuje się wpis "self" słownika IdentityRef "_links"
displayName

string

Jest to unikatowa nazwa wyświetlana podmiotu grafu. Aby zmienić to pole, musisz zmienić jego wartość u dostawcy źródłowego.
id

string

imageUrl

string

Przestarzałe — dostępne we wpisie "avatar" słownika IdentityRef "_links"
inactive

boolean

Przestarzałe — można pobrać, wykonując zapytanie dotyczące stanu członkostwa programu Graph, do których odwołuje się wpis "membershipState" słownika GraphUser "_links"
isAadIdentity

boolean

Przestarzałe — można wywnioskować z typu podmiotu deskryptora (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer

boolean

Przestarzałe — można wywnioskować z typu podmiotu deskryptora (Descriptor.IsGroupType)
isDeletedInOrigin

boolean

profileUrl

string

Przestarzałe — nie jest używane w większości istniejących implementacji elementu ToIdentityRef
uniqueName

string

Przestarzałe — zamiast tego użyj nazwy głównej i domeny
url

string

Ten adres URL jest pełną trasą do zasobu źródłowego tego tematu grafu.

ItemContent

Objekt
Nazwa Typ Opis
content

string

contentType

ItemContentType

ItemContentType

Wyliczanie
Wartość Opis
base64Encoded
rawText
Objekt

Klasa reprezentująca kolekcję linków referencyjnych REST.

Nazwa Typ Opis
links

object

Czytelny widok linków. Ponieważ linki odwołania są tylko do odczytu, chcemy uwidocznić je tylko jako tylko do odczytu.

ResourceRef

Objekt
Nazwa Typ Opis
id

string

url

string

VersionControlChangeType

Wyliczanie

Typ zmiany wprowadzonej w elemencie.

Wartość Opis
add
all
branch
delete
edit
encoding
lock
merge
none
property
rename
rollback
sourceRename
targetRename
undelete