Repositories - List

Référence

Service:: Git

API Version:: 7.1-preview.1

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

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

With optional parameters:

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

HTTP

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

Sample Response

Status code:: 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 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.

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.

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.

Share via