Megosztás a következőn keresztül:

Git - Get Status

  • Referencia
Szolgáltatás:
Core
API-verzió:
v1

A munkaterület azon elemeinek Git status adja vissza, amelyek lekérhetők a Githez.
Ez az API támogatja hosszú ideig futó műveleteket (LRO).

Az állapot azt jelzi, hogy az elem(ek) módosultak az utolsó munkaterület és a távoli ág szinkronizálása óta. Ha mindkét helyet módosították, az API ütközést jelöl.

Engedélyek

A hívónak közreműködői vagy magasabb munkaterületi szerepkörrel kell rendelkeznie.

Kötelező delegált hatókörök

Workspace.GitUpdate.All vagy Workspace.GitCommit.All

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság Támogat
Felhasználó Igen
szolgáltatásnév és felügyelt identitások Nem

Interfész

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

URI-paraméterek

Name In Kötelező Típus Description
workspaceId
 path True

string

uuid

A munkaterület azonosítója.

Válaszok

Name Típus Description
200 OK

GitStatusResponse

A kérés sikeresen befejeződött.
202 Accepted

A kérelem elfogadva, állapot lekérése folyamatban.

Fejlécek

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Gyakori hibakódok:

  • WorkspaceNotConnectedToGit – A munkaterület nincs csatlakoztatva a githez.

  • WorkspaceHasNoCapacityAssigned – A munkaterület nincs kapacitásban.

  • InsufficientPrivileges – A hívó nem rendelkezik megfelelő munkaterületi engedélyekkel.

Példák

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

Get status example

Mintakérelem

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

Mintaválasz

Állapotkód:
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"
    }
  ]
}
Állapotkód:
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

Mintakérelem

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

Mintaválasz

Állapotkód:
200 
{
  "workspaceHead": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "remoteCommitHash": "eaa737b48cda41b37ffefac772ea48f6fed3eac4",
  "changes": []
}
Állapotkód:
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

Mintakérelem

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

Mintaválasz

Állapotkód:
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"
    }
  ]
}
Állapotkód:
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

Definíciók

Name Description
ChangeType

Elem módosítása. Idővel további módosított típusok is hozzáadhatók.
ConflictType

Egy elem módosítása a munkaterületen és a távoli helyen is. Idővel további módosított típusok is hozzáadhatók.
ErrorRelatedResource

A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse

A hibaválasz.
ErrorResponseDetails

A hibaválasz részletei.
GitStatusResponse

Az állapotválaszt tartalmazza.
ItemChange

Az elem változási adatait tartalmazza.
ItemIdentifier

Az elemazonosítót tartalmazza. Legalább egy tulajdonságot meg kell határozni.
ItemMetadata

Az elem metaadatait tartalmazza.
ItemType

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

ChangeType

Enumerálás

Elem módosítása. Idővel további módosított típusok is hozzáadhatók.

Érték Description
Added

Egy újonnan létrehozott elem.
Deleted

Az elem törölve lett.
Modified

Az elem tartalma módosult.

ConflictType

Enumerálás

Egy elem módosítása a munkaterületen és a távoli helyen is. Idővel további módosított típusok is hozzáadhatók.

Érték Description
Conflict

A munkaterületen és a távoli Gitben különböző változások történtek az elemen.
None

Az elem nem módosult.
SameChanges

A munkaterületen és a távoli Gitben azonos változások vannak az elemen.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name Típus Description
resourceId

string

A hibában érintett erőforrás-azonosító.
resourceType

string

A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
moreDetails

ErrorResponseDetails[]

További hibaadatok listája.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.
requestId

string

A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name Típus Description
errorCode

string

Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message

string

A hiba emberi olvasható ábrázolása.
relatedResource

ErrorRelatedResource

A hibával kapcsolatos erőforrásadatok.

GitStatusResponse

Objektum

Az állapotválaszt tartalmazza.

Name Típus Description
changes

ItemChange[]

A távoli Git azon módosításainak listája, amelyek nem vonatkoznak az adott munkaterületre, valamint a munkaterületen a távoli Gitre nem alkalmazott módosítások listája.
remoteCommitHash

string

Távoli teljes SHA véglegesítési kivonat.
workspaceHead

string

Teljes SHA-kivonat, amellyel a munkaterület szinkronizálva van.

ItemChange

Objektum

Az elem változási adatait tartalmazza.

Name Típus Description
conflictType

ConflictType

Ha a munkaterület és a távoli Git oldalon is vannak változások.
itemMetadata

ItemMetadata

Az elem metaadatai.
remoteChange

ChangeType

Váltás a távoli Git-oldalon.
workspaceChange

ChangeType

Változás a munkaterület oldalán.

ItemIdentifier

Objektum

Az elemazonosítót tartalmazza. Legalább egy tulajdonságot meg kell határozni.

Name Típus Description
logicalId

string

uuid

Az elem logikai azonosítója. Ha a logikai azonosító nem érhető el, mert az elem még nincs hozzáadva a munkaterülethez, használhatja az objektumazonosítót.
objectId

string

uuid

Az elem objektumazonosítója. Ha az objektumazonosító nem érhető el, mert az elemet törölték a munkaterületről, használhatja a logikai azonosítót.

ItemMetadata

Objektum

Az elem metaadatait tartalmazza.

Name Típus Description
displayName

string

Az elem megjelenítendő neve. A munkaterületelem megjelenítendő nevét részesíti előnyben, ha létezik, ellenkező esetben a displayName a távoli elem megjelenítendő nevét használja.
itemIdentifier

ItemIdentifier

Az elem azonosítója.
itemType

ItemType

Az elem típusa.

ItemType

Enumerálás

Az elem típusa. Idővel további elemtípusok is hozzáadhatók.

Érték Description
Dashboard

PowerBI-irányítópult.
DataPipeline

Egy adatfolyam.
Datamart

PowerBI datamart.
Environment

Egy környezet.
Eventhouse

Egy rendezvényház.
Eventstream

Eseménystream.
GraphQLApi

Api a GraphQL-elemhez.
KQLDashboard

KQL-irányítópult.
KQLDatabase

KQL-adatbázis.
KQLQueryset

KQL-lekérdezéskészlet.
Lakehouse

Egy tóház.
MLExperiment

Gépi tanulási kísérlet.
MLModel

Gépi tanulási modell.
MirroredDatabase

Tükrözött adatbázis.
MirroredWarehouse

Egy tükrözött raktár.
MountedDataFactory

A MountedDataFactory.
Notebook

Egy jegyzetfüzet.
PaginatedReport

Többoldalas PowerBI-jelentés.
Reflex

Egy reflex.
Report

PowerBI-jelentés.
SQLDatabase

A SQLDatabase.
SQLEndpoint

EGY SQL-végpont.
SemanticModel

PowerBI szemantikai modell.
SparkJobDefinition

Spark-feladat definíciója.
Warehouse

Egy raktár.