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. |
include
|
query |
boolean |
[volitelné] True, pokud chcete zahrnout všechny vzdálené adresy URL. Výchozí hodnota je False. |
|
include
|
query |
boolean |
[volitelné] True, pokud chcete zahrnout skrytá úložiště. Výchozí hodnota je False. |
|
include
|
query |
boolean |
[volitelné] True, pokud chcete zahrnout odkazy. Výchozí hodnota je False. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
ú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 |
---|---|
Git |
|
Git |
|
Project |
Stav projektu. |
Project |
Viditelnost projektu. |
Reference |
Třída představující kolekci odkazů REST. |
Team |
Referenční objekt pro TeamProjectCollection. |
Team |
Představuje mělký odkaz na TeamProject. |
GitRepository
Name | Typ | Description |
---|---|---|
_links |
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 | ||
project |
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 |
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 |
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. |
ReferenceLinks
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 |
Stav projektu. |
|
url |
string |
Adresa URL na plnou verzi objektu. |
visibility |
Viditelnost projektu. |