Condividi tramite

Repositories - List

  • Riferimento
Servizio:
Git
Versione API:
7.1

Recuperare i repository Git.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?api-version=7.1
Con parametri facoltativi: 
GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories?includeLinks={includeLinks}&includeAllUrls={includeAllUrls}&includeHidden={includeHidden}&api-version=7.1

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
 path True

string

Nome dell'organizzazione di Azure DevOps.
project
 path

string

ID progetto o nome progetto
api-version
 query True

string

Versione dell'API da usare. Deve essere impostato su '7.1' per usare questa versione dell'API.
includeAllUrls
 query

boolean

[facoltativo] True per includere tutti gli URL remoti. Il valore predefinito è false.
includeHidden
 query

boolean

[facoltativo] True per includere repository nascosti. Il valore predefinito è false.
includeLinks
 query

boolean

[facoltativo] True per includere i collegamenti di riferimento. Il valore predefinito è false.

Risposte

Nome Tipo Descrizione
200 OK

GitRepository[]

operazione riuscita

Sicurezza

oauth2

Tipo: oauth2
Flow: accessCode
URL di autorizzazione: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL token: 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

Ambiti

Nome Descrizione
vso.code Concede la possibilità di leggere il codice sorgente e i metadati relativi a commit, insiemi di modifiche, rami e altri artefatti del controllo della versione. Concede inoltre la possibilità di cercare il codice e ricevere notifiche sugli eventi di controllo della versione tramite hook del servizio.

Esempio

Esempio di richiesta

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

Risposta di esempio

Codice di stato:
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"
    }
  ]
}

Definizioni

Nome Descrizione
GitRepository
GitRepositoryRef
ProjectState

Stato del progetto.
ProjectVisibility

Visibilità del progetto.
ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.
TeamProjectCollectionReference

Oggetto di riferimento per un oggetto TeamProjectCollection.
TeamProjectReference

Rappresenta un riferimento superficiale a un oggetto TeamProject.

GitRepository

Object
Nome Tipo Descrizione
_links

ReferenceLinks

Classe per rappresentare una raccolta di collegamenti di riferimento REST.
defaultBranch

string

id

string (uuid)

isDisabled

boolean

True se il repository è disabilitato. False in caso contrario.
isFork

boolean

True se il repository è stato creato come fork.
isInMaintenance

boolean

True se il repository è in manutenzione. False in caso contrario.
name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Rappresenta un riferimento superficiale a un oggetto TeamProject.
remoteUrl

string

size

integer (int64)

Dimensioni compresse (byte) del repository.
sshUrl

string

url

string

validRemoteUrls

string[]

webUrl

string

GitRepositoryRef

Object
Nome Tipo Descrizione
collection

TeamProjectCollectionReference

Raccolta di progetti team in cui risiede il fork
id

string (uuid)

isFork

boolean

True se il repository è stato creato come fork
name

string

project

TeamProjectReference

Rappresenta un riferimento superficiale a un oggetto TeamProject.
remoteUrl

string

sshUrl

string

url

string

ProjectState

Enumerazione

Stato del progetto.

Valore Descrizione
all

Tutti i progetti indipendentemente dallo stato tranne Deleted.
createPending

Il progetto è stato accodato per la creazione, ma il processo non è ancora stato avviato.
deleted

Il progetto è stato eliminato.
deleting

Il progetto è in corso di eliminazione.
new

Il progetto è in fase di creazione.
unchanged

Il progetto non è stato modificato.
wellFormed

Il progetto è completamente creato e pronto per l'uso.

ProjectVisibility

Enumerazione

Visibilità del progetto.

Valore Descrizione
private

Il progetto è visibile solo agli utenti con accesso esplicito.
public

Il progetto è visibile a tutti.
Object

Classe per rappresentare una raccolta di collegamenti di riferimento REST.

Nome Tipo Descrizione
links

object

Visualizzazione di sola lettura dei collegamenti. Poiché i collegamenti di riferimento sono di sola lettura, è consigliabile esporli solo come di sola lettura.

TeamProjectCollectionReference

Object

Oggetto di riferimento per un oggetto TeamProjectCollection.

Nome Tipo Descrizione
avatarUrl

string

URL avatar raccolta.
id

string (uuid)

ID raccolta.
name

string

Nome raccolta.
url

string

URL REST della raccolta.

TeamProjectReference

Object

Rappresenta un riferimento superficiale a un oggetto TeamProject.

Nome Tipo Descrizione
abbreviation

string

Abbreviazione del progetto.
defaultTeamImageUrl

string

URL dell'immagine di identità del team predefinita.
description

string

Descrizione del progetto (se presente).
id

string (uuid)

Identificatore del progetto.
lastUpdateTime

string (date-time)

Ora dell'ultimo aggiornamento del progetto.
name

string

Nome progetto.
revision

integer (int64)

Revisione del progetto.
state

ProjectState

Stato del progetto.
url

string

URL della versione completa dell'oggetto.
visibility

ProjectVisibility

Visibilità del progetto.