Pull Requests - Get Pull Requests By Project

Référence

Service:: Git

Version d'API:: 7.1

Récupérez toutes les demandes de tirage correspondant à des critères spécifiés.

Notez que le champ de description sera tronqué jusqu’à 400 symboles dans le résultat.

GET https://dev.azure.com/{organization}/{project}/_apis/git/pullrequests?api-version=7.1

Avec des paramètres facultatifs:

GET https://dev.azure.com/{organization}/{project}/_apis/git/pullrequests?searchCriteria.creatorId={searchCriteria.creatorId}&searchCriteria.includeLinks={searchCriteria.includeLinks}&searchCriteria.maxTime={searchCriteria.maxTime}&searchCriteria.minTime={searchCriteria.minTime}&searchCriteria.queryTimeRangeType={searchCriteria.queryTimeRangeType}&searchCriteria.repositoryId={searchCriteria.repositoryId}&searchCriteria.reviewerId={searchCriteria.reviewerId}&searchCriteria.sourceRefName={searchCriteria.sourceRefName}&searchCriteria.sourceRepositoryId={searchCriteria.sourceRepositoryId}&searchCriteria.status={searchCriteria.status}&searchCriteria.targetRefName={searchCriteria.targetRefName}&maxCommentLength={maxCommentLength}&$skip={$skip}&$top={$top}&api-version=7.1

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
project	path	True	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 » pour utiliser cette version de l’API.
$skip	query		integer (int32)	Nombre de demandes de tirage à ignorer. Par exemple, pour récupérer les résultats 101-150, définissez la valeur supérieure à 50 et passez à 100.
$top	query		integer (int32)	Nombre de demandes de tirage à récupérer.
maxCommentLength	query		integer (int32)	Non utilisé.
searchCriteria.creatorId	query		string (uuid)	Si elle est définie, recherchez les demandes de tirage créées par cette identité.
searchCriteria.includeLinks	query		boolean	Indique s’il faut inclure le champ _links sur les références superficielles
searchCriteria.maxTime	query		string (date-time)	Si elle est spécifiée, filtre les demandes de tirage (pull request) créées/fermées avant cette date en fonction du queryTimeRangeType spécifié.
searchCriteria.minTime	query		string (date-time)	Si elle est spécifiée, filtre les demandes de tirage qui ont été créées/fermées après cette date en fonction du queryTimeRangeType spécifié.
searchCriteria.queryTimeRangeType	query		PullRequestTimeRangeType	Type d’intervalle de temps qui doit être utilisé pour minTime et maxTime. La valeur par défaut est Créée si elle n’est pas définie.
searchCriteria.repositoryId	query		string (uuid)	Si elle est définie, recherchez les demandes de tirage dont la branche cible se trouve dans ce référentiel.
searchCriteria.reviewerId	query		string (uuid)	Si elle est définie, recherchez les demandes de tirage qui ont cette identité en tant que réviseur.
searchCriteria.sourceRefName	query		string	Si elle est définie, recherchez les demandes de tirage à partir de cette branche.
searchCriteria.sourceRepositoryId	query		string (uuid)	Si elle est définie, recherchez les demandes de tirage dont la branche source se trouve dans ce référentiel.
searchCriteria.status	query		PullRequestStatus	Si elle est définie, recherchez les demandes de tirage qui se trouvent dans cet état. La valeur par défaut est Active si elle n’est pas définie.
searchCriteria.targetRefName	query		string	Si cette option est définie, recherchez les demandes de tirage dans cette branche.

Réponses

Nom	Type	Description
200 OK	GitPullRequest[]	opération réussie

Sécurité

oauth2

Type: oauth2
Flux: accessCode
URL d’autorisation: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL du jeton: 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

Étendues

Nom	Description
vso.code	Accorde la possibilité de lire le code source et les métadonnées sur les validations, 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 averti des événements de contrôle de version via des hooks de service.

Exemples

Pull requests by project

Exemple de requête

HTTP

GET https://dev.azure.com/fabrikam/2016_10_31/_apis/git/pullrequests?api-version=7.1

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "repository": {
        "id": "3411ebc1-d5aa-464f-9615-0b527bc66719",
        "name": "2016_10_31",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719",
        "project": {
          "id": "a7573007-bbb3-4341-b726-0c4148a07853",
          "name": "2016_10_31",
          "state": "unchanged"
        }
      },
      "pullRequestId": 22,
      "codeReviewId": 22,
      "status": "active",
      "createdBy": {
        "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
        "displayName": "Normal Paulk",
        "uniqueName": "fabrikamfiber16@hotmail.com",
        "url": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
      },
      "creationDate": "2016-11-01T16:30:31.6655471Z",
      "title": "A new feature",
      "description": "Adding a new feature",
      "sourceRefName": "refs/heads/npaulk/my_work",
      "targetRefName": "refs/heads/new_feature",
      "mergeStatus": "succeeded",
      "mergeId": "f5fc8381-3fb2-49fe-8a0d-27dcc2d6ef82",
      "lastMergeSourceCommit": {
        "commitId": "b60280bc6e62e2f880f1b63c1e24987664d3bda3",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/b60280bc6e62e2f880f1b63c1e24987664d3bda3"
      },
      "lastMergeTargetCommit": {
        "commitId": "f47bbc106853afe3c1b07a81754bce5f4b8dbf62",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
      },
      "lastMergeCommit": {
        "commitId": "39f52d24533cc712fc845ed9fd1b6c06b3942588",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/39f52d24533cc712fc845ed9fd1b6c06b3942588"
      },
      "reviewers": [
        {
          "reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22/reviewers/d6245f20-2af8-44f4-9451-8107cb2767db",
          "vote": 0,
          "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
          "displayName": "Normal Paulk",
          "uniqueName": "fabrikamfiber16@hotmail.com",
          "url": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
          "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
        }
      ],
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/22",
      "supportsIterations": true
    },
    {
      "repository": {
        "id": "3411ebc1-d5aa-464f-9615-0b527bc66719",
        "name": "2016_10_31",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719",
        "project": {
          "id": "a7573007-bbb3-4341-b726-0c4148a07853",
          "name": "2016_10_31",
          "state": "unchanged"
        }
      },
      "pullRequestId": 21,
      "codeReviewId": 21,
      "status": "active",
      "createdBy": {
        "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
        "displayName": "Normal Paulk",
        "uniqueName": "fabrikamfiber16@hotmail.com",
        "url": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
      },
      "creationDate": "2016-11-01T16:30:23.8410158Z",
      "title": "Added known issues document",
      "description": "Added known issues document",
      "sourceRefName": "refs/heads/npaulk/known_issues",
      "targetRefName": "refs/heads/new_feature",
      "mergeStatus": "succeeded",
      "mergeId": "58a34c62-01b5-4029-8337-c99782ee9003",
      "lastMergeSourceCommit": {
        "commitId": "05ce817c4692afc93c1eb952643bdf7ffbab18ee",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/05ce817c4692afc93c1eb952643bdf7ffbab18ee"
      },
      "lastMergeTargetCommit": {
        "commitId": "f47bbc106853afe3c1b07a81754bce5f4b8dbf62",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
      },
      "lastMergeCommit": {
        "commitId": "bf27525b51b5347483ed9d7dc52ce5a3cf2b045a",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/bf27525b51b5347483ed9d7dc52ce5a3cf2b045a"
      },
      "reviewers": [
        {
          "reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/21/reviewers/d6245f20-2af8-44f4-9451-8107cb2767db",
          "vote": 0,
          "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
          "displayName": "Normal Paulk",
          "uniqueName": "fabrikamfiber16@hotmail.com",
          "url": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
          "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
        }
      ],
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/21",
      "supportsIterations": true
    },
    {
      "repository": {
        "id": "3411ebc1-d5aa-464f-9615-0b527bc66719",
        "name": "2016_10_31",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719",
        "project": {
          "id": "a7573007-bbb3-4341-b726-0c4148a07853",
          "name": "2016_10_31",
          "state": "unchanged"
        }
      },
      "pullRequestId": 1,
      "codeReviewId": 1,
      "status": "active",
      "createdBy": {
        "id": "d6245f20-2af8-44f4-9451-8107cb2767db",
        "displayName": "Normal Paulk",
        "uniqueName": "fabrikamfiber16@hotmail.com",
        "url": "https://dev.azure.com/fabrikam/_apis/Identities/d6245f20-2af8-44f4-9451-8107cb2767db",
        "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=d6245f20-2af8-44f4-9451-8107cb2767db"
      },
      "creationDate": "2016-10-31T20:20:32.3087249Z",
      "title": "some_branch edit",
      "description": " - Updated README.md",
      "sourceRefName": "refs/heads/some_branch",
      "targetRefName": "refs/heads/master",
      "mergeStatus": "succeeded",
      "mergeId": "b294fd81-d539-461d-b271-71a6e61f3c24",
      "lastMergeSourceCommit": {
        "commitId": "34a9e500f29d119802a828d7a759f6fa2e546750",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/34a9e500f29d119802a828d7a759f6fa2e546750"
      },
      "lastMergeTargetCommit": {
        "commitId": "f47bbc106853afe3c1b07a81754bce5f4b8dbf62",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/f47bbc106853afe3c1b07a81754bce5f4b8dbf62"
      },
      "lastMergeCommit": {
        "commitId": "41e98d9939cf4ec0ce166079c22e2b40de862cf5",
        "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/commits/41e98d9939cf4ec0ce166079c22e2b40de862cf5"
      },
      "reviewers": [
        {
          "reviewerUrl": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/1/reviewers/98d08d98-a075-46e7-a81e-21bc6f12cae7",
          "vote": 0,
          "id": "98d08d98-a075-46e7-a81e-21bc6f12cae7",
          "displayName": "[2016_10_31]\\2016_10_31 Team",
          "uniqueName": "vstfs:///Classification/TeamProject/a7573007-bbb3-4341-b726-0c4148a07853\\2016_10_31 Team",
          "url": "https://dev.azure.com/fabrikam/_apis/Identities/98d08d98-a075-46e7-a81e-21bc6f12cae7",
          "imageUrl": "https://dev.azure.com/fabrikam/_api/_common/identityImage?id=98d08d98-a075-46e7-a81e-21bc6f12cae7",
          "isContainer": true
        }
      ],
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/3411ebc1-d5aa-464f-9615-0b527bc66719/pullRequests/1",
      "supportsIterations": true
    }
  ],
  "count": 3
}

Définitions

Nom	Description
ChangeCountDictionary
GitChange
GitCommitRef	Fournit des propriétés qui décrivent une validation Git et les métadonnées associées.
GitForkRef	Informations sur une référence de fourche.
GitPullRequest	Représente toutes les données associées à une demande de tirage.
GitPullRequestCompletionOptions	Préférences sur la façon dont la demande de tirage doit être terminée.
GitPullRequestMergeOptions	Options utilisées lors de la création d’une fusion de demande de tirage(pull).
GitPullRequestMergeStrategy	Spécifiez la stratégie utilisée pour fusionner la demande de tirage pendant l’achèvement. Si MergeStrategy n’est pas défini sur une valeur, une fusion no-FF est créée si SquashMerge == false. Si MergeStrategy n’est pas défini sur une valeur, les validations de demande de tirage sont écrasées si SquashMerge == true. La propriété SquashMerge est déconseillée. Il est recommandé de définir explicitement MergeStrategy dans tous les cas. Si une valeur explicite est fournie pour MergeStrategy, la propriété SquashMerge est ignorée.
GitPushRef
GitRepository
GitRepositoryRef
GitStatus	Cette classe contient les métadonnées d’un service/extension qui publie un état.
GitStatusContext	Contexte d’état qui identifie de manière unique l’état.
GitStatusState	État de l’état.
GitTemplate
GitUserDate	Informations utilisateur et date des opérations Git.
IdentityRef
IdentityRefWithVote	Informations d’identité, y compris un vote sur une demande de tirage.
ItemContent
ItemContentType
ProjectState	État du projet.
ProjectVisibility	Visibilité du projet.
PullRequestAsyncStatus	État actuel de la fusion de demande de tirage.
PullRequestMergeFailureType	Type d’échec (le cas échéant) de la fusion de demande de tirage.
PullRequestStatus	État de la demande de tirage.
PullRequestTimeRangeType	Type d’intervalle de temps qui doit être utilisé pour minTime et maxTime. La valeur par défaut est Créée si elle n’est pas définie.
ReferenceLinks	Classe à représenter une collection de liens de référence REST.
ResourceRef
TeamProjectCollectionReference	Objet reference pour un TeamProjectCollection.
TeamProjectReference	Représente une référence superficielle à un TeamProject.
VersionControlChangeType	Type de modification apportée à l’élément.
WebApiTagDefinition	Représentation d’une définition d’étiquette qui est envoyée sur le fil.

ChangeCountDictionary

Object

GitChange

Object

Nom	Type	Description
changeId	integer (int32)	ID de la modification dans le groupe de modifications.
changeType	VersionControlChangeType	Type de modification apportée à l’élément.
item	string (T)	Version actuelle.
newContent	ItemContent	Contenu de l’élément après la modification.
newContentTemplate	GitTemplate	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 si 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

Object

Fournit des propriétés qui décrivent une validation Git et les métadonnées associées.

Nom	Type	Description
_links	ReferenceLinks	Collection de liens de référence REST connexes.
author	GitUserDate	Auteur de la validation.
changeCounts	ChangeCountDictionary	Nombre de types de modifications (modifications, suppressions, etc.) inclus dans la validation.
changes	GitChange[]	Énumération des modifications incluses dans la validation.
comment	string	Commentaire ou message de la validation.
commentTruncated	boolean	Indique si le commentaire est tronqué à partir du message de commentaire de validation Git complet.
commitId	string	ID (SHA-1) de la validation.
commitTooManyChanges	boolean	Indique que la validation contient trop de modifications à afficher
committer	GitUserDate	Commiter de la validation.
parents	string[]	Énumération des ID de validation parent pour cette validation.
push	GitPushRef	Push associé à cette validation.
remoteUrl	string	Chemin d’accès d’URL distant à la validation.
statuses	GitStatus[]	Liste des métadonnées d’état des services et extensions qui peuvent associer des informations supplémentaires à la validation.
url	string	URL REST pour cette ressource.
workItems	ResourceRef[]	Liste des éléments de travail associés à cette validation.

GitForkRef

Object

Informations sur une référence de fourche.

Nom	Type	Description
_links	ReferenceLinks	Classe à représenter une collection de liens de référence REST.
creator	IdentityRef
isLocked	boolean
isLockedBy	IdentityRef
name	string
objectId	string
peeledObjectId	string
repository	GitRepository	ID de référentiel du fourche.
statuses	GitStatus[]	Cette classe contient les métadonnées d’un service/extension qui publie un état.
url	string

GitPullRequest

Object

Représente toutes les données associées à une demande de tirage.

Nom	Type	Description
_links	ReferenceLinks	Liens vers d’autres objets connexes.
artifactId	string	Chaîne qui identifie de façon unique cette demande de tirage. Pour générer un ID d’artefact pour une demande de tirage, utilisez ce modèle : `vstfs:///Git/PullRequestId/{projectId}/{repositoryId}/{pullRequestId}`
autoCompleteSetBy	IdentityRef	Si elle est définie, la saisie semi-automatique est activée pour cette demande de tirage (pull request) et il s’agit de l’identité qui l’a activée.
closedBy	IdentityRef	Utilisateur qui a fermé la demande de tirage.
closedDate	string (date-time)	Date à laquelle la demande de tirage a été fermée (terminée, abandonnée ou fusionnée en externe).
codeReviewId	integer (int32)	ID de révision du code de la demande de tirage. Utilisé en interne.
commits	GitCommitRef[]	Validations contenues dans la demande de tirage.
completionOptions	GitPullRequestCompletionOptions	Options qui affectent la façon dont la demande de tirage sera fusionnée une fois terminée.
completionQueueTime	string (date-time)	Date la plus récente à laquelle la demande de tirage a entré la file d’attente à terminer. Utilisé en interne.
createdBy	IdentityRef	Identité de l’utilisateur qui a créé la demande de tirage.
creationDate	string (date-time)	Date à laquelle la demande de tirage a été créée.
description	string	Description de la demande de tirage.
forkSource	GitForkRef	S’il s’agit d’une demande de tirage à partir d’une duplication, cela contiendra des informations sur sa source.
hasMultipleMergeBases	boolean	Avertissement sur plusieurs bases de fusion
isDraft	boolean	Brouillon/ demande de tirage WIP.
labels	WebApiTagDefinition[]	Étiquettes associées à la demande de tirage.
lastMergeCommit	GitCommitRef	Validation de la fusion de demande de tirage la plus récente. Si elle est vide, la fusion la plus récente est en cours ou a échoué.
lastMergeSourceCommit	GitCommitRef	Validation à la tête de la branche source au moment de la dernière fusion de demande de tirage.
lastMergeTargetCommit	GitCommitRef	Validation à la tête de la branche cible au moment de la dernière fusion de demande de tirage.
mergeFailureMessage	string	Si cette valeur est définie, la fusion de demande de tirage a échoué pour cette raison.
mergeFailureType	PullRequestMergeFailureType	Type d’échec (le cas échéant) de la fusion de demande de tirage.
mergeId	string (uuid)	ID du travail utilisé pour exécuter la fusion de demande de tirage. Utilisé en interne.
mergeOptions	GitPullRequestMergeOptions	Options utilisées lorsque la fusion de demande de tirage s’exécute. Ces options sont distinctes des options d’achèvement, car l’achèvement ne se produit qu’une seule fois et une nouvelle fusion s’exécute chaque fois que la branche source de la demande de tirage change.
mergeStatus	PullRequestAsyncStatus	État actuel de la fusion de demande de tirage.
pullRequestId	integer (int32)	ID de la demande de tirage.
remoteUrl	string	Utilisé en interne.
repository	GitRepository	Référentiel contenant la branche cible de la demande de tirage.
reviewers	IdentityRefWithVote[]	Liste des réviseurs sur la demande de tirage ainsi que l’état de leurs votes.
sourceRefName	string	Nom de la branche source de la demande de tirage.
status	PullRequestStatus	État de la demande de tirage.
supportsIterations	boolean	Si la valeur est true, cette demande de tirage prend en charge plusieurs itérations. La prise en charge des itérations signifie que les push individuels vers la branche source de la demande de tirage peuvent être examinés et les commentaires laissés dans une itération seront suivis sur les futures itérations.
targetRefName	string	Nom de la branche cible de la demande de tirage.
title	string	Titre de la demande de tirage.
url	string	Utilisé en interne.
workItemRefs	ResourceRef[]	Toutes les références d’élément de travail associées à cette demande de tirage.

GitPullRequestCompletionOptions

Object

Préférences sur la façon dont la demande de tirage doit être terminée.

Nom	Type	Description
autoCompleteIgnoreConfigIds	integer[] (int32)	Liste des ID de configuration de stratégie dont la saisie semi-automatique ne doit pas attendre. S’applique uniquement aux stratégies facultatives (isBlocking == false). La saisie semi-automatique attend toujours les stratégies requises (isBlocking == true).
bypassPolicy	boolean	Si la valeur est true, les stratégies sont explicitement ignorées pendant la fin de la demande de tirage.
bypassReason	string	Si les stratégies sont contournées, cette raison est stockée quant à la raison pour laquelle la déviation a été utilisée.
deleteSourceBranch	boolean	Si la valeur est true, la branche source de la demande de tirage est supprimée après l’achèvement.
mergeCommitMessage	string	Si cette valeur est définie, elle sera utilisée comme message de validation de la validation de fusion.
mergeStrategy	GitPullRequestMergeStrategy	Spécifiez la stratégie utilisée pour fusionner la demande de tirage pendant l’achèvement. Si MergeStrategy n’est pas défini sur une valeur, une fusion no-FF est créée si SquashMerge == false. Si MergeStrategy n’est pas défini sur une valeur, les validations de demande de tirage sont écrasées si SquashMerge == true. La propriété SquashMerge est déconseillée. Il est recommandé de définir explicitement MergeStrategy dans tous les cas. Si une valeur explicite est fournie pour MergeStrategy, la propriété SquashMerge est ignorée.
squashMerge	boolean	SquashMerge est déconseillé. Vous devez définir explicitement la valeur de MergeStrategy. Si MergeStrategy est défini sur n’importe quelle valeur, la valeur SquashMerge est ignorée. Si MergeStrategy n’est pas défini, la stratégie de fusion n’est pas rapide si cet indicateur a la valeur false, ou courge si la valeur est true.
transitionWorkItems	boolean	Si la valeur est true, nous tenterons de transférer tous les éléments de travail liés à la demande de tirage dans l’état logique suivant (par exemple, Actif -> Résolu)
triggeredByAutoComplete	boolean	Si la valeur est true, la tentative d’achèvement actuelle a été déclenchée via la saisie semi-automatique. Utilisé en interne.

GitPullRequestMergeOptions

Object

Options utilisées lors de la création d’une fusion de demande de tirage(pull).

Nom	Type	Description
conflictAuthorshipCommits	boolean	Si la valeur est true, les résolutions de conflit appliquées pendant la fusion sont placées dans des validations distinctes pour préserver les informations de création pour la responsabilité git, etc.
detectRenameFalsePositives	boolean
disableRenames	boolean	Si la valeur est true, la détection de renommage n’est pas effectuée pendant la fusion.

GitPullRequestMergeStrategy

Énumération

Spécifiez la stratégie utilisée pour fusionner la demande de tirage pendant l’achèvement. Si MergeStrategy n’est pas défini sur une valeur, une fusion no-FF est créée si SquashMerge == false. Si MergeStrategy n’est pas défini sur une valeur, les validations de demande de tirage sont écrasées si SquashMerge == true. La propriété SquashMerge est déconseillée. Il est recommandé de définir explicitement MergeStrategy dans tous les cas. Si une valeur explicite est fournie pour MergeStrategy, la propriété SquashMerge est ignorée.

Valeur	Description
noFastForward	Fusion à deux parents, sans avance rapide. La branche source n’est pas modifiée. Il s’agit du comportement par défaut.
rebase	Rebasez la branche source au-dessus de la validation HEAD de la branche cible et transférez rapidement la branche cible. La branche source est mise à jour pendant l’opération de rebase.
rebaseMerge	Rebasez la branche source au-dessus de la validation HEAD de la branche cible et créez une fusion bi-parente sans transfert rapide. La branche source est mise à jour pendant l’opération de rebase.
squash	Placez toutes les modifications de la demande de tirage dans une validation monoparentale.

GitPushRef

Object

Nom	Type	Description
_links	ReferenceLinks	Classe à représenter une collection de liens de référence REST.
date	string (date-time)
pushId	integer (int32)
pushedBy	IdentityRef
url	string

GitRepository

Object

Nom	Type	Description
_links	ReferenceLinks	Classe à représenter une collection de liens de référence REST.
defaultBranch	string
id	string (uuid)
isDisabled	boolean	True si le référentiel est désactivé. False sinon.
isFork	boolean	True si le référentiel a été créé en tant que fourche.
isInMaintenance	boolean	True si le référentiel est en maintenance. False sinon.
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Représente une référence superficielle à un TeamProject.
remoteUrl	string
size	integer (int64)	Taille compressée (octets) du référentiel.
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryRef

Object

Nom	Type	Description
collection	TeamProjectCollectionReference	Collection de projets d’équipe où réside ce fork
id	string (uuid)
isFork	boolean	True si le référentiel a été créé en tant que fork
name	string
project	TeamProjectReference	Représente une référence superficielle à un TeamProject.
remoteUrl	string
sshUrl	string
url	string

GitStatus

Object

Cette classe contient les métadonnées d’un service/extension qui publie un état.

Nom	Type	Description
_links	ReferenceLinks	Liens de référence.
context	GitStatusContext	Contexte de l’état.
createdBy	IdentityRef	Identité qui a créé l’état.
creationDate	string (date-time)	Date et heure de création de l’état.
description	string	Description de l’état. Décrit généralement l’état actuel de l’état.
id	integer (int32)	Identificateur d’état.
state	GitStatusState	État de l’état.
targetUrl	string	URL avec les détails de l’état.
updatedDate	string (date-time)	Date et heure de la dernière mise à jour de l’état.

GitStatusContext

Object

Contexte d’état qui identifie de manière unique l’état.

Nom	Type	Description
genre	string	Genre du statut. En règle générale, le nom du service/outil qui génère l’état peut être vide.
name	string	L’identificateur de nom de l’état ne peut pas être null ou vide.

GitStatusState

Énumération

État de l’état.

Valeur	Description
error	État avec une erreur.
failed	Échec de l’état.
notApplicable	L’état n’est pas applicable à l’objet cible.
notSet	État non défini. État par défaut.
pending	État en attente.
succeeded	État réussi.

GitTemplate

Object

Nom	Type	Description
name	string	Nom du modèle
type	string	Type du modèle

GitUserDate

Object

Informations utilisateur et date des opérations Git.

Nom	Type	Description
date	string (date-time)	Date de l’opération Git.
email	string	Adresse e-mail 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.

IdentityRef

Object

Nom	Type	Description
_links	ReferenceLinks	Ce champ contient zéro ou plus de liens intéressants sur le sujet du graphe. 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 sur 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 « auto » du dictionnaire IdentityRef « _links »
displayName	string	Il s’agit du nom complet 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éconseillé - 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éconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Déconseillé : 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é : utiliser Domain+PrincipalName à la place
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphe.

IdentityRefWithVote

Object

Informations d’identité, y compris un vote sur une demande de tirage.

Nom	Type	Description
_links	ReferenceLinks	Ce champ contient zéro ou plus de liens intéressants sur le sujet du graphe. 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 sur 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 « auto » du dictionnaire IdentityRef « _links »
displayName	string	Il s’agit du nom complet non unique de l’objet du graphique. Pour modifier ce champ, vous devez modifier sa valeur dans le fournisseur source.
hasDeclined	boolean	Indique si ce réviseur a refusé de passer en revue cette demande de tirage.
id	string
imageUrl	string	Déconseillé - 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éconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsAadUserType/Descriptor.IsAadGroupType)
isContainer	boolean	Déconseillé : peut être déduit du type d’objet du descripteur (Descriptor.IsGroupType)
isDeletedInOrigin	boolean
isFlagged	boolean	Indique si ce réviseur est marqué pour attention sur cette demande de tirage.
isReapprove	boolean	Indique si ce vote d’approbation doit toujours être traité même si le vote n’a pas changé.
isRequired	boolean	Indique s’il s’agit d’un réviseur requis pour cette demande de tirage. Les branches peuvent avoir des stratégies qui nécessitent des réviseurs particuliers sont requises pour les demandes de tirage.
profileUrl	string	Déconseillé : non utilisé dans la plupart des implémentations préexistantes de ToIdentityRef
reviewerUrl	string	URL permettant de récupérer des informations sur cette identité
uniqueName	string	Déconseillé : utiliser Domain+PrincipalName à la place
url	string	Cette URL est l’itinéraire complet vers la ressource source de ce sujet de graphe.
vote	integer (int16)	Votez sur une demande de tirage : 10 - approuvé 5 - approuvé avec des suggestions 0 - aucun vote -5 - en attente de l’auteur -10 - rejeté
votedFor	IdentityRefWithVote[]	Groupes ou équipes auxquels ce réviseur a contribué. Les groupes et les équipes peuvent être réviseurs sur les demandes de tirage, mais ne peuvent pas voter directement. Lorsqu’un membre du groupe ou de l’équipe vote, ce vote est inscrit au vote du groupe ou de l’équipe. VotedFor est une liste de ces votes.

ItemContent

Object

Nom	Type	Description
content	string
contentType	ItemContentType

ItemContentType

Énumération

Valeur	Description
base64Encoded
rawText

ProjectState

Énumération

État du projet.

Valeur	Description
all	Tous les projets, quel que soit l’état, sauf supprimé.
createPending	Project a été mis en file d’attente pour la création, mais le processus n’a pas encore démarré.
deleted	Le projet a été supprimé.
deleting	Le projet est en cours de suppression.
new	Le projet est en cours de création.
unchanged	Le projet n’a pas été modifié.
wellFormed	Le projet est entièrement créé et prêt à être utilisé.

ProjectVisibility

Énumération

Visibilité du projet.

Valeur	Description
private	Le projet n’est visible que par les utilisateurs disposant d’un accès explicite.
public	Le projet est visible pour tous.

PullRequestAsyncStatus

Énumération

État actuel de la fusion de demande de tirage.

Valeur	Description
conflicts	Échec de la fusion des demandes de tirage en raison de conflits.
failure	Échec de la fusion des demandes de tirage.
notSet	L’état n’est pas défini. État par défaut.
queued	La fusion des demandes de tirage (pull request) est mise en file d’attente.
rejectedByPolicy	Fusion de demande de tirage rejetée par la stratégie.
succeeded	La fusion de demande de tirage a réussi.

PullRequestMergeFailureType

Énumération

Type d’échec (le cas échéant) de la fusion de demande de tirage.

Valeur	Description
caseSensitive	Échec de la fusion des demandes de tirage en raison d’une incompatibilité de cas.
none	Le type n’est pas défini. Type par défaut.
objectTooLarge	Échec de la fusion des demandes de tirage en raison d’un objet trop volumineux.
unknown	Type d’échec de fusion de demande de tirage inconnu.

PullRequestStatus

Énumération

État de la demande de tirage.

Valeur	Description
abandoned	La demande de tirage est abandonnée.
active	La demande de tirage est active.
all	Utilisé dans les critères de recherche de demande de tirage (pull request) pour inclure tous les états.
completed	La demande de tirage est terminée.
notSet	État non défini. État par défaut.

PullRequestTimeRangeType

Énumération

Type d’intervalle de temps qui doit être utilisé pour minTime et maxTime. La valeur par défaut est Créée si elle n’est pas définie.

Valeur	Description
closed	Date à laquelle la demande de tirage a été fermée (terminée, abandonnée ou fusionnée en externe).
created	Date à laquelle la demande de tirage a été créée.

ReferenceLinks

Object

Classe à 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 de référence sont en lecture seule, nous voulons uniquement les exposer en lecture seule.

ResourceRef

Object

Nom	Type	Description
id	string
url	string

TeamProjectCollectionReference

Object

Objet reference pour un TeamProjectCollection.

Nom	Type	Description
avatarUrl	string	URL de l’avatar de collection.
id	string (uuid)	ID de collection.
name	string	Nom de la collection.
url	string	URL REST de collection.

TeamProjectReference

Object

Représente une référence superficielle à un TeamProject.

Nom	Type	Description
abbreviation	string	Abréviation du projet.
defaultTeamImageUrl	string	URL de l’image d’identité d’équipe par défaut.
description	string	Description du projet (le cas échéant).
id	string (uuid)	Identificateur du projet.
lastUpdateTime	string (date-time)	Heure de la dernière mise à jour du projet.
name	string	Nom du projet.
revision	integer (int64)	Révision du projet.
state	ProjectState	État du projet.
url	string	URL vers la version complète de l’objet.
visibility	ProjectVisibility	Visibilité du projet.

VersionControlChangeType

Énumération

Type de modification apportée à l’élément.

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

WebApiTagDefinition

Object

Représentation d’une définition d’étiquette qui est envoyée sur le fil.

Nom	Type	Description
active	boolean	Indique si la définition de balise est active ou non.
id	string (uuid)	ID de la définition de balise.
name	string	Nom de la définition de balise.
url	string	URL de ressource pour la définition de balise.

Partager via

Pull Requests - Get Pull Requests By Project

Paramètres URI

Réponses

Sécurité

oauth2

Étendues

Exemples

Pull requests by project

Exemple de requête

Exemple de réponse

Définitions

ChangeCountDictionary

GitChange

GitCommitRef

GitForkRef

GitPullRequest

GitPullRequestCompletionOptions

GitPullRequestMergeOptions

GitPullRequestMergeStrategy

GitPushRef

GitRepository

GitRepositoryRef

GitStatus

GitStatusContext

GitStatusState

GitTemplate

GitUserDate

IdentityRef

IdentityRefWithVote

ItemContent

ItemContentType

ProjectState

ProjectVisibility

PullRequestAsyncStatus

PullRequestMergeFailureType

PullRequestStatus

PullRequestTimeRangeType

ReferenceLinks

ResourceRef

TeamProjectCollectionReference

TeamProjectReference

VersionControlChangeType

WebApiTagDefinition

Ressources supplémentaires