Repositories - List

Referenz

Dienst:: Git

API-Version:: 7.1

Abrufen von Git-Repositorys.

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

Mit optionalen Parametern:

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?includeLinks={includeLinks}&includeAllUrls={includeAllUrls}&includeHidden={includeHidden}&api-version=7.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" 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 Referenzverknüpfungslinks einzuschließen. Der Standardwert ist "false".

Antworten

Name	Typ	Beschreibung
200 OK	GitRepository[]	Erfolgreicher Vorgang

Sicherheit

oauth2

Typ: oauth2
Ablauf: accessCode
Autorisierungs-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

Bereiche

Name	Beschreibung
vso.code	Gewährt die Möglichkeit, Quellcode und Metadaten zu Commits, Changesets, Verzweigungen und anderen Versionskontrollartefakten zu lesen. Gewährt außerdem die Möglichkeit, Code zu durchsuchen und über Dienst-Hooks über Versionssteuerungsereignisse benachrichtigt zu werden.

Beispiele

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:: 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-Referenzverknüpfungslinks darstellt.
TeamProjectCollectionReference	Reference-Objekt für eine TeamProjectCollection.
TeamProjectReference	Stellt einen flachen Verweis auf ein TeamProject dar.

GitRepository

Objekt

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

GitRepositoryRef

Objekt

Name	Typ	Beschreibung
collection	TeamProjectCollectionReference	Teamprojektsammlung, in der sich diese Verzweigung befindet
id	string (uuid)
isFork	boolean	True, wenn das Repository als Verzweigung erstellt wurde
name	string
project	TeamProjectReference	Stellt einen flachen Verweis auf ein TeamProject dar.
remoteUrl	string
sshUrl	string
url	string

ProjectState

Enumeration

Projektstatus.

Wert	Beschreibung
all	Alle Projekte unabhängig vom Status außer "Gelöscht".
createPending	Projekt wurde zur Erstellung in die Warteschlange gestellt, aber der Prozess wurde noch nicht gestartet.
deleted	Projekt wurde gelöscht.
deleting	Project wird gerade gelöscht.
new	Projekt wird gerade erstellt.
unchanged	Projekt wurde nicht geändert.
wellFormed	Project wird vollständig erstellt und kann verwendet werden.

ProjectVisibility

Enumeration

Projektsichtbarkeit.

Wert	Beschreibung
private	Das Projekt ist nur für Benutzer mit expliziten Zugriff sichtbar.
public	Das Projekt ist für alle sichtbar.

ReferenceLinks

Objekt

Die Klasse, die eine Auflistung von REST-Referenzverknüpfungslinks darstellt.

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

TeamProjectCollectionReference

Objekt

Reference-Objekt für eine TeamProjectCollection.

Name	Typ	Beschreibung
avatarUrl	string	Sammlung Avatar-URL.
id	string (uuid)	Sammlungs-ID.
name	string	Sammlungsname.
url	string	Rest-URL der Sammlung.

TeamProjectReference

Objekt

Stellt einen flachen Verweis auf ein TeamProject dar.

Name	Typ	Beschreibung
abbreviation	string	Projektkürzel.
defaultTeamImageUrl	string	Url zum standardmäßigen Teamidentitätsbild.
description	string	Die Beschreibung des Projekts (falls vorhanden).
id	string (uuid)	Projektbezeichner.
lastUpdateTime	string (date-time)	Zeitpunkt der letzten Aktualisierung des Projekts.
name	string	Projektname.
revision	integer (int64)	Projektrevision.
state	ProjectState	Projektstatus.
url	string	Die URL zur Vollversion des Objekts.
visibility	ProjectVisibility	Projektsichtbarkeit.

Freigeben über

Repositories - List

URI-Parameter

Antworten

Sicherheit

oauth2

Bereiche

Beispiele

Beispielanforderung

Beispiel für eine Antwort

Definitionen

GitRepository

GitRepositoryRef

ProjectState

ProjectVisibility

ReferenceLinks

TeamProjectCollectionReference

TeamProjectReference