Aracılığıyla paylaş

Git - Get Status

  • Başvuru
Hizmet:
Core
API Sürümü:
v1

Çalışma alanında Git'e işlenebilen öğelerin Git status döndürür.
Bu API, uzun süre çalışan işlemleri (LRO)destekler.

Durum, son çalışma alanı ve uzak dal eşitlemeden bu yana öğelerde yapılan değişiklikleri gösterir. Her iki konum da değiştirildiyse, API bir çakışmaya bayrak ekler.

İzinler

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

Gerekli Temsilci Kapsamları

Workspace.GitUpdate.All veya Workspace.GitCommit.All

Microsoft Entra tarafından desteklenen kimlikler

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

Kimlik Destek
Kullanıcı Evet
Hizmet sorumlusu ve yönetilen kimlikler Hayır

Arayüz

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/git/status

URI Parametreleri

Name İçinde Gerekli Tür Description
workspaceId
 path True

string

uuid

Çalışma alanı kimliği.

Yanıtlar

Name Tür Description
200 OK

GitStatusResponse

İstek başarıyla tamamlandı.
202 Accepted

İstek kabul edildi, devam eden durumu alın.

Üst Bilgiler

  • Location: string
  • x-ms-operation-id: string
  • 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ı kapasitede değil.

  • InsufficientPrivileges - Çağıranın yeterli çalışma alanı izinleri yok.

Örnekler

Get status example
Get status no changes example
Get status with conflict example

Get status example

Örnek isteği

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

Örnek yanıt

Durum kodu:
200 
{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "changes": [
    {
      "itemMetadata": {
        "itemIdentifier": {
          "objectId": "7753f3b4-dbb8-44c1-a94f-6ae4d776369e"
        },
        "itemType": "SemanticModel",
        "displayName": "My new dataset in the workspace"
      },
      "workspaceChange": "Added",
      "conflictType": "None"
    },
    {
      "itemMetadata": {
        "itemIdentifier": {
          "logicalId": "1423f3b4-dba5-44c1-a94f-6ae4d776369a"
        },
        "itemType": "Report",
        "displayName": "My deleted report in Git"
      },
      "remoteChange": "Deleted",
      "conflictType": "None"
    },
    {
      "itemMetadata": {
        "itemIdentifier": {
          "logicalId": "111e8d7b-4a95-4c02-8ccd-6faef5ba1bd1",
          "objectId": "1153f3b4-dbb8-33c1-a84f-6ae4d776362d"
        },
        "itemType": "SemanticModel",
        "displayName": "Modified dataset in the workspace"
      },
      "workspaceChange": "Modified",
      "conflictType": "None"
    }
  ]
}
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

Get status no changes example

Örnek isteği

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

Örnek yanıt

Durum kodu:
200 
{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "changes": []
}
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

Get status with conflict example

Örnek isteği

GET https://api.fabric.microsoft.com/v1/workspaces/1455b6a2-c120-4c1c-dda7-92bafe99bec3/git/status

Örnek yanıt

Durum kodu:
200 
{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "7d03b2918bf6aa62f96d0a4307293f3853201705",
  "changes": [
    {
      "itemMetadata": {
        "itemIdentifier": {
          "logicalId": "222e8d7b-4a95-4c02-8ccd-6faef5ba1bd2",
          "objectId": "8853f3b4-dbb8-33c1-a84f-6ae4d776362a"
        },
        "itemType": "Report",
        "displayName": "Modified report on both sides"
      },
      "remoteChange": "Modified",
      "workspaceChange": "Modified",
      "conflictType": "Conflict"
    }
  ]
}
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
ChangeType

Öğe değişikliği. Zaman içinde başka değiştirilmiş türler eklenebilir.
ConflictType

Hem çalışma alanında hem de uzakta bir öğenin değiştirilmesi. Zaman içinde başka değiştirilmiş türler eklenebilir.
ErrorRelatedResource

Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse

Hata yanıtı.
ErrorResponseDetails

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

Durum yanıtını içerir.
ItemChange

Öğenin değişiklik bilgilerini içerir.
ItemIdentifier

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

Öğe meta verilerini içerir.
ItemType

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

ChangeType

Listeleme

Öğe değişikliği. Zaman içinde başka değiştirilmiş türler eklenebilir.

Değer Description
Added

Yeni oluşturulan bir öğe.
Deleted

Öğe silindi.
Modified

Öğe içeriği değiştirildi.

ConflictType

Listeleme

Hem çalışma alanında hem de uzakta bir öğenin değiştirilmesi. Zaman içinde başka değiştirilmiş türler eklenebilir.

Değer Description
Conflict

Çalışma alanında ve uzak Git'te öğede farklı değişiklikler vardır.
None

Öğede değişiklik yok.
SameChanges

Çalışma alanında ve uzak Git'te öğede aynı değişiklikler var.

ErrorRelatedResource

Object

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

Object

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

Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Object

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

GitStatusResponse

Object

Durum yanıtını içerir.

Name Tür Description
changes

ItemChange[]

Uzak Git'te belirtilen çalışma alanına uygulanmayan değişikliklerin ve uzak Git'e uygulanmayan çalışma alanında yapılan değişikliklerin listesi.
remoteCommitHash

string

Uzaktan tam SHA işleme karması.
workspaceHead

string

Çalışma alanının eşitlendiği tam SHA karması.

ItemChange

Object

Öğenin değişiklik bilgilerini içerir.

Name Tür Description
conflictType

ConflictType

Hem çalışma alanı tarafında hem de uzak Git tarafında değişiklikler olduğunda.
itemMetadata

ItemMetadata

Öğe meta verileri.
remoteChange

ChangeType

Uzak Git tarafında değiştirin.
workspaceChange

ChangeType

Çalışma alanı tarafında değiştirin.

ItemIdentifier

Object

Öğ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.

ItemMetadata

Object

Öğe meta verilerini içerir.

Name Tür Description
displayName

string

Öğenin görünen adı. Varsa çalışma alanı öğesinin görünen adını tercih eder, aksi takdirde displayName uzak öğenin görünen adını kullanır.
itemIdentifier

ItemIdentifier

Öğe tanımlayıcısı.
itemType

ItemType

Öğe türü.

ItemType

Listeleme

Öğenin türü. Zaman içinde ek öğe türleri eklenebilir.

Değer Description
Dashboard

PowerBI panosu.
DataPipeline

Veri işlem hattı.
Datamart

PowerBI datamart.
Environment

Bir ortam.
Eventhouse

Bir olay evi.
Eventstream

Bir olay akışı.
GraphQLApi

GraphQL öğesi için bir API.
KQLDashboard

KQL panosu.
KQLDatabase

KQL veritabanı.
KQLQueryset

KQL sorgu kümesi.
Lakehouse

Göl evi.
MLExperiment

Makine öğrenmesi denemesi.
MLModel

Makine öğrenmesi modeli.
MirroredDatabase

Yansıtılmış veritabanı.
MirroredWarehouse

Aynalı bir depo.
MountedDataFactory

Bir MountedDataFactory.
Notebook

Bir not defteri.
PaginatedReport

PowerBI sayfalandırılmış raporu.
Reflex

Bir refleks.
Report

PowerBI raporu.
SQLDatabase

A SQLDatabase.
SQLEndpoint

Bir SQL uç noktası.
SemanticModel

PowerBI anlam modeli.
SparkJobDefinition

Spark iş tanımı.
Warehouse

Bir depo.