Repositories - Get Repository

Service:

Git

API Version:

7.1-preview.1

Načtěte úložiště Git.

GET https://dev.azure.com/{organization}/{project}/_apis/git/repositories/{repositoryId}?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.
repositoryId	path	True	string	Název nebo ID úložiště.
project	path		string	ID projektu nebo název projektu
api-version	query	True	string	Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na 7.1-preview.1.

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	Umožňuje čí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 služby Hooks.

Příklady

Get a repository by remote URL

Get a repository by repositoryId

Get a repository by remote URL

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/_apis/git/repositories/{repositoryId}?api-version=7.1-preview.1

Sample Response

Status code:

200

{
  "serverUrl": "https://dev.azure.com/fabrikam",
  "collection": {
    "id": "e22ddea7-989e-455d-b46a-67e991b04714",
    "name": "fabrikam",
    "url": "https://dev.azure.com/fabrikam/_apis/projectCollections/e22ddea7-989e-455d-b46a-67e991b04714"
  },
  "repository": {
    "id": "2f3d611a-f012-4b39-b157-8db63f380226",
    "name": "FabrikamCloud",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/2f3d611a-f012-4b39-b157-8db63f380226",
    "project": {
      "id": "3b3ae425-0079-421f-9101-bcf15d6df041",
      "name": "FabrikamCloud",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/3b3ae425-0079-421f-9101-bcf15d6df041",
      "state": 1,
      "revision": 411518573
    },
    "remoteUrl": "https://dev.azure.com/fabrikam/FabrikamCloud/_git/FabrikamCloud"
  }
}

Get a repository by repositoryId

Sample Request

HTTP

GET https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6?api-version=7.1-preview.1

Sample Response

Status code:

200

{
  "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",
    "revision": 293012730
  },
  "defaultBranch": "refs/heads/master",
  "remoteUrl": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_git/AnotherRepository",
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6"
    },
    "project": {
      "href": "vstfs:///Classification/TeamProject/6ce954b1-ce1f-45d1-b94d-e6bf2464ba2c"
    },
    "web": {
      "href": "https://dev.azure.com/fabrikam/Fabrikam-Fiber-Git/_git/AnotherRepository"
    },
    "commits": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6/commits"
    },
    "refs": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6/refs"
    },
    "pullRequests": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6/pullRequests"
    },
    "items": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6/items"
    },
    "pushes": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/5febef5a-833d-4e14-b9c0-14cb638f91e6/pushes"
    }
  }
}

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 povrchní odkaz na TeamProject.

GitRepository

Name	Typ	Description
_links	ReferenceLinks	Třída představující kolekci odkazů REST.
defaultBranch	string
id	string
isDisabled	boolean	Hodnota True, pokud je úložiště zakázané. V ostatních případech False
isFork	boolean	True, pokud se úložiště vytvořilo jako fork.
isInMaintenance	boolean	Hodnota True, pokud je úložiště v údržbě. V ostatních případech False
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	Představuje povrchní 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	True, pokud se úložiště vytvořilo jako fork
name	string
project	TeamProjectReference	Představuje povrchní 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 pro vytvoření, ale 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 kompletně 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í. Vzhledem k tomu, že odkazy jsou jen pro čtení, chceme je zveřejnit jenom jako 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 povrchní 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 pro úplnou verzi objektu.
visibility	ProjectVisibility	Viditelnost projektu.