Git - Commit To Git

Hizmet:: Core

API Sürümü:: v1

Çalışma alanında yapılan değişiklikleri bağlı uzak dala kaydeder.
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.

Tüm değişiklikleri veya yalnızca belirli değiştirilmiş öğeleri işlemeyi seçebilirsiniz. Çalışma alanını ilk kez eşitlemek için Bağlan ve Bağlantı API'lerini Başlat'ın ardından bu API'yi kullanın.

İzinler

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

Gerekli Temsilci Kapsamları

Workspace.GitCommit.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/commitToGit

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
mode	True	CommitMode	İşleme işleminin modu.
comment		string maxLength: 300	Bu işleme için çağıran içermeyen açıklama. Uzunluk üst sınırı 300 karakterdir. Arayan tarafından herhangi bir açıklama sağlanmazsa, varsayılan Git sağlayıcısı açıklamasını kullanın.
items		ItemIdentifier[]	İşlemek için belirli öğeler. Bu yalnızca Seçmeli işleme modu için geçerlidir. Öğeler Git Durum API'sinden alınabilir.
workspaceHead		string	Çalışma alanının eşitlendiği tam SHA karması. Karma , Git Durum API'sinden alınabilir.

Yanıtlar

Name	Tür	Description
200 OK		İstek başarıyla tamamlandı.
202 Accepted		İstek kabul edildi, Git'e işleme 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 ataması yok. WorkspaceHeadMismatch - İstekteki head, sistemdeki kafayla eşleşmiyor. WorkspacePreviousOperationInProgress - Önceki işlem devam ediyor. InsufficientPrivileges - Çağıranın yeterli çalışma alanı izinleri yok. PrincipalTypeNotSupported - Çağıran kimlik türü desteklenmiyor.

Örnekler

Commit all to Git example

Commit selective items to Git example

Commit all to Git example

Örnek isteği

HTTP

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

{
  "mode": "All",
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "comment": "I'm committing all my changes."
}

Ö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

Commit selective items to Git example

Örnek isteği

HTTP

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

{
  "mode": "Selective",
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "comment": "I'm committing specific changes.",
  "items": [
    {
      "logicalId": "111e8d7b-4a95-4c02-8ccd-6faef5ba1bd1",
      "objectId": "1153f3b4-dbb8-33c1-a84f-6ae4d776362d"
    },
    {
      "objectId": "7753f3b4-dbb8-44c1-a94f-6ae4d776369e"
    }
  ]
}

Ö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
CommitMode	İşleme işleminin modları. Zaman içinde ek modlar eklenebilir.
CommitToGitRequest	İşleme isteğini içerir.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
ItemIdentifier	Öğe tanımlayıcısını içerir. Özelliklerden en az biri tanımlanmalıdır.

CommitMode

Numaralandırma

İşleme işleminin modları. Zaman içinde ek modlar eklenebilir.

Değer	Description
All	Tüm kaydedilmemiş değişiklikleri işleyin. Çağıranın işlenmek üzere öğelerin listesini sağlaması gerekmez.
Selective	Kaydedilmemiş değişiklikler içeren belirtilen öğeler listesini işleyin.

CommitToGitRequest

Nesne

İşleme isteğini içerir.

Name	Tür	Description
comment	string maxLength: 300	Bu işleme için çağıran içermeyen açıklama. Uzunluk üst sınırı 300 karakterdir. Arayan tarafından herhangi bir açıklama sağlanmazsa, varsayılan Git sağlayıcısı açıklamasını kullanın.
items	ItemIdentifier[]	İşlemek için belirli öğeler. Bu yalnızca Seçmeli işleme modu için geçerlidir. Öğeler Git Durum API'sinden alınabilir.
mode	CommitMode	İşleme işleminin modu.
workspaceHead	string	Çalışma alanının eşitlendiği tam SHA karması. Karma , Git Durum API'sinden alınabilir.

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

ItemIdentifier

Nesne

Öğe tanımlayıcısını içerir. Özelliklerden en az biri tanımlanmalıdır.

Name	Tür	Description
logicalId	string (uuid)	Öğenin mantıksal kimliği. Öğe henüz çalışma alanına eklenmediği için mantıksal kimlik kullanılamıyorsa nesne kimliğini kullanabilirsiniz.
objectId	string (uuid)	Öğenin nesne kimliği. Öğe çalışma alanından silindiği için nesne kimliği kullanılamadığında mantıksal kimliği kullanabilirsiniz.