Partager via


Repositories - List

Récupérez les référentiels Git.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1-preview.1
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?includeLinks={includeLinks}&includeAllUrls={includeAllUrls}&includeHidden={includeHidden}&api-version=7.1-preview.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-preview.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 dépôts 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
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 averti des événements de contrôle de version via des hooks de service.

Exemples

Sample Request

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

Sample Response

{
  "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 pour représenter une collection de liens de référence REST.

TeamProjectCollectionReference

Objet de référence pour un TeamProjectCollection.

TeamProjectReference

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

GitRepository

Nom Type Description
_links

ReferenceLinks

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

defaultBranch

string

id

string

isDisabled

boolean

True si le dépôt est désactivé. Sinon, false.

isFork

boolean

True si le dépôt a été créé en tant que duplication.

isInMaintenance

boolean

True si le dépôt est en maintenance. Sinon, false.

name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

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

remoteUrl

string

size

integer

Taille compressée (octets) du dépôt.

sshUrl

string

url

string

validRemoteUrls

string[]

webUrl

string

GitRepositoryRef

Nom Type Description
collection

TeamProjectCollectionReference

Collection de projets d’équipe où réside cette duplication

id

string

isFork

boolean

True si le dépôt a été créé en tant que duplication

name

string

project

TeamProjectReference

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

remoteUrl

string

sshUrl

string

url

string

ProjectState

État du projet.

Nom Type Description
all

string

Tous les projets, quel que soit leur état, sauf Supprimé.

createPending

string

Project a été mis en file d’attente pour la création, mais le processus n’a pas encore démarré.

deleted

string

Le projet a été supprimé.

deleting

string

Project est en cours de suppression.

new

string

Project est en cours de création.

unchanged

string

Le projet n’a pas été modifié.

wellFormed

string

Le projet est entièrement créé et prêt à être utilisé.

ProjectVisibility

Visibilité du projet.

Nom Type Description
private

string

Le projet n’est visible que par les utilisateurs disposant d’un accès explicite.

public

string

Le projet est visible par tous.

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.

TeamProjectCollectionReference

Objet de référence pour un TeamProjectCollection.

Nom Type Description
avatarUrl

string

URL de l’avatar de la collection.

id

string

ID de collection.

name

string

Nom de la collection.

url

string

URL REST de la collection.

TeamProjectReference

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

Nom Type Description
abbreviation

string

Abréviation de 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

Identificateur de projet.

lastUpdateTime

string

Heure de la dernière mise à jour du projet.

name

string

Nom du projet.

revision

integer

Révision du projet.

state

ProjectState

État du projet.

url

string

Url de la version complète de l’objet.

visibility

ProjectVisibility

Visibilité du projet.