Commits - Get Commits Batch
Récupérer des commits Git pour un projet correspondant aux critères de recherche
POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commitsbatch?api-version=7.1-preview.1POST https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}/commitsbatch?$skip={$skip}&$top={$top}&includeStatuses={includeStatuses}&api-version=7.1-preview.1Paramètres URI
| Nom | Dans | Obligatoire | Type | Description |
|---|---|---|---|---|
|
organization
|
path | True |
string |
Nom de l’organisation Azure DevOps. |
|
repository
|
path | True |
string |
Nom ou ID du dépôt. |
|
project
|
path |
string |
ID de projet ou nom du projet |
|
|
api-version
|
query | True |
string |
Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.1 » pour utiliser cette version de l’API. |
|
$skip
|
query |
integer int32 |
Nombre de validations à ignorer. La valeur ne peut pas dépasser 3 000 000. |
|
|
$top
|
query |
integer int32 |
Nombre maximal de validations à retourner. La valeur ne peut pas dépasser 50 000. |
|
|
include
|
query |
boolean |
True pour inclure des informations de validation supplémentaires status. |
Corps de la demande
| Nom | Type | Description |
|---|---|---|
| $skip |
integer |
Nombre d’entrées à ignorer |
| $top |
integer |
Nombre maximal d’entrées à récupérer |
| author |
string |
Alias ou nom d’affichage de l’auteur |
| compareVersion |
Applicable uniquement lorsque ItemVersion spécifié. Si cette option est fournie, commencez à parcourir l’historique à partir de cette validation. |
|
| excludeDeletes |
boolean |
S’applique uniquement lorsqu’un itemPath est spécifié. Cela détermine s’il faut exclure les entrées de suppression du chemin d’accès spécifié. |
| fromCommitId |
string |
Si elle est fournie, une limite inférieure pour le filtrage des validations par ordre alphabétique |
| fromDate |
string |
S’il est fourni, incluez uniquement les entrées d’historique créées après cette date (chaîne) |
| historyMode |
Quel mode d’historique Git doit être utilisé. Cela s’applique uniquement aux critères de recherche lorsque Ids = null et qu’un itemPath est spécifié. |
|
| ids |
string[] |
S’il est fourni, spécifie les ID de validation exacts des validations à extraire. Ne peut pas être combiné avec d’autres paramètres. |
| includeLinks |
boolean |
Indique s’il faut inclure le champ _links sur les références superficielles |
| includePushData |
boolean |
Indique s’il faut inclure les informations push |
| includeUserImageUrl |
boolean |
Indique s’il faut inclure l’URL de l’image pour les commiteurs et les auteurs |
| includeWorkItems |
boolean |
Indique s’il faut inclure des éléments de travail liés |
| itemPath |
string |
Chemin d’accès de l’élément à rechercher sous |
| itemVersion |
S’il est fourni, identifie la validation ou la branche à rechercher |
|
| showOldestCommitsFirst |
boolean |
Si elle est activée, cette option ignore les paramètres itemVersion et compareVersion |
| toCommitId |
string |
Si elle est fournie, une limite supérieure pour le filtrage des validations par ordre alphabétique |
| toDate |
string |
S’il est fourni, incluez uniquement les entrées d’historique créées avant cette date (chaîne) |
| user |
string |
Alias ou nom d’affichage du commiteur |
Réponses
| Nom | Type | Description |
|---|---|---|
| 200 OK |
opération réussie |
Sécurité
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
| Nom | Description |
|---|---|
| vso.code | Accorde la possibilité de lire le code source et les métadonnées sur les commits, les ensembles de modifications, les branches et d’autres artefacts de contrôle de version. Accorde également la possibilité de rechercher du code et d’être informé des événements de contrôle de version via des hooks de service. |
Exemples
| Commits between two versions |
| Commits by a list of commit IDs |
Commits between two versions
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commitsbatch?api-version=7.1-preview.1
{
"itemVersion": {
"versionType": "branch",
"version": "develop"
},
"compareVersion": {
"versionType": "branch",
"version": "master"
}
}
Sample Response
{
"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
Sample Request
POST https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249/commitsbatch?api-version=7.1-preview.1
{
"ids": [
"23d0bc5b128a10056dc68afece360d8a0fabb014",
"fe17a84cc2dfe0ea3a2202ab4dbac0706058e41f"
]
}
Sample Response
{
"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"
}
]
}Définitions
| Nom | Description |
|---|---|
|
Change |
|
|
Git |
|
|
Git |
Fournit des propriétés qui décrivent un commit Git et les métadonnées associées. |
|
Git |
Quel mode d’historique Git doit être utilisé. Cela s’applique uniquement aux critères de recherche lorsque Ids = null et qu’un itemPath est spécifié. |
|
Git |
|
|
Git |
|
|
Git |
Cette classe contient les métadonnées d’un service/extension qui publie un status. |
|
Git |
Contexte d’état qui identifie de manière unique le status. |
|
Git |
État du status. |
|
Git |
|
|
Git |
Informations utilisateur et date pour les opérations Git. |
|
Git |
|
|
Git |
Options de version : spécifiez des modificateurs supplémentaires à la version (par exemple, Précédent) |
|
Git |
Type de version (branche, balise ou commit). Détermine comment l’ID est interprété |
|
Identity |
|
|
Item |
|
|
Item |
|
|
Reference |
Classe pour représenter une collection de liens de référence REST. |
|
Resource |
|
|
Version |
Type de modification apportée à l’élément. |
ChangeCountDictionary
GitChange
| Nom | Type | Description |
|---|---|---|
| changeId |
integer |
ID de la modification dans le groupe de modifications. |
| changeType |
Type de modification apportée à l’élément. |
|
| item |
string |
Version actuelle. |
| newContent |
Contenu de l’élément après la modification. |
|
| newContentTemplate |
Nouveau modèle de contenu à utiliser lors de l’envoi de nouvelles modifications. |
|
| originalPath |
string |
Chemin d’accès d’origine de l’élément s’il est différent du chemin actuel. |
| sourceServerItem |
string |
Chemin d’accès de l’élément sur le serveur. |
| url |
string |
URL pour récupérer l’élément. |
GitCommitRef
Fournit des propriétés qui décrivent un commit Git et les métadonnées associées.
| Nom | Type | Description |
|---|---|---|
| _links |
Collection de liens de référence REST associés. |
|
| author |
Auteur de la validation. |
|
| changeCounts |
Nombre de types de modifications (modifications, suppressions, etc.) inclus dans la validation. |
|
| changes |
Énumération des modifications incluses dans le commit. |
|
| comment |
string |
Commentaire ou message du commit. |
| commentTruncated |
boolean |
Indique si le commentaire est tronqué à partir du message de commentaire de validation Git complet. |
| commitId |
string |
ID (SHA-1) du commit. |
| commitTooManyChanges |
boolean |
Indique que la validation contient trop de modifications pour être affichées |
| committer |
Commiter du commit. |
|
| parents |
string[] |
Énumération des ID de validation parent pour cette validation. |
| push |
Envoi (push) associé à ce commit. |
|
| remoteUrl |
string |
Chemin d’URL distante du commit. |
| statuses |
Liste des métadonnées status des services et des extensions qui peuvent associer des informations supplémentaires à la validation. |
|
| url |
string |
URL REST pour cette ressource. |
| workItems |
Liste des éléments de travail associés à cette validation. |
GitHistoryMode
Quel mode d’historique Git doit être utilisé. Cela s’applique uniquement aux critères de recherche lorsque Ids = null et qu’un itemPath est spécifié.
| Nom | Type | Description |
|---|---|---|
| firstParent |
string |
Mode d’historique utilisé par |
| fullHistory |
string |
Mode d’historique utilisé par |
| fullHistorySimplifyMerges |
string |
Mode d’historique utilisé par |
| simplifiedHistory |
string |
Mode d’historique utilisé par |
GitPushRef
| Nom | Type | Description |
|---|---|---|
| _links |
Classe pour représenter une collection de liens de référence REST. |
|
| date |
string |
|
| pushId |
integer |
|
| pushedBy | ||
| url |
string |
GitQueryCommitsCriteria
| Nom | Type | Description |
|---|---|---|
| $skip |
integer |
Nombre d’entrées à ignorer |
| $top |
integer |
Nombre maximal d’entrées à récupérer |
| author |
string |
Alias ou nom d’affichage de l’auteur |
| compareVersion |
Applicable uniquement lorsque ItemVersion spécifié. Si cette option est fournie, commencez à parcourir l’historique à partir de cette validation. |
|
| excludeDeletes |
boolean |
S’applique uniquement lorsqu’un itemPath est spécifié. Cela détermine s’il faut exclure les entrées de suppression du chemin d’accès spécifié. |
| fromCommitId |
string |
Si elle est fournie, une limite inférieure pour le filtrage des validations par ordre alphabétique |
| fromDate |
string |
S’il est fourni, incluez uniquement les entrées d’historique créées après cette date (chaîne) |
| historyMode |
Quel mode d’historique Git doit être utilisé. Cela s’applique uniquement aux critères de recherche lorsque Ids = null et qu’un itemPath est spécifié. |
|
| ids |
string[] |
S’il est fourni, spécifie les ID de validation exacts des validations à extraire. Ne peut pas être combiné avec d’autres paramètres. |
| includeLinks |
boolean |
Indique s’il faut inclure le champ _links sur les références superficielles |
| includePushData |
boolean |
Indique s’il faut inclure les informations push |
| includeUserImageUrl |
boolean |
Indique s’il faut inclure l’URL de l’image pour les commiteurs et les auteurs |
| includeWorkItems |
boolean |
Indique s’il faut inclure des éléments de travail liés |
| itemPath |
string |
Chemin d’accès de l’élément à rechercher sous |
| itemVersion |
S’il est fourni, identifie la validation ou la branche à rechercher |
|
| showOldestCommitsFirst |
boolean |
Si elle est activée, cette option ignore les paramètres itemVersion et compareVersion |
| toCommitId |
string |
Si elle est fournie, une limite supérieure pour le filtrage des validations par ordre alphabétique |
| toDate |
string |
S’il est fourni, incluez uniquement les entrées d’historique créées avant cette date (chaîne) |
| user |
string |
Alias ou nom d’affichage du commiteur |
GitStatus
Cette classe contient les métadonnées d’un service/extension qui publie un status.
| Nom | Type | Description |
|---|---|---|
| _links |
Liens de référence. |
|
| context |
Contexte du status. |
|
| createdBy |
Identité qui a créé le status. |
|
| creationDate |
string |
Date et heure de création du status. |
| description |
string |
Description de l’état. Décrit généralement l’état actuel du status. |
| id |
integer |
Identificateur d’état. |
| state |
État du status. |
|
| targetUrl |
string |
URL avec status détails. |
| updatedDate |
string |
Date et heure de la dernière mise à jour du status. |
GitStatusContext
Contexte d’état qui identifie de manière unique le status.
| Nom | Type | Description |
|---|---|---|
| genre |
string |
Genre du status. En règle générale, le nom du service/de l’outil qui génère le status peut être vide. |
| name |
string |
Identificateur de nom du status, ne peut pas être null ou vide. |
GitStatusState
État du status.
| Nom | Type | Description |
|---|---|---|
| error |
string |
État avec une erreur. |
| failed |
string |
Échec de l’état. |
| notApplicable |
string |
L’état n’est pas applicable à l’objet cible. |
| notSet |
string |
État non défini. État par défaut. |
| pending |
string |
État en attente. |
| succeeded |
string |
État réussi. |
GitTemplate
| Nom | Type | Description |
|---|---|---|
| name |
string |
Nom du modèle |
| type |
string |
Type du modèle |
GitUserDate
Informations utilisateur et date pour les opérations Git.
| Nom | Type | Description |
|---|---|---|
| date |
string |
Date de l’opération Git. |
|
string |
Email adresse de l’utilisateur effectuant l’opération Git. |
|
| imageUrl |
string |
URL de l’avatar de l’utilisateur. |
| name |
string |
Nom de l’utilisateur effectuant l’opération Git. |
GitVersionDescriptor
| Nom | Type | Description |
|---|---|---|
| version |
string |
Identificateur de chaîne de version (nom de la balise/branche, SHA1 de la validation) |
| versionOptions |
Options de version : spécifiez des modificateurs supplémentaires à la version (par exemple, Précédent) |
|
| versionType |
Type de version (branche, balise ou commit). Détermine comment l’ID est interprété |
GitVersionOptions
Options de version : spécifiez des modificateurs supplémentaires à la version (par exemple, Précédent)
| Nom | Type | Description |
|---|---|---|
| firstParent |
string |
Premier parent de commit (HEAD^) |
| none |
string |
Non spécifié |
| previousChange |
string |
Valider l’élément modifié avant la version actuelle |
GitVersionType
Type de version (branche, balise ou commit). Détermine comment l’ID est interprété
| Nom | Type | Description |
|---|---|---|
| branch |
string |
Interpréter la version en tant que nom de branche |
| commit |
string |
Interpréter la version en tant qu’ID de validation (SHA1) |
| tag |
string |
Interpréter la version comme un nom de balise |
IdentityRef
| Nom | Type | Description |
|---|---|---|
| _links |
Ce champ contient zéro ou plus de liens intéressants sur l’objet du graphique. Ces liens peuvent être appelés pour obtenir des relations supplémentaires ou des informations plus détaillées sur ce sujet de graphique. |
|
| descriptor |
string |
Le descripteur est le principal moyen de référencer l’objet du graphique pendant l’exécution du système. Ce champ identifie de manière unique le même sujet de graphique dans les comptes et les organisations. |
| directoryAlias |
string |
Déconseillé : peut être récupéré en interrogeant l’utilisateur Graph référencé dans l’entrée « self » du dictionnaire IdentityRef « _links » |
| displayName |
string |
Il s’agit du nom d’affichage non unique de l’objet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source. |
| id |
string |
|
| imageUrl |
string |
Déprécié : disponible dans l’entrée « avatar » du dictionnaire IdentityRef « _links » |
| inactive |
boolean |
Déconseillé : peut être récupéré en interrogeant l’état d’appartenance Graph référencé dans l’entrée « membershipState » du dictionnaire GraphUser « _links » |
| isAadIdentity |
boolean |
Déprécié : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType) |
| isContainer |
boolean |
Déprécié : peut être déduit du type d’objet du descripteur (Descriptor.IsGroupType) |
| isDeletedInOrigin |
boolean |
|
| profileUrl |
string |
Déconseillé : non utilisé dans la plupart des implémentations préexistantes de ToIdentityRef |
| uniqueName |
string |
Déconseillé : utilisez à la place Domain+PrincipalName |
| url |
string |
Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphique. |
ItemContent
| Nom | Type | Description |
|---|---|---|
| content |
string |
|
| contentType |
ItemContentType
| Nom | Type | Description |
|---|---|---|
| base64Encoded |
string |
|
| rawText |
string |
ReferenceLinks
Classe pour représenter une collection de liens de référence REST.
| Nom | Type | Description |
|---|---|---|
| links |
object |
Vue en lecture seule des liens. Étant donné que les liens référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule. |
ResourceRef
| Nom | Type | Description |
|---|---|---|
| id |
string |
|
| url |
string |
VersionControlChangeType
Type de modification apportée à l’élément.
| Nom | Type | 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 |
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour