Git - Initialize Connection

Hizmet:: Core

API Sürümü:: v1

Git'e bağlı bir çalışma alanı için bağlantı başlatın.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

Bu API'yi kullanmak için çağıranın Git kimlik bilgileri Git Kimlik Bilgilerimi Güncelleştir API'sini kullanarak yapılandırılmalıdır. Git kimlik bilgileri yapılandırmasını denetlemek için Git Kimlik Bilgilerimi Al API'sini kullanabilirsiniz.

Bu API , Connect API'sine yapılan başarılı bir çağrıdan sonra çağrılmalıdır. Çalışma alanının tam eşitlemesini tamamlamak için Gerekli Eylem işlemini kullanarak Git'e İşleme veya Git'ten Güncelleştirme gibi ilgili eşitleme işlemini çağırın.

Permissions

Çağıranın bir yönetici çalışma alanı rolü olmalıdır.

Gerekli Temsilci Kapsamları

Workspace.ReadWrite.All

Microsoft Entra destekli kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Identity	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Interface

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/initializeConnection

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.

İstek Gövdesi

Name	Tür	Description
initializationStrategy	InitializationStrategy	İçerik hem uzak tarafta hem de çalışma alanı tarafında mevcut olduğunda başlatma işlemi için gereken strateji. Zaman içinde ek stratejiler eklenebilir.

Yanıtlar

Name	Tür	Description
200 OK	InitializeGitConnectionResponse	İstek başarıyla tamamlandı.
202 Accepted		İstek kabul edildi, devam eden bağlantıyı başlatın. Üst Bilgiler Location: string x-ms-operation-id: string Retry-After: integer
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: WorkspaceNotConnectedToGit - Çalışma alanı git'e bağlı değil. WorkspaceHasNoCapacityAssigned - Çalışma Alanına kapasite atanmadı. MissingInitializationPolicy - Başlatma ilkesi eksik. InsufficientPrivileges - Çağıranın çalışma alanında yeterli izinleri yok. PrincipalTypeNotSupported - Çağıran kimlik türü desteklenmiyor.

Örnekler

Initialize the connection of a workspace connected to a Git example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/1565e6a3-c020-4c0c-dda7-92bafe99eec5/git/initializeConnection

Örnek yanıt

Durum kodu:: 200

{
  "requiredAction": "UpdateFromGit",
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705"
}

Durum kodu:: 202

Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30

Tanımlar

Name	Description
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
InitializationStrategy	İçerik hem uzak tarafta hem de çalışma alanı tarafında mevcut olduğunda başlatma işlemi için gereken strateji. Zaman içinde ek stratejiler eklenebilir.
InitializeGitConnectionRequest	Git bağlantı isteği başlatma verilerini içerir.
InitializeGitConnectionResponse	Git bağlantısı başlatma yanıt verilerini içerir.
RequiredAction	Başlatma işlemi tamamlandıktan sonra gerekli eylem. Zaman içinde ek eylemler eklenebilir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi `Retry-After` belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

InitializationStrategy

Numaralandırma

İçerik hem uzak tarafta hem de çalışma alanı tarafında mevcut olduğunda başlatma işlemi için gereken strateji. Zaman içinde ek stratejiler eklenebilir.

Değer	Description
None	Strateji tanımlanmadı.
PreferRemote	Uzak Git tarafı içeriğini tercih edin.
PreferWorkspace	Çalışma alanı tarafı içeriğini tercih edin.

InitializeGitConnectionRequest

Nesne

Git bağlantı isteği başlatma verilerini içerir.

Name	Tür	Description
initializationStrategy	InitializationStrategy	İçerik hem uzak tarafta hem de çalışma alanı tarafında mevcut olduğunda başlatma işlemi için gereken strateji. Zaman içinde ek stratejiler eklenebilir.

InitializeGitConnectionResponse

Nesne

Git bağlantısı başlatma yanıt verilerini içerir.

Name	Tür	Description
remoteCommitHash	string	Uzaktan tam SHA işleme karması.
requiredAction	RequiredAction	Başlatma işlemi tamamlandıktan sonra gerekli eylem. Zaman içinde ek eylemler eklenebilir.
workspaceHead	string	Çalışma alanının eşitlendiği tam SHA karması.

RequiredAction

Numaralandırma

Başlatma işlemi tamamlandıktan sonra gerekli eylem. Zaman içinde ek eylemler eklenebilir.

Değer	Description
None	Eylem gerekmez.
UpdateFromGit	Git'ten güncelleştirme gereklidir.
CommitToGit	Git'e işleme gereklidir.