Partager via

Repositories - List

  • Référence
Service:
Git
Version d'API:
7.1

Récupérer des référentiels Git.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1
Avec des paramètres facultatifs: 
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?includeLinks={includeLinks}&includeAllUrls={includeAllUrls}&includeHidden={includeHidden}&api-version=7.1

Paramètres URI

Nom Dans Obligatoire Type Description
organization
 path True

string

Nom de l’organisation Azure DevOps.
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 » pour utiliser cette version de l’API.
includeAllUrls
 query

boolean

[facultatif] True pour inclure toutes les URL distantes. La valeur par défaut est false.
includeHidden
 query

boolean

[facultatif] True pour inclure les référentiels masqués. La valeur par défaut est false.
includeLinks
 query

boolean

[facultatif] True pour inclure des liens de référence. La valeur par défaut est false.

Réponses

Nom Type Description
200 OK

GitRepository[]

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

Exemple de requête

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

Exemple de réponse

Code d’état:
200 
{
  "count": 3,
  "value": [
    {
      "id": "5febef5a-833d-4e14-b9c0-14cb638f91e6",
      "name": "AnotherRepository",
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6",
      "project": {
        "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "name": "Fabrikam-Fiber-Git",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "state": "wellFormed"
      },
      "remoteUrl": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_git/AnotherRepository"
    },
    {
      "id": "278d5cd2-584d-4b63-824a-2ba458937249",
      "name": "Fabrikam-Fiber-Git",
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/278d5cd2-584d-4b63-824a-2ba458937249",
      "project": {
        "id": "6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "name": "Fabrikam-Fiber-Git",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c",
        "state": "wellFormed"
      },
      "defaultBranch": "refs/heads/master",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/Fabrikam-Fiber-Git"
    },
    {
      "id": "66efb083-777a-4cac-a350-a24b046be6be",
      "name": "TestGit",
      "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/66efb083-777a-4cac-a350-a24b046be6be",
      "project": {
        "id": "281f9a5b-af0d-49b4-a1df-fe6f5e5f84d0",
        "name": "TestGit",
        "url": "https://dev.azure.com/fabrikam/_apis/projects/281f9a5b-af0d-49b4-a1df-fe6f5e5f84d0",
        "state": "wellFormed"
      },
      "defaultBranch": "refs/heads/master",
      "remoteUrl": "https://dev.azure.com/fabrikam/_git/TestGit"
    }
  ]
}

Définitions

Nom Description
GitRepository
GitRepositoryRef
ProjectState

État du projet.
ProjectVisibility

Visibilité du projet.
ReferenceLinks

Classe à représenter une collection de liens de référence REST.
TeamProjectCollectionReference

Objet reference pour un TeamProjectCollection.
TeamProjectReference

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

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

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.
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.

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.