Repositories - Get Repository

Service:

Git

API Version:

7.1-preview.1

Git deposunu alın.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
repositoryId	path	True	string	Deponun adı veya kimliği.
project	path		string	Proje Kimliği veya proje adı
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, api'nin bu sürümünü kullanmak için '7.1-preview.1' olarak ayarlanmalıdır.

Yanıtlar

Name	Tür	Description
200 OK	GitRepository	başarılı işlem

Güvenlik

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	İşlemeler, değişiklik kümeleri, dallar ve diğer sürüm denetimi yapıtları hakkında kaynak kodu ve meta verileri okuma yeteneği verir. Ayrıca kod arama ve hizmet kancaları aracılığıyla sürüm denetimi olayları hakkında bildirim alma olanağı verir.

Örnekler

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

Tanımlar

Name	Description
GitRepository
GitRepositoryRef
ProjectState	Proje durumu.
ProjectVisibility	Proje görünürlüğü.
ReferenceLinks	REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.
TeamProjectCollectionReference	TeamProjectCollection için başvuru nesnesi.
TeamProjectReference	TeamProject'e basit bir başvuru temsil eder.

GitRepository

Name	Tür	Description
_links	ReferenceLinks	REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.
defaultBranch	string
id	string
isDisabled	boolean	Depo devre dışıysa True. Aksi durumda false.
isFork	boolean	Depo çatal olarak oluşturulduysa True.
isInMaintenance	boolean	Depo bakımdaysa True. Aksi durumda false.
name	string
parentRepository	GitRepositoryRef
project	TeamProjectReference	TeamProject'e basit bir başvuru temsil eder.
remoteUrl	string
size	integer	Deponun sıkıştırılmış boyutu (bayt).
sshUrl	string
url	string
validRemoteUrls	string[]
webUrl	string

GitRepositoryRef

Name	Tür	Description
collection	TeamProjectCollectionReference	Bu Çatal'ın bulunduğu Takım Projesi Koleksiyonu
id	string
isFork	boolean	Depo çatal olarak oluşturulduysa True
name	string
project	TeamProjectReference	TeamProject'e basit bir başvuru temsil eder.
remoteUrl	string
sshUrl	string
url	string

ProjectState

Proje durumu.

Name	Tür	Description
all	string	Durumu silindi dışında tüm projeler.
createPending	string	Proje oluşturma için kuyruğa alındı, ancak işlem henüz başlamadı.
deleted	string	Proje silindi.
deleting	string	Project silinme sürecinde.
new	string	Proje oluşturulma aşamasındadır.
unchanged	string	Proje değiştirilmedi.
wellFormed	string	Proje tamamen oluşturulur ve kullanıma hazırdır.

ProjectVisibility

Proje görünürlüğü.

Name	Tür	Description
private	string	Proje yalnızca açık erişimi olan kullanıcılar tarafından görülebilir.
public	string	Proje herkes tarafından görülebilir.

ReferenceLinks

REST başvuru bağlantılarının koleksiyonunu temsil eden sınıf.

Name	Tür	Description
links	object	Bağlantıların salt okunur görünümü. Başvuru bağlantıları salt okunur olduğundan, bunları yalnızca salt okunur olarak kullanıma açmak istiyoruz.

TeamProjectCollectionReference

TeamProjectCollection için başvuru nesnesi.

Name	Tür	Description
avatarUrl	string	Koleksiyon avatarı Url'si.
id	string	Koleksiyon Kimliği.
name	string	Koleksiyon Adı.
url	string	Koleksiyon REST Url'si.

TeamProjectReference

TeamProject'e basit bir başvuru temsil eder.

Name	Tür	Description
abbreviation	string	Proje kısaltması.
defaultTeamImageUrl	string	Varsayılan ekip kimliği görüntüsünün URL'si.
description	string	Projenin açıklaması (varsa).
id	string	Proje tanımlayıcısı.
lastUpdateTime	string	Proje son güncelleştirme zamanı.
name	string	Proje adı.
revision	integer	Proje düzeltmesi.
state	ProjectState	Proje durumu.
url	string	Nesnenin tam sürümünün URL'si.
visibility	ProjectVisibility	Proje görünürlüğü.