Repositories - List

Referenz

Service:: Git

API Version:: 7.1-preview.1

Abrufen von Git-Repositorys.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
project	path		string	Projekt-ID oder Projektname
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.1-preview.1" festgelegt werden, um diese Version der API zu verwenden.
includeAllUrls	query		boolean	[optional] True, um alle Remote-URLs einzuschließen. Der Standardwert ist „FALSE“.
includeHidden	query		boolean	[optional] True, um ausgeblendete Repositorys einzuschließen. Der Standardwert ist „FALSE“.
includeLinks	query		boolean	[optional] True, um Verweislinks einzuschließen. Der Standardwert ist „FALSE“.

Antworten

Name	Typ	Beschreibung
200 OK	GitRepository[]	Erfolgreicher Vorgang

Sicherheit

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

Name	Beschreibung
vso.code	Ermöglicht das Lesen von Quellcode und Metadaten zu Commits, Changesets, Branches und anderen Versionskontrollartefakten. Ermöglicht außerdem die Suche nach Code und die Benachrichtigung über Versionskontrollereignisse über Diensthaken.

Beispiele

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"
    }
  ]
}

Definitionen

Name	Beschreibung
GitRepository
GitRepositoryRef
ProjectState	Projektstatus.
ProjectVisibility	Projektsichtbarkeit.
ReferenceLinks	Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
TeamProjectCollectionReference	Referenzobjekt für eine TeamProjectCollection.
TeamProjectReference	Stellt einen flachen Verweis auf ein TeamProject dar.

GitRepository

Name	Typ	Beschreibung
_links	ReferenceLinks	Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.
defaultBranch	string
id	string
isDisabled	boolean	True, wenn das Repository deaktiviert ist. Andernfalls FALSE.
isFork	boolean	True, wenn das Repository als Fork erstellt wurde.
isInMaintenance	boolean	True, wenn sich das Repository in Wartung befindet. Andernfalls FALSE.
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Stellt einen flachen Verweis auf ein TeamProject dar.
remoteUrl	string
size	integer	Komprimierte Größe (Bytes) des Repositorys.
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryRef

Name	Typ	Beschreibung
collection	TeamProjectCollectionReference	Team Project Collection, in der sich dieser Fork befindet
id	string
isFork	boolean	True, wenn das Repository als Fork erstellt wurde
name	string
project	TeamProjectReference	Stellt einen flachen Verweis auf ein TeamProject dar.
remoteUrl	string
sshUrl	string
url	string

ProjectState

Projektstatus.

Name	Typ	Beschreibung
all	string	Alle Projekte unabhängig vom Zustand außer Gelöscht.
createPending	string	Project wurde für die Erstellung in die Warteschlange gestellt, aber der Prozess wurde noch nicht gestartet.
deleted	string	Project wurde gelöscht.
deleting	string	Project wird gerade gelöscht.
new	string	Das Projekt wird gerade erstellt.
unchanged	string	Project wurde nicht geändert.
wellFormed	string	Project ist vollständig erstellt und einsatzbereit.

ProjectVisibility

Projektsichtbarkeit.

Name	Typ	Beschreibung
private	string	Das Projekt ist nur für Benutzer mit explizitem Zugriff sichtbar.
public	string	Das Projekt ist für alle sichtbar.

ReferenceLinks

Die Klasse, die eine Auflistung von REST-Verweislinks darstellt.

Name	Typ	Beschreibung
links	object	Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützt sind, möchten wir sie nur als schreibgeschützt verfügbar machen.

TeamProjectCollectionReference

Referenzobjekt für eine TeamProjectCollection.

Name	Typ	Beschreibung
avatarUrl	string	Sammlungs-Avatar-URL.
id	string	Sammlungs-ID.
name	string	Sammlungsname.
url	string	SAMMLUNGS-REST-URL.

TeamProjectReference

Stellt einen flachen Verweis auf ein TeamProject dar.

Name	Typ	Beschreibung
abbreviation	string	Projektkürzel.
defaultTeamImageUrl	string	URL zum Standardmäßigen Teamidentitätsimage.
description	string	Die Projektbeschreibung (falls vorhanden).
id	string	Projektbezeichner.
lastUpdateTime	string	Zeitpunkt der letzten Aktualisierung des Projekts.
name	string	Der Projektname.
revision	integer	Projektrevision.
state	ProjectState	Projektstatus.
url	string	URL zur Vollversion des Objekts.
visibility	ProjectVisibility	Projektsichtbarkeit.