Git - Update From Git

Hizmet:: Core

API Sürümü:: v1

Çalışma alanını bağlı dala gönderilen işlemelerle güncelleştirir.
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.

Güncelleştirme yalnızca çalışma alanında bu işlemelerde değiştirilmiş olan öğeleri etkiler. Bağlantı API'lerine Bağlan ve Başlat'ın ardından çağrılırsa, tüm çalışma alanının tam güncelleştirmesini gerçekleştirir.

İzinler

Çağıranın katkıda bulunan veya daha yüksek çalışma alanı rolü olmalıdır.

Gerekli Temsilci Kapsamları

Workspace.GitUpdate.All

Microsoft Entra destekli kimlikler

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

Kimlik	Destek
Kullanıcı	Evet
Hizmet sorumlusu ve yönetilen kimlikler	Yalnızca işlemdeki tüm öğeler hizmet sorumlularını desteklediğinde desteklenir

Arayüz

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

URI Parametreleri

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

İstek Gövdesi

Name	Gerekli	Tür	Description
remoteCommitHash	True	string	Uzaktan tam SHA işleme karması.
conflictResolution		WorkspaceConflictResolution	Git işleminden güncelleştirmede kullanılacak çakışma çözümü. Öğeler çakışıyorsa ve çakışma çözümü belirtilmezse güncelleştirme işlemi başlatılmaz.
options		UpdateOptions	Git işleminden güncelleştirmede kullanılacak seçenekler
workspaceHead		string	Çalışma alanının eşitlendiği tam SHA karması. Bu değer yalnızca Bağlantı Başlatıldıktan sonra null olabilir. Diğer durumlarda, sistem verilen değerin sistem tarafından bilinen baş ile uyumlu olduğunu doğrular.

Yanıtlar

Name	Tür	Description
200 OK		İstek başarıyla tamamlandı.
202 Accepted		İstek kabul edildi, Git'ten güncelleştirme devam ediyor. Ü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ı. WorkspaceHeadMismatch - İstekteki head, sistemdeki kafayla eşleşmiyor. WorkspacePreviousOperationInProgress - Önceki işlem devam ediyor. MissingDependency - Güncelleştirme işleminde bir bağımlılık eksik. PotentialDuplicateDisplayNameAndType - Güncelleştirme işlemi yinelenen bir görünen ad ve tür oluşturur. DependencyDeletionFailed - Güncelleştirme işlemi sabit bağımlılığı siler. InsufficientPrivileges - Çağıranın yeterli çalışma alanı izinleri yok. PrincipalTypeNotSupported - Çağıran kimlik türü desteklenmiyor.

Örnekler

Update a workspace using data from a Git example

Örnek isteği

HTTP

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

{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "conflictResolution": {
    "conflictResolutionType": "Workspace",
    "conflictResolutionPolicy": "PreferWorkspace"
  },
  "options": {
    "allowOverrideItems": true
  }
}

Örnek yanıt

Durum kodu:: 200

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
ConflictResolutionPolicy	Çakışma çözümleme ilkesi. Zaman içinde ek çakışma çözümleme ilkeleri eklenebilir.
ConflictResolutionType	Çakışma çözümleme türü. Zaman içinde ek çakışma çözümleme türleri eklenebilir.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
UpdateFromGitRequest	Git istek verilerinden güncelleştirmeyi içerir.
UpdateOptions	Git'ten güncelleştirme için etkinleştirilen seçenekleri içerir.
WorkspaceConflictResolution	Temel çakışma çözümleme verileri.

ConflictResolutionPolicy

Numaralandırma

Çakışma çözümleme ilkesi. Zaman içinde ek çakışma çözümleme ilkeleri eklenebilir.

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

ConflictResolutionType

Numaralandırma

Çakışma çözümleme türü. Zaman içinde ek çakışma çözümleme türleri eklenebilir.

Değer	Description
Workspace	Çalışma alanı düzeyini temsil eden çakışma çözümü.

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ı.

UpdateFromGitRequest

Nesne

Git istek verilerinden güncelleştirmeyi içerir.

Name	Tür	Description
conflictResolution	WorkspaceConflictResolution	Git işleminden güncelleştirmede kullanılacak çakışma çözümü. Öğeler çakışıyorsa ve çakışma çözümü belirtilmezse güncelleştirme işlemi başlatılmaz.
options	UpdateOptions	Git işleminden güncelleştirmede kullanılacak seçenekler
remoteCommitHash	string	Uzaktan tam SHA işleme karması.
workspaceHead	string	Çalışma alanının eşitlendiği tam SHA karması. Bu değer yalnızca Bağlantı Başlatıldıktan sonra null olabilir. Diğer durumlarda, sistem verilen değerin sistem tarafından bilinen baş ile uyumlu olduğunu doğrular.

UpdateOptions

Nesne

Git'ten güncelleştirme için etkinleştirilen seçenekleri içerir.

Name	Tür	Description
allowOverrideItems	boolean	Git işleminden güncelleştirme sırasında gelen öğeleri geçersiz kılmak için kullanıcı onayı. Gelen öğeler mevcut olduğunda ve geçersiz kılma öğelerine izin ver belirtilmediğinde veya false olarak sağlandığında, güncelleştirme işlemi başlatılmaz. Varsayılan değer yanlış'tır.

WorkspaceConflictResolution

Nesne

Temel çakışma çözümleme verileri.

Name	Tür	Description
conflictResolutionPolicy	ConflictResolutionPolicy	Çakışma çözümleme ilkesi. Zaman içinde ek çakışma çözümleme ilkeleri eklenebilir.
conflictResolutionType	ConflictResolutionType	Çakışma çözümleme türü. Zaman içinde ek çakışma çözümleme türleri eklenebilir.