Import Requests - Create

Başvuru

Hizmet:: Git

API Sürümü:: 7.1

İçeri aktarma isteği oluşturun.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
project	path	True	string	Proje kimliği veya proje adı
repositoryId	path	True	string	Deponun adı veya kimliği.
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' olarak ayarlanmalıdır.

İstek Gövdesi

Name	Tür	Description
_links	ReferenceLinks	İlgili kaynaklara bağlantılar.
detailedStatus	GitImportStatusDetail	Geçerli adım ve varsa bir hata iletisi de dahil olmak üzere içeri aktarma işleminin ayrıntılı durumu.
importRequestId	integer (int32)	Bu içeri aktarma isteğinin benzersiz tanımlayıcısı.
parameters	GitImportRequestParameters	İçeri aktarma isteğini oluşturmaya yönelik parametreler.
repository	GitRepository	Bu içeri aktarma için hedef depo.
status	GitAsyncOperationStatus	İçeri aktarmanın geçerli durumu.
url	string	Bu içeri aktarma isteği kaynağına bir bağlantı.

Yanıtlar

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

Güvenlik

oauth2

Tür: oauth2
Akış: accessCode
Yetkilendirme URL’si: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Belirteç URL'si: 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

Kapsamlar

Name	Description
vso.code_manage	Kaynak kodu okuma, güncelleştirme ve silme, işlemeler, değişiklik kümeleri, dallar ve diğer sürüm denetimi yapıtları hakkındaki meta verilere erişme olanağı sağlar. Ayrıca kod depoları oluşturup yönetme, çekme istekleri ve kod gözden geçirmeleri oluşturup yönetme ve hizmet kancaları aracılığıyla sürüm denetimi olayları hakkında bildirim alma olanağı sağlar.

Örnekler

Örnek isteği

HTTP

POST https://dev.azure.com/fabrikam/Test/_apis/git/repositories/0eb02d2e-fff9-4990-bd45-2f7503f5aae5/importRequests?api-version=7.1

{
  "parameters": {
    "gitSource": {
      "url": "https://github.com/Microsoft/vsts-agent.git"
    }
  }
}

Örnek yanıt

Durum kodu:: 201

{
  "importRequestId": 2,
  "repository": {
    "id": "0eb02d2e-fff9-4990-bd45-2f7503f5aae5",
    "name": "EmptyGitRepo",
    "url": "https://dev.azure.com/fabrikam/_apis/git/repositories/0eb02d2e-fff9-4990-bd45-2f7503f5aae5",
    "project": {
      "id": "5745879a-8531-41c3-9ed3-ae7fc07309ff",
      "name": "Test",
      "url": "https://dev.azure.com/fabrikam/_apis/projects/5745879a-8531-41c3-9ed3-ae7fc07309ff",
      "state": "wellFormed",
      "revision": 7
    },
    "remoteUrl": "https://dev.azure.com/fabrikam/Test/_git/EmptyGitRepo"
  },
  "parameters": {
    "gitSource": {
      "url": "https://github.com/Microsoft/vsts-agent.git"
    }
  },
  "status": "queued",
  "detailedStatus": {
    "currentStep": 1,
    "allSteps": [
      "Processing request",
      "Analyzing repository objects",
      "Storing objects",
      "Storing index file",
      "Updating references",
      "Import completed successfully"
    ]
  },
  "_links": {
    "self": {
      "href": "https://dev.azure.com/fabrikam/Test/_apis/git/repositories/0eb02d2e-fff9-4990-bd45-2f7503f5aae5/importRequests/2"
    },
    "repository": {
      "href": "https://dev.azure.com/fabrikam/_apis/git/repositories/0eb02d2e-fff9-4990-bd45-2f7503f5aae5"
    }
  },
  "url": "https://dev.azure.com/fabrikam/Test/_apis/git/repositories/0eb02d2e-fff9-4990-bd45-2f7503f5aae5/importRequests/2"
}

Tanımlar

Name	Description
GitAsyncOperationStatus
GitImportGitSource	Kaynak Git sürüm denetimi olduğunda git içeri aktarma isteği oluşturma parametresi
GitImportRequest	Uzak kaynak denetim sisteminden veri içeri aktarma isteği.
GitImportRequestParameters	İçeri aktarma isteği oluşturma parametreleri
GitImportStatusDetail	İçeri aktarma isteği hakkında ek durum bilgileri.
GitImportTfvcSource	Kaynak tfvc sürüm denetimi olduğunda git içeri aktarma isteği oluşturma parametresi
GitRepository
GitRepositoryRef
ProjectState	Proje durumu.
ProjectVisibility	Proje görünürlüğü.
ReferenceLinks	REST başvuru bağlantıları koleksiyonunu temsil eden sınıf.
TeamProjectCollectionReference	TeamProjectCollection için başvuru nesnesi.
TeamProjectReference	TeamProject'e basit bir başvuru temsil eder.

GitAsyncOperationStatus

Listeleme

Değer	Description
abandoned	İşlem bırakıldı.
completed	İşlem tamamlandı.
failed	İşlem başarısız oldu. Bir hata iletisi olup olmadığını denetleyin.
inProgress	İşlem şu anda devam ediyor.
queued	İşlem bir kuyrukta bekliyor ve henüz başlatılmadı.

GitImportGitSource

Object

Kaynak Git sürüm denetimi olduğunda git içeri aktarma isteği oluşturma parametresi

Name	Tür	Description
overwrite	boolean	Bunun bir eşitleme isteği olup olmadığını bildirir
url	string	Kaynak depo url'si

GitImportRequest

Object

Uzak kaynak denetim sisteminden veri içeri aktarma isteği.

Name	Tür	Description
_links	ReferenceLinks	İlgili kaynaklara bağlantılar.
detailedStatus	GitImportStatusDetail	Geçerli adım ve varsa bir hata iletisi de dahil olmak üzere içeri aktarma işleminin ayrıntılı durumu.
importRequestId	integer (int32)	Bu içeri aktarma isteğinin benzersiz tanımlayıcısı.
parameters	GitImportRequestParameters	İçeri aktarma isteğini oluşturmaya yönelik parametreler.
repository	GitRepository	Bu içeri aktarma için hedef depo.
status	GitAsyncOperationStatus	İçeri aktarmanın geçerli durumu.
url	string	Bu içeri aktarma isteği kaynağına bir bağlantı.

GitImportRequestParameters

Object

İçeri aktarma isteği oluşturma parametreleri

Name	Tür	Description
deleteServiceEndpointAfterImportIsDone	boolean	İçeri aktarma tamamlandığında hizmet uç noktasını silme seçeneği
gitSource	GitImportGitSource	Git deposunu içeri aktarma kaynağı
serviceEndpointId	string (uuid)	Dış uç noktaya bağlantı için Hizmet Uç Noktası
tfvcSource	GitImportTfvcSource	tfvc deposunu içeri aktarma kaynağı

GitImportStatusDetail

Object

İçeri aktarma isteği hakkında ek durum bilgileri.

Name	Tür	Description
allSteps	string[]	İçeri aktarma işlemi için tüm geçerli adımlar
currentStep	integer (int32)	Geçerli adım için AllSteps dizinini oluşturma
errorMessage	string	İşlem başarısız olursa hata iletisi.

GitImportTfvcSource

Object

Kaynak tfvc sürüm denetimi olduğunda git içeri aktarma isteği oluşturma parametresi

Name	Tür	Description
importHistory	boolean	İçeri aktarma Geçmişi için true, aksi takdirde false olarak ayarlayın
importHistoryDurationInDays	integer (int32)	Son n gün için geçmiş alma (izin verilen maksimum değer 180 gündür)
path	string	İçeri aktarmak istediğimiz yol (bu, Gezgin'deki Yol Denetimi'nden kopyalanabilir)

GitRepository

Object

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

GitRepositoryRef

Object

Name	Tür	Description
collection	TeamProjectCollectionReference	Bu Çatal'ın bulunduğu Takım Projesi Koleksiyonu
id	string (uuid)
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

Listeleme

Proje durumu.

Değer	Description
all	Durumu ne olursa olsun, Silinmiş dışındaki tüm projeler.
createPending	Proje oluşturma için kuyruğa alındı, ancak işlem henüz başlamadı.
deleted	Proje silindi.
deleting	Project siliniyor.
new	Proje oluşturulma aşamasındadır.
unchanged	Proje değiştirilmedi.
wellFormed	Proje tamamen oluşturulur ve kullanıma hazırdır.

ProjectVisibility

Listeleme

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

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

ReferenceLinks

Object

REST başvuru bağlantıları 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

Object

TeamProjectCollection için başvuru nesnesi.

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

TeamProjectReference

Object

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 (uuid)	Proje tanımlayıcısı.
lastUpdateTime	string (date-time)	Proje son güncelleştirme zamanı.
name	string	Proje adı.
revision	integer (int64)	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üğü.

Aracılığıyla paylaş

Import Requests - Create

URI Parametreleri

İstek Gövdesi

Yanıtlar

Güvenlik

oauth2

Kapsamlar

Örnekler

Örnek isteği

Örnek yanıt

Tanımlar

GitAsyncOperationStatus

GitImportGitSource

GitImportRequest

GitImportRequestParameters

GitImportStatusDetail

GitImportTfvcSource

GitRepository

GitRepositoryRef

ProjectState

ProjectVisibility

ReferenceLinks

TeamProjectCollectionReference

TeamProjectReference