Repositories - List

Načtěte úložiště 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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
organization
path True

string

Název organizace Azure DevOps.

project
path

string

ID projektu nebo název projektu

api-version
query True

string

Verze rozhraní API, která se má použít. Tato verze rozhraní API by měla být nastavená na 7.1-preview.1.

includeAllUrls
query

boolean

[volitelné] True, pokud chcete zahrnout všechny vzdálené adresy URL. Výchozí hodnota je False.

includeHidden
query

boolean

[volitelné] True, pokud chcete zahrnout skrytá úložiště. Výchozí hodnota je False.

includeLinks
query

boolean

[volitelné] True, pokud chcete zahrnout odkazy. Výchozí hodnota je False.

Odpovědi

Name Typ Description
200 OK

GitRepository[]

úspěšná operace

Zabezpečení

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 Description
vso.code Uděluje možnost číst zdrojový kód a metadata o potvrzeních, sadách změn, větvích a dalších artefaktech správy verzí. Umožňuje také prohledávat kód a dostávat oznámení o událostech správy verzí prostřednictvím hooků služeb.

Příklady

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

Definice

Name Description
GitRepository
GitRepositoryRef
ProjectState

Stav projektu.

ProjectVisibility

Viditelnost projektu.

ReferenceLinks

Třída představující kolekci odkazů REST.

TeamProjectCollectionReference

Referenční objekt pro TeamProjectCollection.

TeamProjectReference

Představuje mělký odkaz na TeamProject.

GitRepository

Name Typ Description
_links

ReferenceLinks

Třída představující kolekci odkazů REST.

defaultBranch

string

id

string

isDisabled

boolean

True, pokud je úložiště zakázané. V ostatních případech False

isFork

boolean

Hodnota True, pokud se úložiště vytvořilo jako fork.

isInMaintenance

boolean

Hodnota True, pokud je úložiště v režimu údržby. V ostatních případech False

name

string

parentRepository

GitRepositoryRef

project

TeamProjectReference

Představuje mělký odkaz na TeamProject.

remoteUrl

string

size

integer

Komprimovaná velikost (bajty) úložiště.

sshUrl

string

url

string

validRemoteUrls

string[]

webUrl

string

GitRepositoryRef

Name Typ Description
collection

TeamProjectCollectionReference

Kolekce týmových projektů, kde se nachází tento fork

id

string

isFork

boolean

Hodnota True, pokud se úložiště vytvořilo jako fork

name

string

project

TeamProjectReference

Představuje mělký odkaz na TeamProject.

remoteUrl

string

sshUrl

string

url

string

ProjectState

Stav projektu.

Name Typ Description
all

string

Všechny projekty bez ohledu na stav s výjimkou Odstraněno.

createPending

string

Projekt byl zařazen do fronty k vytvoření, ale tento proces ještě nebyl zahájen.

deleted

string

Projekt byl odstraněn.

deleting

string

Projekt se právě odstraňuje.

new

string

Projekt se právě vytváří.

unchanged

string

Projekt nebyl změněn.

wellFormed

string

Projekt je zcela vytvořený a připravený k použití.

ProjectVisibility

Viditelnost projektu.

Name Typ Description
private

string

Projekt je viditelný pouze uživatelům s explicitním přístupem.

public

string

Projekt je viditelný pro všechny.

Třída představující kolekci odkazů REST.

Name Typ Description
links

object

Zobrazení odkazů jen pro čtení. Odkazy jsou jen pro čtení, a proto je chceme zveřejnit jen jako odkazy jen pro čtení.

TeamProjectCollectionReference

Referenční objekt pro TeamProjectCollection.

Name Typ Description
avatarUrl

string

Adresa URL avatara kolekce.

id

string

ID kolekce.

name

string

Název kolekce.

url

string

Adresa URL REST kolekce.

TeamProjectReference

Představuje mělký odkaz na TeamProject.

Name Typ Description
abbreviation

string

Zkratka projektu

defaultTeamImageUrl

string

Adresa URL výchozího obrázku týmové identity

description

string

Popis projektu (pokud existuje)

id

string

Identifikátor projektu.

lastUpdateTime

string

Čas poslední aktualizace projektu.

name

string

Název projektu.

revision

integer

Revize projektu.

state

ProjectState

Stav projektu.

url

string

Adresa URL na plnou verzi objektu.

visibility

ProjectVisibility

Viditelnost projektu.